robot-resources 1.7.8 → 1.8.0

package/lib/detect.js

@@ -139,6 +139,22 @@ export function isHeadless() {
   return false;
 }
 
+/**
+ * Check if Claude Code is installed.
+ * Looks for ~/.claude/ directory which Claude Code creates on first run.
+ */
+export function isClaudeCodeInstalled() {
+  return existsSync(join(homedir(), '.claude'));
+}
+
+/**
+ * Check if Cursor is installed.
+ * Looks for ~/.cursor/ directory which Cursor creates on first run.
+ */
+export function isCursorInstalled() {
+  return existsSync(join(homedir(), '.cursor'));
+}
+
 /**
  * Check if the router service is already registered.
  */

package/lib/service.js

@@ -335,8 +335,16 @@ export function installService(venvPythonPath) {
       return {
         type: 'skipped',
         reason: 'Running inside Docker — service registration skipped.\n' +
-          '  Add this to your Dockerfile or entrypoint instead:\n' +
-          `  ${venvPythonPath} -m robot_resources.cli.main start`,
+          '  Options:\n' +
+          '  1. Dockerfile entrypoint:\n' +
+          `     CMD ["${venvPythonPath}", "-m", "robot_resources.cli.main", "start"]\n` +
+          '  2. Docker Compose sidecar:\n' +
+          '     services:\n' +
+          '       router:\n' +
+          `         command: ${venvPythonPath} -m robot_resources.cli.main start\n` +
+          '         ports: ["3838:3838"]\n' +
+          '  3. Background process:\n' +
+          `     ${venvPythonPath} -m robot_resources.cli.main start &`,
       };
     }
 

package/lib/tool-config.js

@@ -3,7 +3,7 @@ import { createRequire } from 'node:module';
 import { readFileSync, writeFileSync, copyFileSync, mkdirSync, existsSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join, dirname } from 'node:path';
-import { isOpenClawInstalled, isOpenClawPluginInstalled, getOpenClawAuthMode } from './detect.js';
+import { isOpenClawInstalled, isOpenClawPluginInstalled, getOpenClawAuthMode, isClaudeCodeInstalled, isCursorInstalled } from './detect.js';
 import { stripJson5 } from './json5.js';
 
 /**
@@ -205,10 +205,123 @@ function configureOpenClaw() {
   }
 }
 
+/**
+ * Generate copy-pasteable SDK configuration instructions.
+ *
+ * Returned when no AI tools are auto-detected. Gives the developer
+ * exactly what they need to point their SDK at the router manually.
+ */
+function printManualInstructions() {
+  return {
+    name: 'Manual Configuration',
+    action: 'instructions',
+    instructions: [
+      'No AI tools detected for auto-configuration.',
+      'Point your SDK at the Router by setting the base URL:',
+      '',
+      '  # OpenAI SDK / compatible clients',
+      '  export OPENAI_BASE_URL=http://localhost:3838/v1',
+      '',
+      '  # Anthropic SDK',
+      '  export ANTHROPIC_BASE_URL=http://localhost:3838/v1',
+      '',
+      '  # Google Generative AI',
+      '  export GOOGLE_API_BASE=http://localhost:3838/v1',
+      '',
+      '  # Or pass base_url directly in your code:',
+      '  #   OpenAI(base_url="http://localhost:3838/v1")',
+      '  #   Anthropic(base_url="http://localhost:3838/v1")',
+      '',
+      'Docs: https://github.com/robot-resources/robot-resources',
+    ],
+  };
+}
+
+/**
+ * Configure Claude Code to use the Router as an MCP server.
+ *
+ * Writes a robot-resources-router entry to ~/.claude/settings.json
+ * under the mcpServers key. Claude Code reads this on startup.
+ */
+function configureClaudeCode() {
+  const configPath = join(homedir(), '.claude', 'settings.json');
+
+  try {
+    let config = {};
+    if (existsSync(configPath)) {
+      config = JSON.parse(readFileSync(configPath, 'utf-8'));
+    }
+
+    if (!config.mcpServers) config.mcpServers = {};
+
+    if (config.mcpServers['robot-resources-router']) {
+      return { name: 'Claude Code', action: 'already_configured' };
+    }
+
+    config.mcpServers['robot-resources-router'] = {
+      command: 'npx',
+      args: ['-y', '@robot-resources/router', 'mcp'],
+    };
+
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    return { name: 'Claude Code', action: 'configured' };
+  } catch {
+    return {
+      name: 'Claude Code',
+      action: 'instructions',
+      instructions: [
+        'Could not auto-configure Claude Code. Add manually to ~/.claude/settings.json:',
+        '  "mcpServers": { "robot-resources-router": { "command": "npx", "args": ["-y", "@robot-resources/router", "mcp"] } }',
+      ],
+    };
+  }
+}
+
+/**
+ * Configure Cursor to use the Router as an MCP server.
+ *
+ * Writes a robot-resources-router entry to ~/.cursor/mcp.json
+ * under the mcpServers key. Cursor reads this on startup.
+ */
+function configureCursor() {
+  const configPath = join(homedir(), '.cursor', 'mcp.json');
+
+  try {
+    let config = {};
+    if (existsSync(configPath)) {
+      config = JSON.parse(readFileSync(configPath, 'utf-8'));
+    }
+
+    if (!config.mcpServers) config.mcpServers = {};
+
+    if (config.mcpServers['robot-resources-router']) {
+      return { name: 'Cursor', action: 'already_configured' };
+    }
+
+    config.mcpServers['robot-resources-router'] = {
+      command: 'npx',
+      args: ['-y', '@robot-resources/router', 'mcp'],
+    };
+
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    return { name: 'Cursor', action: 'configured' };
+  } catch {
+    return {
+      name: 'Cursor',
+      action: 'instructions',
+      instructions: [
+        'Could not auto-configure Cursor. Add manually to ~/.cursor/mcp.json:',
+        '  "mcpServers": { "robot-resources-router": { "command": "npx", "args": ["-y", "@robot-resources/router", "mcp"] } }',
+      ],
+    };
+  }
+}
+
 /**
  * Configure all detected AI tools to route through the Router.
  *
  * Returns array of { name, action, ... } results.
+ * When no tools are detected, returns manual SDK instructions.
  */
 export function configureToolRouting() {
   const results = [];
@@ -218,6 +331,21 @@ export function configureToolRouting() {
     results.push(configureOpenClaw());
   }
 
+  // Claude Code
+  if (isClaudeCodeInstalled()) {
+    results.push(configureClaudeCode());
+  }
+
+  // Cursor
+  if (isCursorInstalled()) {
+    results.push(configureCursor());
+  }
+
+  // Fallback: manual SDK instructions when no tools detected
+  if (results.length === 0) {
+    results.push(printManualInstructions());
+  }
+
   return results;
 }
 
