agenticros 0.0.1 → 0.1.1

package/runtime/packages/agenticros/src/tools/ros2-publish.ts

@@ -0,0 +1,52 @@
+import { Type } from "@sinclair/typebox";
+import type { OpenClawPluginApi } from "../plugin-api.js";
+import type { AgenticROSConfig } from "@agenticros/core";
+import { toNamespacedTopic, applyCmdVelTwistSignConvention } from "@agenticros/core";
+import { getTransport } from "../service.js";
+
+/**
+ * Register the ros2_publish tool with the AI agent.
+ * Allows publishing messages to any ROS2 topic.
+ */
+export function registerPublishTool(api: OpenClawPluginApi, config: AgenticROSConfig): void {
+  api.registerTool({
+    name: "ros2_publish",
+    label: "ROS2 Publish",
+    description:
+      "Publish a message to a ROS2 topic. Use this to send commands to the robot " +
+      "(e.g., velocity commands to /cmd_vel, navigation goals, etc.).",
+    parameters: Type.Object({
+      topic: Type.String({ description: "The ROS2 topic name (e.g., '/cmd_vel')" }),
+      type: Type.String({ description: "The ROS2 message type (e.g., 'geometry_msgs/msg/Twist')" }),
+      message: Type.Record(Type.String(), Type.Unknown(), {
+        description: "The message payload matching the ROS2 message type schema",
+      }),
+    }),
+
+    async execute(_toolCallId, params) {
+      const rawTopic = params["topic"] as string;
+      const topic = toNamespacedTopic(config, rawTopic);
+      const type = params["type"] as string;
+      let message = params["message"] as Record<string, unknown>;
+      message = applyCmdVelTwistSignConvention(topic, type, message);
+
+      const transport = getTransport();
+      transport.publish({ topic, type, msg: message });
+
+      const ns = (config.robot?.namespace ?? "").trim();
+      const namespaceApplied = ns && topic.startsWith(`/${ns}/`);
+      let summary = namespaceApplied
+        ? `Published to ${topic} (robot.namespace="${ns}" applied).`
+        : `Published to ${topic}.`;
+      if (!ns && (rawTopic === "/cmd_vel" || rawTopic.trim().replace(/^\/+/, "") === "cmd_vel")) {
+        summary += " If the robot did not move, set robot.namespace in plugin config to the robot's cmd_vel prefix (e.g. robot3946b404c33e4aa39a8d16deb1c5c593), then restart the gateway.";
+      }
+
+      const result = { success: true, topic, type, summary };
+      return {
+        content: [{ type: "text", text: summary + "\n" + JSON.stringify({ success: true, topic, type }) }],
+        details: result,
+      };
+    },
+  });
+}

package/runtime/packages/agenticros/src/tools/ros2-service.ts

@@ -0,0 +1,46 @@
+import { Type } from "@sinclair/typebox";
+import type { OpenClawPluginApi } from "../plugin-api.js";
+import type { AgenticROSConfig } from "@agenticros/core";
+import { toNamespacedTopic } from "@agenticros/core";
+import { getTransport } from "../service.js";
+
+/**
+ * Register the ros2_service_call tool with the AI agent.
+ * Allows calling any ROS2 service.
+ */
+export function registerServiceTool(api: OpenClawPluginApi, config: AgenticROSConfig): void {
+  api.registerTool({
+    name: "ros2_service_call",
+    label: "ROS2 Service Call",
+    description:
+      "Call a ROS2 service and return the response. Use this for request/response operations " +
+      "like setting parameters, triggering behaviors, or querying node state.",
+    parameters: Type.Object({
+      service: Type.String({ description: "The ROS2 service name (e.g., '/spawn_entity')" }),
+      type: Type.Optional(Type.String({ description: "The ROS2 service type (e.g., 'gazebo_msgs/srv/SpawnEntity')" })),
+      args: Type.Optional(Type.Record(Type.String(), Type.Unknown(), {
+        description: "The service request arguments",
+      })),
+    }),
+
+    async execute(_toolCallId, params) {
+      const rawService = params["service"] as string;
+      const service = toNamespacedTopic(config, rawService);
+      const type = params["type"] as string | undefined;
+      const args = params["args"] as Record<string, unknown> | undefined;
+
+      const transport = getTransport();
+      const response = await transport.callService({ service, type, args });
+
+      const result = {
+        success: response.result,
+        service,
+        response: response.values,
+      };
+      return {
+        content: [{ type: "text", text: JSON.stringify(result) }],
+        details: result,
+      };
+    },
+  });
+}

