robot-resources 1.7.7 → 1.7.9

package/README.md

@@ -2,103 +2,88 @@
 
 > Tools for AI agents. Humans have HR. Agents have RR.
 
-Robot Resources builds tools for AI agents and any software that makes LLM API calls — chatbots, RAG pipelines, AI-powered apps, internal tools. Two products today: **Router** (intelligent model routing, 60-90% cost savings) and **Scraper** (token compression for web content, median 91% token reduction). Both run locally, both free.
+Two products for any software that makes LLM API calls — chatbots, RAG pipelines, AI-powered apps, agent runtimes. Both run locally, both free.
 
-## Quick Start
+**Router** — Intelligent LLM routing proxy. Classifies each prompt by task type, routes to the cheapest model that qualifies. 60-90% cost savings with zero quality loss.
+
+**Scraper** — Token compression for web content. Fetches any URL, strips noise, returns clean markdown. Median 91% token reduction.
+
+## Install
 
 ```bash
 npx robot-resources
 ```
 
-One command: authenticates via GitHub OAuth, installs Router as an always-on service, registers Scraper as the default web compression tool, and configures your agent automatically.
+One command: installs Router as an always-on system service, registers Scraper as an MCP tool, configures your agent automatically.
 
-## Products
+## What It Does
 
-### Router
+1. **Installs Router** — Python venv + system service on localhost:3838
+2. **Registers Scraper** — MCP tool `scraper_compress_url(url)` in your agent
+3. **Configures OpenClaw** — Plugin auto-installed if OpenClaw is detected
+4. **Provisions API key** — For telemetry and dashboard access
+5. **Health check** — Verifies everything is running after install
 
-Intelligent LLM routing proxy. Classifies each prompt by task type, filters by model capability, routes to the cheapest model that qualifies.
+## Router
 
-- Hybrid classification: keyword detection (~5ms) + LLM fallback for ambiguous prompts (~200ms)
-- Dynamic thresholds: simple tasks open cheap models (0.60), complex tasks require top models (0.85)
-- 11 models across OpenAI, Anthropic, and Google — routes within your available providers
-- 60-90% cost savings with zero quality loss
-- OpenAI-compatible API on localhost:3838 — change your base_url and you're done
-- OpenClaw compatible — plugin auto-installs, works with API keys and subscriptions
+Transparent proxy on localhost:3838. Your LLM calls pass through, Router selects the cheapest capable model:
 
-```bash
-npx @robot-resources/router
-```
+- Hybrid classification: keyword detection (~5ms) + LLM fallback (~200ms)
+- Dynamic thresholds: simple tasks → cheap models, complex tasks → top models
+- Models across OpenAI, Anthropic, Google — routes within your available providers
+- Your API keys pass through via headers — never stored by Router
+- OpenAI-compatible API — change `base_url` to `http://localhost:3838`
 
-### Scraper
+## Scraper
 
-Token compression for web content. Fetches any URL, strips noise, returns clean markdown with token count.
+Available as MCP tool after install:
 
 - Mozilla Readability extraction (0.97 F1 accuracy)
-- Content-aware token estimation (±15% of actual BPE)
+- Content-aware token estimation
 - 3-tier fetch: fast, stealth (TLS fingerprint), render (headless browser)
 - Multi-page BFS crawl with robots.txt compliance
 - Median 91% token reduction per page
 
-Installed automatically via `npx robot-resources`. Available as MCP tool `scraper_compress_url(url)` in your agent.
+## Agent Compatibility
 
-### Dashboard
+| Agent | Integration | Status |
+|-------|-------------|--------|
+| **OpenClaw** | Plugin (auto-install) | Verified |
+| **Claude Code** | MCP server | Verified |
+| **Any OpenAI client** | HTTP proxy (localhost:3838) | Compatible |
+| **Cursor** | MCP server | Compatible |
+| **Windsurf** | MCP server | Compatible |
 
-Usage dashboard with real-time telemetry. Auth via GitHub OAuth, KPI panels, routing stats, cost savings tracking. Mobile-responsive.
-
-### MCP Servers
-
-Both products include MCP servers for AI agent integration:
+## MCP Servers
 
 ```bash
 npx -y @robot-resources/router-mcp    # Router stats + config
 npx -y @robot-resources/scraper-mcp   # Scraper compression
 ```
 
-## Pricing
-
-Free. Unlimited. No tiers. Both tools run locally — you pay your AI providers directly. No markup, no rate limits, no quotas. Your API keys never leave your machine.
+## Dashboard
 
-## Monorepo Structure
+Usage dashboard at https://robotresources.ai/dashboard — real-time telemetry, cost savings, routing stats. Auth via GitHub OAuth.
 
-```
-robot-resources/
-├── router/         # LLM routing proxy (Python + TypeScript MCP)
-├── scraper/        # Token compression (TypeScript)
-├── web/            # Landing page + dashboard (React/Vite)
-├── platform/       # Backend API — auth, telemetry (Hono/Cloudflare Workers)
-├── packages/       # Unified CLI installer (npx robot-resources)
-├── skills/         # Agent skills (ClawHub)
-├── _orchestrator/  # Business coordination
-└── _brand/         # Brand assets and design system
-```
-
-## Development
-
-Each product has its own setup:
+## Pricing
 
-- [Router](./router/README.md)
-- [Scraper](./scraper/packages/scraper/README.md)
-- [Platform](./platform/README.md)
-- [CLI](./packages/cli/README.md)
+Free. Unlimited. No tiers. Your API keys never leave your machine.
 
-## CI/CD
+## Telemetry
 
-Unified pipeline on push/PR to main:
+Anonymous usage telemetry (model selection, cost savings) to improve the product. No personal data, no request content, no API keys.
 
-- **Router**: ruff, mypy, pytest
-- **Scraper**: tsc, vitest
-- **Web**: tsc, eslint
-- **Publish**: 7 npm packages via OIDC (`router`, `router-mcp`, `scraper`, `scraper-mcp`, `scraper-tracking`, `cli-core`, `cli`)
+Opt out: `export RR_TELEMETRY=off`
 
 ## Links
 
 - Website: https://robotresources.ai
-- GitHub: https://github.com/robot-resources
-- npm: `npx robot-resources`
-- Twitter/X: https://x.com/robotresources
+- Dashboard: https://robotresources.ai/dashboard
+- Agent docs: https://robotresources.ai/llms.txt
+- npm: https://www.npmjs.com/package/robot-resources
+- GitHub: https://github.com/robot-resources/packages
 - Discord: https://robotresources.ai/discord
 - Contact: agent@robotresources.ai
-- Agent docs: https://robotresources.ai/llms.txt
 
 ## License
 

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
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "robot-resources",
-  "version": "1.7.7",
+  "version": "1.7.9",
   "description": "Robot Resources — AI agent tools. One command to install everything.",
   "type": "module",
   "bin": {
@@ -19,7 +19,10 @@
   "dependencies": {
     "@robot-resources/cli-core": "*",
     "@robot-resources/openclaw-plugin": "*",
-    "@robot-resources/scraper": "^0.3.0"
+    "@robot-resources/scraper": "^0.3.1"
+  },
+  "optionalDependencies": {
+    "@robot-resources/router": "*"
   },
   "devDependencies": {
     "vitest": "^1.2.0"
@@ -41,7 +44,7 @@
   "author": "Robot Resources Team",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/robot-resources/robot-resources.git",
+    "url": "git+https://github.com/robot-resources/packages.git",
     "directory": "packages/cli"
   },
   "homepage": "https://robotresources.ai",