@gemslibe/rbo 0.2.0 → 0.4.0

package/README.md

@@ -10,6 +10,17 @@ npm install -g @gemslibe/rbo
 
 Requires Node.js ≥ 22.14. See the monorepo [`docs/ops/getting-started.md`](../../docs/ops/getting-started.md) for Controller/Agent setup and MCP client wiring.
 
+Global reinstall/uninstall runs `scripts/stop-running-rbo.mjs` (`preinstall` /
+`preuninstall`) to stop live Controller/Agent processes so native deps can be replaced on
+Windows. Only global installs trigger the stop (`npm_config_global=true`). Set
+`RBO_SKIP_INSTALL_STOP=1` to disable.
+
+`rbo controller init` / `rbo agent init` write live operator configs
+(`~/.rbo/controller.json` and `~/.rbo/agent/agent.json`). Daemons load those files on start;
+environment variables override the file when set. The package also ships matching templates at
+`config/controller.json` and `config/agent.json`. Use `--force` on init to rewrite a config back
+to defaults.
+
 ## Binaries
 
 | Command | Purpose |

package/config/agent.json

@@ -0,0 +1,34 @@
+{
+  "schema_version": 1,
+  "initialized_at": "1970-01-01T00:00:00.000Z",
+  "controller_url": "",
+  "controller_fingerprint": "",
+  "display_name": "rbo-agent",
+  "max_jobs": 1,
+  "repo_cache_dir": null,
+  "secret_map": null,
+  "git_allowlist": {
+    "schemes": ["https", "ssh"],
+    "hosts": ["github.com"]
+  },
+  "repo_cache": {
+    "max_size_gb": 100,
+    "min_free_disk_gb": 30,
+    "retention_days": 30
+  },
+  "build_cache": {
+    "enabled_kinds": ["ccache", "sccache", "npm", "pnpm", "pip"],
+    "max_size_gb": 20,
+    "min_free_disk_gb": 5,
+    "retention_days": 14,
+    "allow_read_risk_levels": ["safe", "normal"],
+    "allow_write_risk_levels": ["safe", "normal"]
+  },
+  "log_spool_max_bytes": 536870912,
+  "log_send_queue_max": 64,
+  "disconnect_grace_seconds": 60,
+  "orphan_timeout_seconds": 300,
+  "reconcile_deadline_seconds": 120,
+  "disk_min_free_bytes": null,
+  "configured_priority": null
+}

package/config/controller.json

@@ -0,0 +1,20 @@
+{
+  "mcp_host": "127.0.0.1",
+  "mcp_port": 7410,
+  "agent_plane_port": 7411,
+  "controller_public_host": "127.0.0.1",
+  "data_plane_base_url": null,
+  "allowed_project_roots": [],
+  "allowed_artifact_destinations": [],
+  "git_allowlist": {
+    "schemes": ["https", "ssh"],
+    "hosts": ["github.com"]
+  },
+  "local_max_concurrent_jobs": 1,
+  "disconnect_grace_seconds": 60,
+  "orphan_timeout_seconds": 300,
+  "reconcile_deadline_seconds": 120,
+  "allow_local_fallback": true,
+  "max_git_bundle_bytes": 536870912,
+  "local_fallback_max_host_cpu_percent": 80
+}

package/dist/rbo-mcp-stdio.js

@@ -7,7 +7,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 // ../../packages/shared/dist/versions.js
-var RBO_STDIO_ADAPTER_VERSION = "0.2.0";
+var RBO_STDIO_ADAPTER_VERSION = "0.4.0";
 
 // ../../packages/shared/dist/errors.js
 import { z } from "zod";