package/runtime/packages/agenticros/src/tools/ros2-subscribe.ts

@@ -0,0 +1,71 @@
+import { Type } from "@sinclair/typebox";
+import type { OpenClawPluginApi } from "../plugin-api.js";
+import type { AgenticROSConfig } from "@agenticros/core";
+import { toNamespacedTopic } from "@agenticros/core";
+import { getTransport } from "../service.js";
+
+/**
+ * Register the ros2_subscribe_once tool with the AI agent.
+ * Subscribes to a topic and returns the next message received.
+ */
+export function registerSubscribeTool(api: OpenClawPluginApi, config: AgenticROSConfig): void {
+  api.registerTool({
+    name: "ros2_subscribe_once",
+    label: "ROS2 Subscribe Once",
+    description:
+      "Subscribe to a ROS2 topic and return the next message. Use this to read sensor data, " +
+      "check robot state, or get the current value of a topic.",
+    parameters: Type.Object({
+      topic: Type.String({ description: "The ROS2 topic name (e.g., '/battery_state')" }),
+      type: Type.Optional(Type.String({ description: "The ROS2 message type (e.g., 'sensor_msgs/msg/BatteryState')" })),
+      timeout: Type.Optional(Type.Number({ description: "Timeout in milliseconds (default: 5000)" })),
+    }),
+
+    async execute(_toolCallId, params) {
+      const rawTopic = params["topic"] as string;
+      const topic = toNamespacedTopic(config, rawTopic);
+      let msgType = params["type"] as string | undefined;
+      const timeout = (params["timeout"] as number | undefined) ?? 5000;
+
+      if (!msgType && /\/?(camera|image|color|depth)/i.test(rawTopic)) {
+        msgType = rawTopic.includes("compressed") ? "sensor_msgs/msg/CompressedImage" : "sensor_msgs/msg/Image";
+      }
+
+      const transport = getTransport();
+
+      const result = await new Promise<Record<string, unknown>>((resolve, reject) => {
+        const subscription = transport.subscribe(
+          { topic, type: msgType },
+          (msg: Record<string, unknown>) => {
+            clearTimeout(timer);
+            subscription.unsubscribe();
+            resolve({ success: true, topic, message: msg });
+          },
+        );
+        const timer = setTimeout(() => {
+          subscription.unsubscribe();
+          reject(new Error(`Timeout waiting for message on ${topic}`));
+        }, timeout);
+      });
+
+      // Avoid sending huge payloads (e.g. image/point cloud) as text — burns tokens and triggers rate limits
+      const MAX_TEXT_CHARS = 8000;
+      let text = JSON.stringify(result);
+      if (text.length > MAX_TEXT_CHARS) {
+        text =
+          JSON.stringify({
+            success: true,
+            topic,
+            message: "[truncated: message too large for model context]",
+            originalSize: text.length,
+          }) +
+          "\n(Use ros2_camera_snapshot for image topics.)";
+      }
+
+      return {
+        content: [{ type: "text", text }],
+        details: result,
+      };
+    },
+  });
+}

package/runtime/packages/agenticros/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/runtime/packages/agenticros-claude-code/README.md

