agenticros 0.3.3 → 0.3.5

package/runtime/README.md

@@ -33,6 +33,29 @@ With AgenticROS, your robot can describe what it sees, follow intent ("go check
 
 AgenticROS is built so that new adapters (LangGraph, OpenAI, local models, voice stacks, etc.) can be added without touching the ROS 2 layer. The core transport and tool contract are platform-agnostic; adapters are thin shims that surface those tools to each agent runtime.
 
+## Local VLM (Ollama) — no cloud API required
+
+Control your robot with a **local vision-language model** instead of OpenAI or other cloud APIs. AgenticROS robot tools work the same; you point **OpenClaw** or **Hermes** at Ollama on your machine.
+
+```bash
+ollama pull qwen3-vl:8b-instruct   # recommended: chat + tools + camera vision
+# or: ollama pull qwen3-vl:2b     # smaller hardware
+
+npx agenticros init               # skip the OpenAI key step when prompted
+# Configure OpenClaw to use Ollama as primary model (see guide below)
+agenticros up sim-amr             # or: agenticros up real
+```
+
+Then chat in OpenClaw web UI or Hermes: *"List ROS topics"*, *"drive forward slowly"*, *"what do you see?"*
+
+| Path | Best for |
+|------|----------|
+| **OpenClaw + Ollama** | Web chat, teleop, messaging channels, skills |
+| **Hermes + Ollama** | Terminal agent with any Ollama model |
+| **NemoClaw + Ollama** | Sandboxed Jetson / edge (see [docs/nemoclaw.md](docs/nemoclaw.md)) |
+
+**Full setup, model picks, multimodal catalog patches, describer, Follow Me VLM, and troubleshooting:** **[docs/local-vlm.md](docs/local-vlm.md)**
+
 ## Architecture
 
 ![AgenticROS architecture: agent platforms → adapter packages → shared TypeScript runtime → transports → ROS 2 workspace and robot](docs/images/agenticros-architecture.png)
@@ -103,6 +126,8 @@ On the ROS side, every robot publishes a 1 Hz heartbeat on `<ns>/agenticros/robo
 
 `mission_cancel({ mission_id })` flips an in-process cancellation token; the runner stops at the next step boundary and marks remaining steps `cancelled`. When the [shared memory backend](#memory-optional) is on, every step is also written to `mission:<id>` in long-term memory, tagged with `step:<status>` and `capability:<id>`. A different agent — different process, different vendor — can `memory_recall` later and reconstruct exactly what happened, so two agents can collaborate on or hand off a mission.
 
+**How-to:** step-by-step fleet setup, declarative plans, NL goals, cancel, and handoff — **[docs/missions.md](docs/missions.md)**. Runnable walkthrough: **[examples/find-and-approach/README.md](examples/find-and-approach/README.md)**.
+
 Full architecture + design trade-offs: **[docs/strategy-ai-agents-plus-ros.md](docs/strategy-ai-agents-plus-ros.md)**.
 
 ## Repository layout
@@ -112,7 +137,7 @@ Full architecture + design trade-offs: **[docs/strategy-ai-agents-plus-ros.md](d
 - `**packages/agenticros-claude-code**` — MCP server for Claude Code + Claude desktop / Dispatch (tools only; no config UI).
 - `**packages/agenticros-gemini**` — Gemini CLI (function calling; no MCP).
 - `**ros2_ws/**` — ROS2 workspace: `agenticros_msgs`, `agenticros_bringup` (Gazebo + RViz + rosbridge launches), `agenticros_discovery`, `agenticros_agent`, `agenticros_follow_me`.
-- `**docs/**` — Architecture, skills, robot setup, Zenoh, teleop.
+- `**docs/**` — Architecture, skills, robot setup, Zenoh, teleop, **[local VLM / Ollama](docs/local-vlm.md)**.
 - `**scripts/**` — Workspace setup, gateway plugin config, run demos.
 - `**docker/**` — Docker Compose and Dockerfiles for ROS2 + plugin images.
 - `**examples/**` — Example projects.
@@ -138,7 +163,7 @@ The first run launches the interactive menu:
 ? What would you like to do?
   Launch with real robot
 ❯ Launch with simulation
-  First-time setup (workspace + OpenClaw plugin + Codex MCP + API key)
+  First-time setup (workspace + OpenClaw plugin + Codex MCP + optional API key)
   Manage skills (2 registered, 0 available, 0 broken)
   Stop everything
   Doctor (health check)
@@ -146,8 +171,8 @@ The first run launches the interactive menu:
   Tail logs
 ```
 
-Pick **First-time setup** once (workspace + OpenClaw plugin + optional Codex MCP + API key, all
-idempotent), then choose how you want to run:
+Pick **First-time setup** once (workspace + OpenClaw plugin + optional Codex MCP + optional API key, all
+idempotent). **Using local Ollama instead of OpenAI?** Skip the API key step — see **[Local VLM (Ollama)](#local-vlm-ollama--no-cloud-api-required)**. Then choose how you want to run:
 
 | You want to … | Pick |
 |---|---|
@@ -163,7 +188,7 @@ so **Stop everything** cleanly tears the demo down.
 Prefer scripted invocations? Every menu item maps to a direct command:
 
 ```bash
-npx agenticros init             # one-time workspace + plugin + Codex/Hermes MCP + API key
+npx agenticros init             # one-time workspace + plugin + Codex/Hermes MCP (+ optional API key)
 agenticros codex setup          # register AgenticROS MCP for OpenAI Codex CLI
 agenticros codex doctor         # validate ~/.codex/config.toml
 agenticros hermes setup         # register AgenticROS MCP for Hermes Agent
@@ -212,7 +237,7 @@ needing token auth: run `node scripts/agenticros-proxy.cjs 18790` and open
 See **[docs/openclaw-releases-and-plugin-routes.md](docs/openclaw-releases-and-plugin-routes.md)**
 and **[docs/teleop.md](docs/teleop.md)**.
 
-See **`docs/`** for robot setup, skills, teleop, simulation internals, and Docker.
+See **`docs/`** for robot setup, **[missions](docs/missions.md)**, skills, teleop, simulation internals, and Docker.
 
 ## RViz2 and Gazebo (TurtleBot3 + rosbridge)
 

package/runtime/docs/cli.md

@@ -64,10 +64,9 @@ skipped (with a checkmark) when already done:
 3. ROS 2 workspace build (`colcon build --symlink-install`)
 4. OpenClaw plugin install (via `scripts/setup_gateway_plugin.sh`)
 5. Robot config (writes `~/.agenticros/config.json`)
-6. OpenAI API key (paste once → `scripts/configure_agenticros.sh`)
-7. Codex MCP config (optional — `agenticros codex setup` for `~/.codex/config.toml` and project `.codex/config.toml`)
-8. Hermes MCP config (optional — `agenticros hermes setup` for `~/.hermes/config.yaml`)
-9. Final `agenticros doctor` summary
+6. OpenAI API key (optional — skip when using local Ollama; see [local-vlm.md](local-vlm.md))
+7. MCP client config (optional — `agenticros mcp setup` for Codex, Hermes, and Claude)
+8. Final `agenticros doctor` summary
 
 Pass `--force` to re-run every step regardless of state.
 
@@ -85,9 +84,31 @@ same report as a structured object for CI / scripting:
 
 Exits non-zero if any check is red.
 
-Checks include MCP server build status, OpenClaw plugin health, **Codex MCP config**
-(`~/.codex/config.toml` path and namespace policy), **Hermes MCP config**
-(`~/.hermes/config.yaml`), and Codex / Hermes CLI presence on `PATH`.
+Checks include MCP server build status, OpenClaw plugin health, **MCP client configs**
+(Codex, Hermes, Claude — path and namespace policy), and CLI presence on `PATH`.
+
+### `agenticros mcp setup [--codex] [--hermes] [--claude] [--project] [--desktop]`
+
+**Primary command** — register the AgenticROS MCP server for all MCP clients at once:
+
+| Flag | Effect |
+|---|---|
+| (default) | Codex (`~/.codex/config.toml` + project `.codex/config.toml`), Hermes (`~/.hermes/config.yaml`), Claude Desktop + project `.mcp.json` |
+| `--codex` | Codex global config only |
+| `--hermes` | Hermes global config only |
+| `--claude` | Claude Desktop + project `.mcp.json` |
+| `--project` | Also write project-scoped Codex / Claude configs |
+| `--desktop` | With `--claude`, Claude Desktop config only |
+
+Uses an **absolute path** to the MCP server binary. Sets `AGENTICROS_ROBOT_NAMESPACE` empty so `agenticros mode real|sim` drives the active robot namespace.
+
+Also offered as an optional step during `agenticros init`.
+
+See **[docs/mcp-setup.md](mcp-setup.md)** for the unified onboarding guide.
+
+### `agenticros mcp doctor [--json] [--codex] [--hermes] [--claude]`
+
+Validate MCP configuration for Codex, Hermes, and Claude. Exits non-zero on red checks.
 
 ### `agenticros codex setup [--project]`
 
@@ -122,6 +143,22 @@ Validate Hermes MCP configuration: `~/.hermes/config.yaml`, MCP binary path, and
 
 See **[docs/hermes-setup.md](hermes-setup.md)** for the full Hermes onboarding guide.
 
+### `agenticros claude setup [--desktop] [--project]`
+
+Register the AgenticROS MCP server for **Claude Code** and **Claude Desktop**:
+
+| Flag | Effect |
+|---|---|
+| (default) | Claude Desktop config + project `.mcp.json` (when in a repo) |
+| `--desktop` | `claude_desktop_config.json` only |
+| `--project` | `.mcp.json` in repo root only |
+
+Alias for `agenticros mcp setup --claude`. Restart Claude Desktop fully after desktop config changes.
+
+### `agenticros claude doctor [--json]`
+
+Validate Claude MCP configuration (desktop + project `.mcp.json`). Exits non-zero on red checks.
+
 ### `agenticros status [--json]`
 
 Shows running components (camera / sim / mcp / rosbridge / openclaw-gateway)
@@ -150,9 +187,11 @@ Read or edit `~/.agenticros/config.json`. Actions:
 |---|---|---|
 | `~/.agenticros/config.json` | User | AgenticROS runtime config (transport mode, namespace, safety limits). |
 | `~/.agenticros/cli-state.json` | CLI | Last-used mode/namespace for the menu's "(yesterday)" hint. |
-| `~/.hermes/config.yaml` | Hermes Agent | MCP server registrations (written by `agenticros hermes setup`). |
-| `~/.codex/config.toml` | Codex CLI | MCP server registrations (written by `agenticros codex setup`). |
-| `.codex/config.toml` | Codex CLI | Project-scoped MCP config (written by `agenticros codex setup --project`). |
+| `~/.hermes/config.yaml` | Hermes Agent | MCP server registrations (written by `agenticros mcp setup` or `agenticros hermes setup`). |
+| `~/.codex/config.toml` | Codex CLI | MCP server registrations (written by `agenticros mcp setup` or `agenticros codex setup`). |
+| `.codex/config.toml` | Codex CLI | Project-scoped MCP config (written by `agenticros mcp setup` or `agenticros codex setup --project`). |
+| `.mcp.json` | Claude Code | Project-scoped MCP config (written by `agenticros mcp setup` or `agenticros claude setup`). |
+| `~/Library/Application Support/Claude/claude_desktop_config.json` | Claude Desktop | MCP server registrations (written by `agenticros mcp setup` or `agenticros claude setup --desktop`). |
 | `~/agenticros/` | CLI (npm-install mode) | Copy of the monorepo, with built dist + colcon install. |
 | `/tmp/agenticros-*.pid` | CLI | PIDs of background processes the CLI spawned. |
 | `/tmp/agenticros-*.log` | CLI | Stdout/stderr from those processes. |
@@ -182,11 +221,12 @@ Read or edit `~/.agenticros/config.json`. Actions:
 ## Troubleshooting
 
 - **`doctor` shows red checks** → run `agenticros init` to walk through every
-  step. Re-run `doctor` afterward. For Codex-specific issues, run
-  `agenticros codex doctor`. For Hermes, run `agenticros hermes doctor`.
-- **Codex `/mcp` does not list agenticros** → run `agenticros codex setup`
+  step. Re-run `doctor` afterward. For MCP-specific issues, run
+  `agenticros mcp doctor` (or `agenticros codex doctor`, `agenticros hermes doctor`, `agenticros claude doctor`).
+- **MCP tools missing in any client** → run `agenticros mcp setup`. See [mcp-setup.md](mcp-setup.md).
+- **Codex `/mcp` does not list agenticros** → run `agenticros mcp setup --codex`
   (absolute MCP path required). See [codex-setup.md](codex-setup.md).
-- **Hermes MCP tools missing** → run `agenticros hermes setup`, then `/reload-mcp`
+- **Hermes MCP tools missing** → run `agenticros mcp setup --hermes`, then `/reload-mcp`
   in Hermes. See [hermes-setup.md](hermes-setup.md).
 - **`up` exits immediately** → `agenticros logs <component>` (the CLI now
   records where every child wrote its output) and read the error in context.

package/runtime/docs/robot-setup.md

@@ -296,7 +296,7 @@ The message comes from **OpenAI's API limits**, not from AgenticROS. The gateway
 1. **Confirm it's OpenAI** — Check gateway logs:  
    `journalctl --user -u openclaw-gateway.service -n 100 --no-pager | grep -i "429\|rate\|limit\|error"`
 2. **Check your OpenAI account** — [Usage](https://platform.openai.com/usage), [API keys](https://platform.openai.com/api-keys). Free/low tiers have strict RPM/TPM and can stay limited for a while.
-3. **What helps** — Wait (RPM/TPM reset in minutes; daily limits at UTC midnight). Or in OpenClaw switch to a model with higher limits if available.
+3. **What helps** — Wait (RPM/TPM reset in minutes; daily limits at UTC midnight). Or switch OpenClaw to a **local Ollama VLM** — see [local-vlm.md](local-vlm.md). Or in OpenClaw switch to a model with higher limits if available.
 4. **AgenticROS** — We only trim context/tool output to use fewer tokens; we can't remove OpenAI's limits.
 
 ### 404 errors when installing rosbridge_suite

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

@@ -21,6 +21,8 @@
       "ros2_find_robots_for",
       "run_mission",
       "mission_cancel",
+      "mission_pause",
+      "mission_resume",
       "ros2_camera_snapshot",
       "ros2_depth_distance",
       "memory_remember",
@@ -30,7 +32,8 @@
       "follow_robot",
       "follow_me_see",
       "ollama_status",
-      "find_object"
+      "find_object",
+      "scan_surroundings"
     ]
   },
   "configSchema": {
@@ -178,6 +181,149 @@
           }
         }
       },
+      "robots": {
+        "type": "array",
+        "description": "Multi-robot fleet list. When non-empty, used by ros2_list_robots and per-tool robot_id. When empty, the legacy config.robot entry is used. Manage via `agenticros robots` CLI.",
+        "default": [],
+        "items": {
+          "type": "object",
+          "required": [
+            "id"
+          ],
+          "properties": {
+            "id": {
+              "type": "string",
+              "description": "Stable identifier referenced by robot_id tool arguments"
+            },
+            "name": {
+              "type": "string",
+              "default": "Robot"
+            },
+            "namespace": {
+              "type": "string",
+              "default": ""
+            },
+            "cameraTopic": {
+              "type": "string",
+              "default": ""
+            },
+            "default": {
+              "type": "boolean",
+              "description": "When true, this robot is active even if not first in the list"
+            },
+            "kind": {
+              "type": "string",
+              "description": "Robot kind for ros2_find_robots_for (e.g. amr, arm, drone, rover)",
+              "default": "amr"
+            },
+            "sensors": {
+              "type": "object",
+              "properties": {
+                "has_realsense": {
+                  "type": "boolean",
+                  "default": false
+                },
+                "has_lidar": {
+                  "type": "boolean",
+                  "default": false
+                },
+                "has_arm": {
+                  "type": "boolean",
+                  "default": false
+                }
+              }
+            },
+            "capabilities": {
+              "type": "array",
+              "description": "Optional per-robot capability allowlist for ros2_find_robots_for",
+              "items": {
+                "type": "string"
+              }
+            },
+            "transport": {
+              "type": "object",
+              "description": "Per-robot transport override (inherits global transport when omitted)",
+              "properties": {
+                "mode": {
+                  "type": "string",
+                  "enum": [
+                    "rosbridge",
+                    "local",
+                    "webrtc",
+                    "zenoh"
+                  ]
+                },
+                "zenoh": {
+                  "type": "object",
+                  "properties": {
+                    "routerEndpoint": {
+                      "type": "string"
+                    },
+                    "domainId": {
+                      "type": "number"
+                    },
+                    "keyFormat": {
+                      "type": "string",
+                      "enum": [
+                        "ros2dds",
+                        "rmw_zenoh"
+                      ]
+                    },
+                    "bridgeNamespace": {
+                      "type": "string"
+                    }
+                  }
+                },
+                "rosbridge": {
+                  "type": "object",
+                  "properties": {
+                    "url": {
+                      "type": "string"
+                    },
+                    "reconnect": {
+                      "type": "boolean"
+                    },
+                    "reconnectInterval": {
+                      "type": "number"
+                    }
+                  }
+                },
+                "local": {
+                  "type": "object",
+                  "properties": {
+                    "domainId": {
+                      "type": "number"
+                    }
+                  }
+                },
+                "webrtc": {
+                  "type": "object",
+                  "properties": {
+                    "signalingUrl": {
+                      "type": "string"
+                    },
+                    "apiUrl": {
+                      "type": "string"
+                    },
+                    "robotId": {
+                      "type": "string"
+                    },
+                    "robotKey": {
+                      "type": "string"
+                    },
+                    "iceServers": {
+                      "type": "array",
+                      "items": {
+                        "type": "object"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
       "teleop": {
         "type": "object",
         "description": "Teleop web app: camera and twist controls",

package/runtime/packages/agenticros/src/__tests__/capabilities-plugin.test.ts

@@ -131,6 +131,8 @@ test("plugin: register() is synchronous and produces the base 15-tool surface",
     "run_mission",
     // Phase 1.f — cancel an in-flight mission by id.
     "mission_cancel",
+    "mission_pause",
+    "mission_resume",
   ];
   for (const name of expected) {
     assert.ok(toolNames.includes(name), `Expected base tool ${name} in registered set`);

package/runtime/packages/agenticros/src/routes.ts

@@ -1,6 +1,6 @@
 import type { OpenClawPluginApi, HttpRouteHandler, HttpRouteResponse } from "./plugin-api.js";
 import type { AgenticROSConfig } from "@agenticros/core";
-import { parseConfig } from "@agenticros/core";
+import { parseConfig, prepareConfigForPersistence } from "@agenticros/core";
 import {
   readOpenClawConfig,
   writeAgenticROSConfig,
@@ -172,8 +172,9 @@ export function registerRoutes(api: OpenClawPluginApi, config: AgenticROSConfig)
         api.logger.warn("AgenticROS config read failed: " + readMsg);
         return { success: false, error: readMsg, statusCode: 500 };
       }
+      let combined: Record<string, unknown>;
       try {
-        const combined =
+        combined =
           existingAgenticROS && typeof existingAgenticROS === "object"
             ? mergeIncomingAgenticROSConfig(existingAgenticROS, body)
             : body;
@@ -192,7 +193,7 @@ export function registerRoutes(api: OpenClawPluginApi, config: AgenticROSConfig)
         merged.webrtc.robotKey = existingKey;
       }
       try {
-        writeAgenticROSConfig(merged as unknown as Record<string, unknown>);
+        writeAgenticROSConfig(prepareConfigForPersistence(merged, combined));
       } catch (err) {
         const msg = err instanceof ConfigFileError ? err.message : (err instanceof Error ? err.message : "Failed to write config");
         api.logger.warn("AgenticROS config write failed: " + msg);

package/runtime/packages/agenticros/src/tools/index.ts

@@ -14,6 +14,8 @@ import { registerDiscoverRobotsTool } from "./ros2-discover.js";
 import { registerFindRobotsForTool } from "./ros2-find-robots-for.js";
 import { registerMissionTool, type ToolRegistry } from "./ros2-mission.js";
 import { registerMissionCancelTool } from "./mission-cancel.js";
+import { registerMissionPauseTool } from "./mission-pause.js";
+import { registerMissionResumeTool } from "./mission-resume.js";
 
 /**
  * Wrap the OpenClaw API so every registerTool() call is also recorded in
@@ -21,11 +23,8 @@ import { registerMissionCancelTool } from "./mission-cancel.js";
  * dispatch sub-tool calls by name (e.g. capability "drive_base" routes
  * to the registered "ros2_publish" tool's execute()).
  *
- * We keep this internal — skills that register their own tools via
- * `api.registerTool` won't appear in the registry, which is fine for
- * v1: today the mission runner only supports the eight intrinsic
- * capability bindings declared in ros2-mission.ts. Phase 1.d will
- * extend this to capture skill-declared tools as well.
+ * Skill tools registered via `api.registerTool` are captured too, so
+ * `buildMissionBindings` can resolve `ros2_<capability_id>` when present.
  */
 function wrapApiWithToolCapture(api: OpenClawPluginApi): {
   wrappedApi: OpenClawPluginApi;
@@ -63,4 +62,6 @@ export function registerTools(api: OpenClawPluginApi, config: AgenticROSConfig):
   registerFindRobotsForTool(wrappedApi, config);
   registerMissionTool(wrappedApi, config, registry);
   registerMissionCancelTool(wrappedApi);
+  registerMissionPauseTool(wrappedApi);
+  registerMissionResumeTool(wrappedApi);
 }

package/runtime/packages/agenticros/src/tools/mission-pause.ts

@@ -0,0 +1,49 @@
+/**
+ * Tool: mission_pause — pause a running mission at the next step boundary.
+ */
+
+import { Type } from "@sinclair/typebox";
+import type { OpenClawPluginApi } from "../plugin-api.js";
+import { getMissionRegistry } from "../mission-registry.js";
+
+export function registerMissionPauseTool(api: OpenClawPluginApi): void {
+  api.registerTool({
+    name: "mission_pause",
+    label: "Pause Mission",
+    description:
+      "Pause a mission that's currently running in this OpenClaw plugin process. " +
+      "Pass the mission_id returned by run_mission. The runner waits at the next step " +
+      "boundary until mission_resume (or mission_cancel). Idempotent if already paused.",
+    parameters: Type.Object({
+      mission_id: Type.String({
+        description: "The mission_id echoed by run_mission. Required.",
+      }),
+      reason: Type.Optional(
+        Type.String({
+          description: "Optional free-text reason — surfaced in the paused transcript entry.",
+        }),
+      ),
+    }),
+
+    async execute(_toolCallId, params) {
+      const missionId = typeof params["mission_id"] === "string" ? (params["mission_id"] as string).trim() : "";
+      if (!missionId) {
+        const text = "mission_pause requires 'mission_id' (a non-empty string returned by run_mission).";
+        return { content: [{ type: "text", text }], details: { success: false, error: text } };
+      }
+      const reason = typeof params["reason"] === "string" ? (params["reason"] as string) : undefined;
+      const outcome = getMissionRegistry().pause(missionId, reason);
+      const details = {
+        success: true,
+        mission_id: missionId,
+        found: outcome.found,
+        already_paused: outcome.alreadyPaused,
+        reason: reason ?? null,
+      };
+      return {
+        content: [{ type: "text", text: JSON.stringify(details) }],
+        details,
+      };
+    },
+  });
+}

package/runtime/packages/agenticros/src/tools/mission-resume.ts

@@ -0,0 +1,41 @@
+/**
+ * Tool: mission_resume — resume a paused mission.
+ */
+
+import { Type } from "@sinclair/typebox";
+import type { OpenClawPluginApi } from "../plugin-api.js";
+import { getMissionRegistry } from "../mission-registry.js";
+
+export function registerMissionResumeTool(api: OpenClawPluginApi): void {
+  api.registerTool({
+    name: "mission_resume",
+    label: "Resume Mission",
+    description:
+      "Resume a mission previously paused with mission_pause. Pass the mission_id " +
+      "returned by run_mission. Idempotent if the mission is not paused.",
+    parameters: Type.Object({
+      mission_id: Type.String({
+        description: "The mission_id echoed by run_mission. Required.",
+      }),
+    }),
+
+    async execute(_toolCallId, params) {
+      const missionId = typeof params["mission_id"] === "string" ? (params["mission_id"] as string).trim() : "";
+      if (!missionId) {
+        const text = "mission_resume requires 'mission_id' (a non-empty string returned by run_mission).";
+        return { content: [{ type: "text", text }], details: { success: false, error: text } };
+      }
+      const outcome = getMissionRegistry().resume(missionId);
+      const details = {
+        success: true,
+        mission_id: missionId,
+        found: outcome.found,
+        was_paused: outcome.wasPaused,
+      };
+      return {
+        content: [{ type: "text", text: JSON.stringify(details) }],
+        details,
+      };
+    },
+  });
+}