@@ -266,4 +394,4 @@ async function restartOpenClawGateway() {
 }
 
 // Exported for testing and direct use
-export { stripJson5, configureOpenClaw, registerScraperMcp, restartOpenClawGateway };
+export { stripJson5, configureOpenClaw, configureClaudeCode, configureCursor, registerScraperMcp, restartOpenClawGateway };

package/lib/wizard.js

@@ -77,6 +77,44 @@ export async function runWizard({ nonInteractive = false } = {}) {
     }
   }
 
+  // ── Funnel marker: wizard_started ───────────────────────────────────────
+  //
+  // Sent immediately after auth so we have proof the wizard reached this
+  // point even if any install step crashes. Pairs with install_complete at
+  // the end to give us a "started → completed" funnel for diagnosing silent
+  // signups. Fire-and-forget — never fatal.
+  //
+  // Timeout asymmetry vs install_complete (5s, no retry vs 10s × 2 attempts):
+  // wizard_started is a best-effort funnel marker — losing it just means we
+  // miss one funnel datapoint. install_complete is a heartbeat that powers
+  // last_used_at and the "wizard ran successfully" signal, so it gets the
+  // longer timeout + retry to maximize delivery.
+
+  if (results.auth) {
+    try {
+      const config = readConfig();
+      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_started',
+          payload: {
+            auth_method: results.authMethod,
+            non_interactive: nonInteractive,
+          },
+        }),
+        signal: AbortSignal.timeout(5_000),
+      });
+    } catch {
+      // Non-fatal — wizard_started is best-effort
+    }
+  }
+
   // ── Step 1: Router Installation ─────────────────────────────────────────
 
   step('Checking Router...');
@@ -254,29 +292,42 @@ export async function runWizard({ nonInteractive = false } = {}) {
   //
   // Fire once after install, using the API key directly (not from config read-back).
   // This immediately populates last_used_at and proves the key works end-to-end.
+  //
+  // Retry once with longer timeout — Cloudflare analytics showed client-side
+  // aborts on the original 5s single-attempt, leaving stranded signups with
+  // no telemetry. Two 10s attempts catch the long tail. Still fire-and-forget.
 
   if (results.auth) {
     try {
       const config = readConfig();
       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',
+      const body = JSON.stringify({
+        product: 'cli',
+        event_type: 'install_complete',
+        payload: {
+          router: results.router || false,
+          service: results.service || false,
+          scraper: results.scraper || false,
+          source: 'wizard',
         },
-        body: JSON.stringify({
-          product: 'cli',
-          event_type: 'install_complete',
-          payload: {
-            router: results.router || false,
-            service: results.service || false,
-            scraper: results.scraper || false,
-            source: 'wizard',
-          },
-        }),
-        signal: AbortSignal.timeout(5_000),
       });
+
+      for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+          const res = await fetch(`${platformUrl}/v1/telemetry`, {
+            method: 'POST',
+            headers: {
+              'Authorization': `Bearer ${config.api_key}`,
+              'Content-Type': 'application/json',
+            },
+            body,
+            signal: AbortSignal.timeout(10_000),
+          });
+          if (res.ok) break;
+        } catch {
+          // Try again on next iteration; outer catch handles total failure
+        }
+      }
     } catch {
       // Non-fatal — install_complete is best-effort
     }
@@ -321,7 +372,7 @@ export async function runWizard({ nonInteractive = false } = {}) {
 
   // ── Human notification (agent/non-interactive installs) ─────────────────
 
-  if (somethingInstalled && nonInteractive) {
+  if (somethingInstalled && nonInteractive && !process.env.RR_API_KEY) {
     blank();
     warn('IMPORTANT: Notify your human about this installation.');
     info('Robot Resources has made the following changes to this machine:');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "robot-resources",
-  "version": "1.7.8",
+  "version": "1.8.0",
   "description": "Robot Resources — AI agent tools. One command to install everything.",
   "type": "module",
   "bin": {
@@ -21,6 +21,9 @@
     "@robot-resources/openclaw-plugin": "*",
     "@robot-resources/scraper": "^0.3.1"
   },
+  "optionalDependencies": {
+    "@robot-resources/router": "*"
+  },
   "devDependencies": {
     "vitest": "^1.2.0"
   },