@@ -0,0 +1,260 @@
+# AgenticROS Claude Code adapter
+
+MCP (Model Context Protocol) server that exposes AgenticROS ROS2 tools to **Claude Code CLI** and to the **Claude desktop app** on macOS (including **Claude Dispatch** on iPhone when paired to Claude on your Mac). Use natural language to control and query your ROS2 robot (e.g. "what do you see?", "move 1m forward").
+
+This adapter does **not** provide the config or teleop web UI; use the [OpenClaw plugin](../../packages/agenticros) for that, or run the gateway for the browser-based teleop page.
+
+## Prerequisites
+
+- Node.js 20+
+- ROS2 transport available (Zenoh router, rosbridge, or local DDS)
+- **Claude Code CLI** and/or **Claude desktop app** (MCP-enabled)
+
+## Config
+
+The server reads AgenticROS config from (in order):
+
+1. **`AGENTICROS_CONFIG_PATH`** — path to a JSON file
+2. **`~/.agenticros/config.json`**
+3. **OpenClaw config** — if the above are missing, it tries `OPENCLAW_CONFIG` or `~/.openclaw/openclaw.json` and uses `plugins.entries.agenticros.config`
+
+Config shape is the same as the OpenClaw plugin (transport mode, Zenoh endpoint, robot namespace, camera topic, etc.). Example:
+
+```json
+{
+  "transport": { "mode": "zenoh" },
+  "zenoh": { "routerEndpoint": "ws://localhost:10000" },
+  "robot": {
+    "name": "MyRobot",
+    "namespace": "",
+    "cameraTopic": "/camera/camera/color/image_raw/compressed"
+  }
+}
+```
+
+**Where to put `robot.namespace`:** Put `robot.namespace`, `zenoh.routerEndpoint`, etc. in **`~/.agenticros/config.json`**, or set **`AGENTICROS_CONFIG_PATH`** to the path of your JSON file. To override namespace only for a given MCP launch (e.g. desktop app vs another project), set env **`AGENTICROS_ROBOT_NAMESPACE`** on the MCP server entry — it overrides `robot.namespace` after the JSON is loaded. The value must match the robot’s ROS namespace exactly (many robots use **no hyphens** in the UUID part of `/robot<uuid>/cmd_vel`).
+
+The MCP server does **not** read arbitrary keys from `.mcp.json` except **`env`** passed to the process; AgenticROS settings still come from `~/.agenticros/config.json` (or `AGENTICROS_CONFIG_PATH` / OpenClaw fallback) plus optional **`AGENTICROS_ROBOT_NAMESPACE`** in `env`.
+
+**Zenoh:** The MCP server connects to the URL in `zenoh.routerEndpoint` (e.g. `ws://localhost:10000`). That must be the machine where **this** process runs: either start a Zenoh router on your Mac (`zenohd --listen tcp/0.0.0.0:7447 --listen ws/0.0.0.0:10000`) or, if the router runs on another host (e.g. the robot), set `routerEndpoint` to that host (e.g. `ws://192.168.1.5:10000`). If nothing is listening on that host:port, you will see "Remote api request timeout".
+
+## Build
+
+From the repo root:
+
+```bash
+pnpm install
+pnpm build
+```
+
+Or build only core and this package: `pnpm --filter @agenticros/core build && pnpm --filter @agenticros/claude-code build`.
+
+## Register with Claude Code
+
+Add the MCP server so Claude Code can use the tools.
+
+**Option A — Project `.mcp.json` (recommended when working in the repo)**  
+From the repo root, create or edit `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "agenticros": {
+      "type": "stdio",
+      "command": "sh",
+      "args": ["-c", "node packages/agenticros-claude-code/dist/index.js 2>>/tmp/agenticros-mcp.log"],
+      "env": {}
+    }
+  }
+}
+```
+
+Then run `claude` from the **repo root** so the path `packages/agenticros-claude-code/dist/index.js` resolves. To capture logs: `tail -f /tmp/agenticros-mcp.log` or `grep AgenticROS /tmp/agenticros-mcp.log`.
+
+**Option B — `claude mcp add`**  
+From the repo root after building:
+
+```bash
+claude mcp add --transport stdio --scope project agenticros -- node packages/agenticros-claude-code/dist/index.js
+```
+
+Or user scope (stored in `~/.claude.json`):
+
+```bash
+claude mcp add --transport stdio --scope user agenticros -- node "$(pwd)/packages/agenticros-claude-code/dist/index.js"
+```
+
+**Stale MCP processes**  
+Claude Code may start a new MCP process per session without stopping old ones. If tool behavior is outdated after a rebuild, kill existing servers then start Claude again:
+
+```bash
+pnpm mcp:kill
+claude
+```
+
+Scope options: `--scope user` (default), `--scope project` (shared via `.mcp.json`).
+
+## Claude desktop app + Claude Dispatch (iOS)
+
+The Claude **desktop** app uses a different MCP config file than Claude Code:
+
+| Platform | MCP config file |
+|----------|-----------------|
+| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
+
+1. Add an **`agenticros`** entry under **`mcpServers`** with the same shape as in `.mcp.json`, but use an **absolute path** to the built server:
+
+   ```json
+   {
+     "mcpServers": {
+       "agenticros": {
+         "command": "sh",
+         "args": [
+           "-c",
+           "node /ABSOLUTE/PATH/TO/agenticros/packages/agenticros-claude-code/dist/index.js 2>>/tmp/agenticros-mcp.log"
+         ],
+         "env": {
+           "AGENTICROS_ROBOT_NAMESPACE": "robot3946b404c33e4aa39a8d16deb1c5c593"
+         }
+       }
+     }
+   }
+   ```
+
+   Replace the `node` path with your clone’s path. Relative paths like `packages/agenticros-claude-code/dist/index.js` usually **fail** from the desktop app because its working directory is not the repo root.
+
+2. **Fully quit** Claude (Cmd+Q on macOS) and restart — not just closing the window.
+
+3. **Claude Dispatch** on iPhone: when paired to Claude on your Mac, the same MCP tools available in the desktop app (including **agenticros**) can be used from Dispatch, subject to Claude app permissions and tool approval.
+
+## Tools
+
+The server exposes the same ROS2 tools as the OpenClaw plugin:
+
+| Tool | Description |
+|------|-------------|
+| `ros2_list_topics` | List topics and types |
+| `ros2_publish` | Publish to a topic (e.g. cmd_vel) |
+| `ros2_subscribe_once` | Get next message from a topic |
+| `ros2_service_call` | Call a ROS2 service |
+| `ros2_action_goal` | Send goal to an action server |
+| `ros2_param_get` / `ros2_param_set` | Get/set node parameters |
+| `ros2_camera_snapshot` | "What do you see" — one frame from camera topic |
+| `ros2_depth_distance` | Distance in meters from depth camera |
+| `memory_remember` *(when enabled)* | Store a durable fact for the robot — shared with OpenClaw, Claude Desktop, Gemini |
+| `memory_recall` *(when enabled)* | Semantic search across long-term memory |
+| `memory_forget` *(when enabled)* | Delete by id, query, or whole namespace |
+| `memory_status` *(when enabled)* | Health check + record count + embedder info |
+
+Safety limits (max linear/angular velocity) from config are applied before `ros2_publish`.
+
+### Optional: shared memory across agents
+
+The four `memory_*` tools only show up in `tools/list` when memory is **enabled** in `~/.agenticros/config.json`. Once enabled, anything you remember from Claude Code (or Claude Desktop) is immediately recall-able from OpenClaw chat and the Gemini CLI for the same robot — the underlying store lives at `~/.mem0/vector_store.db` and is shared across processes. Memory tools work even when zenohd is not running (they never touch the ROS transport). See [`docs/memory.md`](../../docs/memory.md) at the repo root for setup recipes and troubleshooting.
+
+### “You’re denying the tool call” / robot doesn’t move
+
+Claude Code asks for **approval** before running tools that can change state (e.g. `ros2_publish`). When it says “I’ll publish to …”, you must choose **Allow** or **Approve** (not Deny). If you deny, the command never runs and the robot won’t move.
+
+To **auto-allow** AgenticROS tools so you aren’t prompted every time, add a permission rule. In **project** settings (e.g. `.claude/settings.json` in the repo) or **user** settings (`~/.claude/settings.json`):
+
+```json
+{
+  "permissions": {
+    "allow": ["mcp__agenticros"]
+  }
+}
+```
+
+That allows all tools from the `agenticros` MCP server. To allow only `ros2_publish`: `"allow": ["mcp__agenticros__ros2_publish"]`. Use `/permissions` in Claude Code to view and edit rules.
+
+### WebSocket error / "disconnected from remote-api-plugin: 1006" in log
+
+The MCP server talks to Zenoh over **WebSocket** (e.g. `ws://localhost:10000`). If you see `WebSocket error` and `WebSocket has been disconnected from remote-api-plugin: 1006` in `/tmp/agenticros-mcp.log`, the connection to zenohd is failing or dropping. The transport never stays connected, so no messages are sent.
+
+**Do this:**
+
+1. **Start zenohd with the remote-api plugin** (so it listens on port 10000):
+   ```bash
+   cd /path/to/agenticros
+   zenohd -c scripts/zenohd-agenticros.json5
+   ```
+   Leave it running in the foreground so you can see any errors when the MCP server connects.
+
+2. **Check that port 10000 is in use:**  
+   `lsof -i :10000`  
+   You should see `zenohd` (or the process that runs the plugin). If nothing is listening, the plugin did not load — install `zenoh-plugin-remote-api` (e.g. `brew install zenoh-plugin-remote-api` with the eclipse-zenoh tap) and ensure the config’s `plugins_loading.search_dirs` includes the directory that has `libzenoh_plugin_remote_api.*`.
+
+3. **Version match:**  
+   zenoh-ts (npm) and zenoh-plugin-remote-api (zenohd) should be compatible. Check `zenohd --version` and `@eclipse-zenoh/zenoh-ts` version in `packages/core/package.json`; if one is much newer, try aligning versions (see [docs/zenoh-agenticros.md](../../docs/zenoh-agenticros.md)).
+
+4. **Restart order:**  
+   Start zenohd first, confirm port 10000, then start (or restart) Claude Code so the MCP server connects to an already-running router.
+
+### No messages reaching the robot (publish seems to do nothing)
+
+1. **Await publish** — The tool now waits for the Zenoh put to complete before returning. If the put fails, you’ll see an error in the tool result (e.g. "Zenoh put failed: …"). Rebuild and restart Claude Code after pulling this change.
+2. **Check MCP server logs** — Server logs go to stderr. To capture: in `.mcp.json` use `"command": "sh", "args": ["-c", "node packages/agenticros-claude-code/dist/index.js 2>>/tmp/agenticros-mcp.log"]`. Then `cat /tmp/agenticros-mcp.log` after a move to see publish lines and errors.
+ When you trigger a move, the first terminal should show `[AgenticROS] Zenoh publish: key=...` for each publish. If you see that but the robot still doesn’t move, the issue is downstream (bridge allow list, robot topic, or network).
+3. **Confirm key/topic** — The server publishes to the Zenoh key derived from the topic (e.g. `3946b404-c33e-4aa3-9a8d-16deb1c5c593/cmd_vel` for topic `/3946b404-c33e-4aa3-9a8d-16deb1c5c593/cmd_vel`). Your zenoh-bridge-ros2dds `subscribers` allow list must match that key (e.g. `.+/cmd_vel` or the exact key).
+
+**z_sub shows "invalid utf-8"?** We publish binary CDR; z_sub is trying to display it as text. The payload is correct. If z_sub shows `Received PUT (.../cmd_vel: ...)`, the MCP server and zenohd are fine; if the robot still does not move, the issue is the **bridge or the ROS2 topic on the robot** — see [docs/robot-not-receiving-cmd-vel.md](../../docs/robot-not-receiving-cmd-vel.md).
+
+### Robot not moving (cmd_vel not received)
+
+If `ros2_publish` runs but the robot doesn’t move:
+
+1. **Topic the base subscribes to**  
+   On the robot run: `ros2 topic list` and `ros2 topic info /cmd_vel`. If the base subscribes to **`/cmd_vel`** (no prefix), set **`robot.namespace`** to `""` in `~/.agenticros/config.json` so we publish to `/cmd_vel`. If it subscribes to **`/<uuid>/cmd_vel`**, set `robot.namespace` to that `<uuid>` (e.g. `3946b404-c33e-4aa3-9a8d-16deb1c5c593`).
+
+2. **Bridge allow list**  
+   zenoh-bridge-ros2dds on the robot must **subscribe** to the Zenoh key we publish. For ros2dds the key is the topic without the leading slash (e.g. `cmd_vel` or `3946b404-c33e-4aa3-9a8d-16deb1c5c593/cmd_vel`). In the bridge config `plugins.ros2dds.allow.subscribers`, include a pattern that matches that key (e.g. `cmd_vel`, `*\/cmd_vel`, or `.+/cmd_vel` depending on the bridge’s syntax). Restart the bridge after changing the config.
+
+3. **Confirm on the Mac**  
+   Subscribe to cmd_vel on the Zenoh router. If you have the Zenoh repo built (e.g. `~/Projects/zenoh`):  
+   `cargo run -p zenoh-examples --example z_sub -- -e tcp/127.0.0.1:7447 --no-multicast-scouting -k '**/cmd_vel'`  
+   Or if `z_sub` is in your PATH (e.g. from a Zenoh tools package):  
+   `z_sub -e tcp/127.0.0.1:7447 --no-multicast-scouting -k '**/cmd_vel'`  
+   Then in Claude Code ask to move the robot. If you see Twist messages in the subscriber, the MCP server and zenohd are fine and the issue is the bridge or the robot’s ROS2 topic.
+
+## Testing the plugin
+
+1. **Build** (from repo root):
+   ```bash
+   pnpm install && pnpm --filter @agenticros/core build && pnpm --filter @agenticros/claude-code build
+   ```
+
+2. **Config** (so the MCP server can connect to ROS2): create `~/.agenticros/config.json` or set `AGENTICROS_CONFIG_PATH`. You can copy from this package:
+   ```bash
+   mkdir -p ~/.agenticros
+   cp packages/agenticros-claude-code/config.example.json ~/.agenticros/config.json
+   ```
+   Edit the file if needed (e.g. `zenoh.routerEndpoint`, `robot.cameraTopic`, or `transport.mode` to `rosbridge` / `local`).
+
+3. **Register the MCP server** with Claude Code (use project scope so it’s stored in `.mcp.json`):
+   ```bash
+   cd /path/to/agenticros
+   claude mcp add --transport stdio --scope project agenticros -- node packages/agenticros-claude-code/dist/index.js
+   ```
+   Or user scope (stored in `~/.claude.json`):
+   ```bash
+   claude mcp add --transport stdio --scope user agenticros -- node "$(pwd)/packages/agenticros-claude-code/dist/index.js"
+   ```
+
+4. **Verify**:
+   ```bash
+   claude mcp list
+   claude mcp get agenticros
+   ```
+
+5. **Use Claude Code**: run `claude` and ask it to use the tools, e.g.:
+   - “List ROS2 topics using the agenticros tools.”
+   - “What do I see from the robot’s camera?” (if `robot.cameraTopic` is set and a camera is publishing).
+   - “Publish a stop to cmd_vel.” (if you have a robot with `cmd_vel`).
+
+   In the chat you can type `/mcp` to see MCP server status. If the transport isn’t running (e.g. no Zenoh router), tool calls will fail with connection errors until the ROS2 side is up.
+
+## "Follow me" and skills
+
+The OpenClaw plugin can load skills (e.g. **follow me** via `agenticros-skill-followme`). This MCP adapter does not load skills in v1; only the core tools above are available. For "follow me", use the OpenClaw plugin or a future version of this adapter that adds skill loading or a dedicated `follow_robot` tool.

