robot-resources 1.11.1 → 1.11.2

package/bin/setup.js

@@ -1,20 +1,32 @@
 #!/usr/bin/env node
 
-import { runWizard } from '../lib/wizard.js';
+import { runWizard, runUninstallCommand } from '../lib/wizard.js';
 
 const args = process.argv.slice(2);
-const explicitNonInteractive =
-  args.includes('--non-interactive') || args.includes('--yes') || args.includes('-y');
-const targetArg = args.find((a) => a.startsWith('--for='));
-const target = targetArg ? targetArg.slice('--for='.length) : null;
 
-// Treat piped/CI runs (no TTY on stdin OR stdout) as non-interactive so the
-// wizard never blocks on a prompt that can't be answered. The interactive
-// menu is only opened when both stdin and stdout are real terminals.
-const hasTty = Boolean(process.stdin.isTTY && process.stdout.isTTY);
-const nonInteractive = explicitNonInteractive || !hasTty;
+// --uninstall ships in Phase 0 as the counterpart to install. --purge also
+// wipes ~/.robot-resources/config.json (api_key + claim_url); without it,
+// the api_key is preserved across a reinstall.
+if (args.includes('--uninstall')) {
+  const purge = args.includes('--purge');
+  runUninstallCommand({ purge }).catch((err) => {
+    console.error(`\n  ✗ Uninstall failed: ${err.message}\n`);
+    process.exit(1);
+  });
+} else {
+  const explicitNonInteractive =
+    args.includes('--non-interactive') || args.includes('--yes') || args.includes('-y');
+  const targetArg = args.find((a) => a.startsWith('--for='));
+  const target = targetArg ? targetArg.slice('--for='.length) : null;
 
-runWizard({ nonInteractive, target }).catch((err) => {
-  console.error(`\n  ✗ Setup failed: ${err.message}\n`);
-  process.exit(1);
-});
+  // Treat piped/CI runs (no TTY on stdin OR stdout) as non-interactive so the
+  // wizard never blocks on a prompt that can't be answered. The interactive
+  // menu is only opened when both stdin and stdout are real terminals.
+  const hasTty = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+  const nonInteractive = explicitNonInteractive || !hasTty;
+
+  runWizard({ nonInteractive, target }).catch((err) => {
+    console.error(`\n  ✗ Setup failed: ${err.message}\n`);
+    process.exit(1);
+  });
+}

package/lib/non-oc-wizard.js

@@ -206,6 +206,7 @@ export async function runNonOcWizard({ nonInteractive = false, target = null } =
     info('  npx robot-resources --for=claude-code    # Claude Code MCP config');
     info('  npx robot-resources --for=docs           # docs URL');
     blank();
+    await emitPathChosen('noninteractive_no_target');
     return;
   }
 
@@ -231,8 +232,13 @@ export async function runNonOcWizard({ nonInteractive = false, target = null } =
       ],
     });
   } catch (err) {
-    // User hit Ctrl-C or terminal closed — exit cleanly.
-    if (err && (err.name === 'ExitPromptError' || err.code === 'ABORT_ERR')) return;
+    // User hit Ctrl-C or terminal closed — exit cleanly, but mark the funnel
+    // so we can distinguish "agent shown the prompt and bailed" from
+    // "wizard never reached the prompt at all" in Supabase.
+    if (err && (err.name === 'ExitPromptError' || err.code === 'ABORT_ERR')) {
+      await emitPathChosen('aborted');
+      return;
+    }
     throw err;
   }
 

package/lib/uninstall.js