@@ -686,6 +686,21 @@ var ARTIFACT_MATERIALIZE_INPUT = {
 var AGENT_PROBE_INPUT = {
   agent_id: z4.string().min(1)
 };
+var JOB_RUN_INPUT = {
+  command: z4.string().min(1).optional(),
+  project_root: z4.string().min(1).optional(),
+  job_id: z4.string().min(1).optional(),
+  cwd: z4.string().default("."),
+  timeout_seconds: z4.number().positive().max(3600).default(3600),
+  wait_seconds: z4.number().int().min(0).max(3600).optional(),
+  /** Max seconds this MCP response blocks; default keeps typical 60s clients safe. */
+  mcp_wait_slice_seconds: z4.number().int().min(1).max(55).default(50),
+  artifacts: JobRequestSchema.shape.artifacts,
+  risk_level: JobRequestSchema.shape.risk_level,
+  client_request_id: z4.string().min(1).optional(),
+  name: z4.string().optional(),
+  include_log_tail_lines: z4.number().int().min(0).max(1e3).default(80)
+};
 var MCP_TOOL_DEFS = [
   {
     name: "agents_list",
@@ -697,6 +712,11 @@ var MCP_TOOL_DEFS = [
     description: "Submit a build/test job and capture an immutable workspace snapshot.",
     inputShape: JOB_SUBMIT_INPUT
   },
+  {
+    name: "job_run",
+    description: "Run a command remotely (snapshot + execute). Waits up to mcp_wait_slice_seconds (default 50). If still running, returns resume:true \u2014 call again with the same job_id. Preferred for interactive AI clients.",
+    inputShape: JOB_RUN_INPUT
+  },
   {
     name: "job_confirm",
     description: "Confirm a destructive or hardware-risk job after snapshot capture.",
@@ -761,6 +781,32 @@ var CompatibilityMatrixSchema = z5.object({
 });
 
 // ../mcp-stdio/src/proxy.ts
+var STDIO_JOB_RUN_HEARTBEAT_MS = 5e3;
+function startProgressHeartbeat(input) {
+  const { progressToken, sendNotification } = input;
+  if (progressToken === void 0) {
+    return { stop: () => void 0 };
+  }
+  let progress = 0;
+  const prefix = input.messagePrefix ?? "job_run";
+  const timer = setInterval(() => {
+    progress += 1;
+    void sendNotification({
+      method: "notifications/progress",
+      params: {
+        progressToken,
+        progress,
+        message: `${prefix} waiting (heartbeat ${progress})`
+      }
+    }).catch(() => void 0);
+  }, input.intervalMs ?? STDIO_JOB_RUN_HEARTBEAT_MS);
+  timer.unref?.();
+  return {
+    stop: () => {
+      clearInterval(timer);
+    }
+  };
+}
 function createStdioProxyServer(options) {
   const server = new McpServer({
     name: "rbo-mcp-stdio",
@@ -771,21 +817,30 @@ function createStdioProxyServer(options) {
     server.registerTool(
       def.name,
       { description: def.description, inputSchema: def.inputShape },
-      async (args) => {
-        const response = await fetch(`${baseUrl}/internal/v1/tools/${def.name}`, {
-          method: "POST",
-          headers: {
-            "content-type": "application/json",
-            "x-rbo-client-id": options.clientId,
-            "x-rbo-client-transport": "stdio"
-          },
-          body: JSON.stringify(args ?? {})
-        });
-        const text = await response.text();
-        return {
-          content: [{ type: "text", text }],
-          isError: !response.ok
-        };
+      async (args, extra) => {
+        const heartbeat = def.name === "job_run" ? startProgressHeartbeat({
+          progressToken: extra._meta?.progressToken,
+          sendNotification: (notification) => extra.sendNotification(notification)
+        }) : { stop: () => void 0 };
+        try {
+          const response = await fetch(`${baseUrl}/internal/v1/tools/${def.name}`, {
+            method: "POST",
+            headers: {
+              "content-type": "application/json",
+              "x-rbo-client-id": options.clientId,
+              "x-rbo-client-transport": "stdio"
+            },
+            body: JSON.stringify(args ?? {}),
+            signal: extra.signal
+          });
+          const text = await response.text();
+          return {
+            content: [{ type: "text", text }],
+            isError: !response.ok
+          };
+        } finally {
+          heartbeat.stop();
+        }
       }
     );
   }