package/runtime/packages/agenticros-claude-code/config.example.json

@@ -0,0 +1,9 @@
+{
+  "transport": { "mode": "zenoh" },
+  "zenoh": { "routerEndpoint": "ws://localhost:10000" },
+  "robot": {
+    "name": "MyRobot",
+    "namespace": "",
+    "cameraTopic": "/camera/camera/color/image_raw/compressed"
+  }
+}

package/runtime/packages/agenticros-claude-code/dist/config.d.ts

@@ -0,0 +1,8 @@
+import type { AgenticROSConfig } from "@agenticros/core";
+/**
+ * Load and parse AgenticROS config.
+ * 1) AGENTICROS_CONFIG_PATH or ~/.agenticros/config.json (full JSON object = config).
+ * 2) If that file does not exist, try OpenClaw config and read plugins.entries.agenticros.config.
+ */
+export declare function loadConfig(): AgenticROSConfig;
+//# sourceMappingURL=config.d.ts.map

package/runtime/packages/agenticros-claude-code/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AA4DzD;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,gBAAgB,CA2B7C"}

package/runtime/packages/agenticros-claude-code/dist/config.js

@@ -0,0 +1,93 @@
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { parseConfig } from "@agenticros/core";
+/**
+ * Optional MCP / process env override: set `robot.namespace` without editing JSON.
+ * Useful in `claude_desktop_config.json` or `.mcp.json` under `env`.
+ * Must match the robot’s ROS namespace exactly (often no dashes in the UUID segment).
+ */
+function applyMcpEnvOverrides(config) {
+    const ns = process.env.AGENTICROS_ROBOT_NAMESPACE?.trim();
+    if (!ns)
+        return config;
+    return {
+        ...config,
+        robot: {
+            ...config.robot,
+            namespace: ns,
+        },
+    };
+}
+/**
+ * Resolve path to AgenticROS config file.
+ * Prefer AGENTICROS_CONFIG_PATH; else ~/.agenticros/config.json.
+ * Optional: fallback to OpenClaw config and read plugins.entries.agenticros.config.
+ */
+function getConfigPath() {
+    const env = process.env.AGENTICROS_CONFIG_PATH;
+    if (env && env.trim().length > 0) {
+        return path.resolve(env);
+    }
+    return path.join(os.homedir(), ".agenticros", "config.json");
+}
+/**
+ * Try to read config from OpenClaw file (plugins.entries.agenticros.config).
+ */
+function tryOpenClawConfig() {
+    const openclawEnv = process.env.OPENCLAW_CONFIG;
+    const openclawPath = openclawEnv && openclawEnv.trim().length > 0
+        ? path.resolve(openclawEnv)
+        : path.join(os.homedir(), ".openclaw", "openclaw.json");
+    try {
+        const raw = fs.readFileSync(openclawPath, "utf8");
+        const parsed = JSON.parse(raw);
+        const entries = parsed?.plugins && typeof parsed.plugins.entries === "object"
+            ? parsed.plugins.entries
+            : null;
+        const agenticros = entries?.agenticros && typeof entries.agenticros === "object"
+            ? entries.agenticros
+            : null;
+        const config = agenticros?.config;
+        if (config !== null && typeof config === "object") {
+            return config;
+        }
+    }
+    catch {
+        // ignore
+    }
+    return null;
+}
+/**
+ * Load and parse AgenticROS config.
+ * 1) AGENTICROS_CONFIG_PATH or ~/.agenticros/config.json (full JSON object = config).
+ * 2) If that file does not exist, try OpenClaw config and read plugins.entries.agenticros.config.
+ */
+export function loadConfig() {
+    const primaryPath = getConfigPath();
+    try {
+        const raw = fs.readFileSync(primaryPath, "utf8");
+        const parsed = JSON.parse(raw);
+        if (parsed !== null && typeof parsed === "object") {
+            const cfg = parseConfig(parsed);
+            if (process.stderr && typeof process.stderr.write === "function") {
+                process.stderr.write(`[AgenticROS] Config from ${primaryPath}\n`);
+            }
+            return applyMcpEnvOverrides(cfg);
+        }
+    }
+    catch (err) {
+        const nodeErr = err;
+        if (nodeErr.code === "ENOENT") {
+            const openclawConfig = tryOpenClawConfig();
+            if (openclawConfig) {
+                return applyMcpEnvOverrides(parseConfig(openclawConfig));
+            }
+            throw new Error(`AgenticROS config not found at ${primaryPath}. Create it or set AGENTICROS_CONFIG_PATH. ` +
+                "See README for an example config.");
+        }
+        throw err;
+    }
+    return applyMcpEnvOverrides(parseConfig({}));
+}
+//# sourceMappingURL=config.js.map