@@ -0,0 +1,100 @@
+import { existsSync, readFileSync, writeFileSync, rmSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { stripJson5 } from './json5.js';
+
+/**
+ * Single source of truth for `npx robot-resources --uninstall`.
+ *
+ * Reverses the install actions in tool-config.js: removes the router and
+ * scraper OC plugin directories, deletes their entries from openclaw.json
+ * (plugins.entries + plugins.allow + mcp.servers).
+ *
+ * Phase 0 scope is OC-only. Phase 3 will extend this with shell-config
+ * removal (NODE_OPTIONS line) and `pip uninstall robot-resources` for the
+ * Node and Python shim install paths.
+ *
+ * `~/.robot-resources/config.json` is preserved by default so a subsequent
+ * re-install reuses the same api_key (and the user's claim_url stays valid).
+ * Pass { purge: true } to wipe it as well.
+ *
+ * Returns { components_removed: string[], errors: { component, message }[] }
+ * for telemetry. Failure to remove one component never aborts the others —
+ * a partial uninstall is still progress, and we want to record what worked.
+ */
+export function runUninstall({ purge = false } = {}) {
+  const components_removed = [];
+  const errors = [];
+
+  // 1. Plugin directories under ~/.openclaw/extensions/
+  const pluginDirs = [
+    { id: 'robot-resources-router', label: 'router_plugin_dir' },
+    { id: 'robot-resources-scraper-oc-plugin', label: 'scraper_plugin_dir' },
+  ];
+  for (const { id, label } of pluginDirs) {
+    const path = join(homedir(), '.openclaw', 'extensions', id);
+    if (!existsSync(path)) continue;
+    try {
+      rmSync(path, { recursive: true, force: true });
+      components_removed.push(label);
+    } catch (err) {
+      errors.push({ component: label, message: err.message });
+    }
+  }
+
+  // 2. openclaw.json — strip our entries from plugins.entries, plugins.allow,
+  //    and mcp.servers. Leave everything else (other plugins, user config) alone.
+  //    Idempotent: if openclaw.json is missing or malformed, skip silently —
+  //    that's the right behavior for "cleanup what you can find."
+  const ocConfigPath = join(homedir(), '.openclaw', 'openclaw.json');
+  if (existsSync(ocConfigPath)) {
+    try {
+      const config = JSON.parse(stripJson5(readFileSync(ocConfigPath, 'utf-8')));
+      let mutated = false;
+
+      if (config?.plugins?.entries) {
+        for (const id of ['robot-resources-router', 'robot-resources-scraper-oc-plugin']) {
+          if (config.plugins.entries[id]) {
+            delete config.plugins.entries[id];
+            mutated = true;
+          }
+        }
+      }
+
+      if (Array.isArray(config?.plugins?.allow)) {
+        const before = config.plugins.allow.length;
+        config.plugins.allow = config.plugins.allow.filter(
+          (id) => id !== 'robot-resources-router' && id !== 'robot-resources-scraper-oc-plugin',
+        );
+        if (config.plugins.allow.length !== before) mutated = true;
+      }
+
+      if (config?.mcp?.servers?.['robot-resources-scraper']) {
+        delete config.mcp.servers['robot-resources-scraper'];
+        mutated = true;
+      }
+
+      if (mutated) {
+        writeFileSync(ocConfigPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+        components_removed.push('openclaw_config_entries');
+      }
+    } catch (err) {
+      errors.push({ component: 'openclaw_config_entries', message: err.message });
+    }
+  }
+
+  // 3. Optionally wipe ~/.robot-resources/config.json (and any siblings)
+  if (purge) {
+    const rrDir = join(homedir(), '.robot-resources');
+    if (existsSync(rrDir)) {
+      try {
+        rmSync(rrDir, { recursive: true, force: true });
+        components_removed.push('rr_config_dir');
+      } catch (err) {
+        errors.push({ component: 'rr_config_dir', message: err.message });
+      }
+    }
+  }
+
+  return { components_removed, errors };
+}

package/lib/wizard.js

@@ -8,6 +8,7 @@ import { configureToolRouting, registerScraperMcp, restartOpenClawGateway } from
 import { checkHealth } from './health-report.js';
 import { header, step, success, warn, error, info, blank, summary } from './ui.js';
 import { runNonOcWizard } from './non-oc-wizard.js';
+import { runUninstall } from './uninstall.js';
 
 // Stamped onto every CLI telemetry payload so we can tell which `robot-resources`
 // version a user actually ran. Without this, npx-cached old installers look
@@ -398,3 +399,71 @@ export async function runWizard({ nonInteractive = false, target = null } = {})
     }
   }
 }
+
+/**
+ * Uninstall counterpart to runWizard. Removes the OC plugin install side
+ * (router + scraper plugin dirs, openclaw.json entries) via uninstall.js.
+ *
+ * config.json (and its api_key) is preserved by default so a later re-install
+ * keeps the same identity. `--purge` wipes ~/.robot-resources/ as well.
+ *
+ * Telemetry: emits `wizard_uninstalled` with the list of components actually
+ * removed plus any per-component errors. Fire-and-forget — never block the
+ * uninstall on telemetry latency or failure.
+ */
+export async function runUninstallCommand({ purge = false } = {}) {
+  header();
+  step(purge ? 'Uninstalling Robot Resources (purge)...' : 'Uninstalling Robot Resources...');
+
+  const result = runUninstall({ purge });
+
+  blank();
+  if (result.components_removed.length === 0 && result.errors.length === 0) {
+    info('Nothing to remove — Robot Resources was not installed in this account.');
+  } else {
+    if (result.components_removed.length > 0) {
+      success(`Removed: ${result.components_removed.join(', ')}`);
+    }
+    for (const e of result.errors) {
+      warn(`${e.component}: ${e.message}`);
+    }
+  }
+
+  // Preserve the api_key (unless --purge) so re-running `npx robot-resources`
+  // doesn't issue a second key. Tell the user explicitly so they can purge if
+  // they really want a clean slate.
+  if (!purge) {
+    blank();
+    info('Kept ~/.robot-resources/config.json (your api_key + claim_url).');
+    info('Re-run with --purge to wipe it.');
+  }
+
+  // Best-effort telemetry — same shape as the rest of the CLI's calls.
+  try {
+    const config = readConfig();
+    if (config.api_key) {
+      const platformUrl = process.env.RR_PLATFORM_URL || 'https://api.robotresources.ai';
+      await fetch(`${platformUrl}/v1/telemetry`, {
+        method: 'POST',
+        headers: {
+          'Authorization': `Bearer ${config.api_key}`,
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+          product: 'cli',
+          event_type: 'wizard_uninstalled',
+          payload: {
+            cli_version: CLI_VERSION,
+            purge,
+            components_removed: result.components_removed,
+            error_count: result.errors.length,
+            platform: process.platform,
+          },
+        }),
+        signal: AbortSignal.timeout(5_000),
+      });
+    }
+  } catch {
+    // Non-fatal — telemetry must never block the uninstall path.
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "robot-resources",
-  "version": "1.11.1",
+  "version": "1.11.2",
   "description": "Robot Resources — AI agent tools. One command to install everything.",
   "type": "module",
   "bin": {