package/runtime/packages/agenticros-claude-code/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,MAAwB;IACpD,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,IAAI,EAAE,CAAC;IAC1D,IAAI,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IACvB,OAAO;QACL,GAAG,MAAM;QACT,KAAK,EAAE;YACL,GAAG,MAAM,CAAC,KAAK;YACf,SAAS,EAAE,EAAE;SACd;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa;IACpB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAC/C,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB;IACxB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAChD,MAAM,YAAY,GAAG,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAC/D,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QAC3B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;IAC1D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;QAC1D,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,OAAQ,MAAM,CAAC,OAAmC,CAAC,OAAO,KAAK,QAAQ;YACxG,CAAC,CAAE,MAAM,CAAC,OAAmC,CAAC,OAAkC;YAChF,CAAC,CAAC,IAAI,CAAC;QACT,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ;YAC9E,CAAC,CAAC,OAAO,CAAC,UAAqC;YAC/C,CAAC,CAAC,IAAI,CAAC;QACT,MAAM,MAAM,GAAG,UAAU,EAAE,MAAM,CAAC;QAClC,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAClD,OAAO,MAAiC,CAAC;QAC3C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,WAAW,GAAG,aAAa,EAAE,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAClD,MAAM,GAAG,GAAG,WAAW,CAAC,MAAiC,CAAC,CAAC;YAC3D,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,WAAW,IAAI,CAAC,CAAC;YACpE,CAAC;YACD,OAAO,oBAAoB,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAA4B,CAAC;QAC7C,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;YAC3C,IAAI,cAAc,EAAE,CAAC;gBACnB,OAAO,oBAAoB,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC;YAC3D,CAAC;YACD,MAAM,IAAI,KAAK,CACb,kCAAkC,WAAW,6CAA6C;gBAC1F,mCAAmC,CACpC,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,oBAAoB,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/runtime/packages/agenticros-claude-code/dist/depth.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Sample distance (meters) from a ROS2 depth image topic.
+ * Copied from OpenClaw adapter so we don't depend on the full plugin.
+ */
+import type { RosTransport } from "@agenticros/core";
+export declare function sampleDepthMeters(width: number, height: number, step: number, encoding: string, data: Uint8Array, centerFraction?: number, isBigEndian?: boolean): number[];
+export interface DepthSampleResult {
+    distance_m: number;
+    median_m: number;
+    valid: boolean;
+    topic: string;
+    encoding: string;
+    width: number;
+    height: number;
+    sample_count: number;
+    min_m: number;
+    max_m: number;
+}
+export declare function getDepthDistance(transport: RosTransport, topic: string, timeoutMs?: number): Promise<DepthSampleResult>;
+//# sourceMappingURL=depth.d.ts.map

package/runtime/packages/agenticros-claude-code/dist/depth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"depth.d.ts","sourceRoot":"","sources":["../src/depth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA2CrD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,EAChB,cAAc,SAAM,EACpB,WAAW,UAAQ,GAClB,MAAM,EAAE,CAsCV;AASD,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,MAAM,EACb,SAAS,SAAO,GACf,OAAO,CAAC,iBAAiB,CAAC,CAoD5B"}