@scrappycoco/cli 0.2.0 → 0.3.0

package/README.md

@@ -2,15 +2,24 @@
 
 Discover, run, and compare scraper capabilities from a terminal or automation environment.
 
-The npm package must be published before using `npx`. Verify availability with
-`npm view @scrappycoco/cli version`, then run:
+Run the published package directly with `npx`:
 
 ```sh
-npx @scrappycoco/cli auth login
-npx @scrappycoco/cli scrapers list --available --json
-npx @scrappycoco/cli scrapers inspect web.extract_content --json
-npx @scrappycoco/cli scrapers run web.extract_content --file request.json --json
-npx @scrappycoco/cli scrapers compare web.extract_content --file request.json --json
+npx --yes @scrappycoco/cli setup
+```
+
+`setup` opens OAuth in the browser. New users can create an account in that
+flow. After authentication, it installs the public Scrappycoco skill, verifies
+the live catalog, and tells you when to reload or restart your agent.
+
+Individual commands remain available:
+
+```sh
+npx --yes @scrappycoco/cli auth login
+npx --yes @scrappycoco/cli scrapers list --available --json
+npx --yes @scrappycoco/cli scrapers inspect web.extract_content --json
+npx --yes @scrappycoco/cli scrapers run web.extract_content --file request.json --json
+npx --yes @scrappycoco/cli scrapers compare web.extract_content --file request.json --json
 ```
 
 From a repository checkout, use `npm ci`, `npm run build`, and

package/dist/index.js

@@ -2,6 +2,7 @@
 
 // src/index.ts
 import { randomUUID as randomUUID2 } from "crypto";
+import { readFileSync } from "fs";
 import { Command, CommanderError, Option } from "commander";
 
 // src/auth.ts
@@ -366,9 +367,114 @@ function errorPayload(error) {
   return { error: error.message, details: error.details ?? null };
 }
 
+// src/setup.ts
+import { spawn } from "child_process";
+var SKILL_SOURCE = "https://scrappycoco.ai";
+var SKILL_INSTALL_ARGS = [
+  "--yes",
+  "skills",
+  "add",
+  SKILL_SOURCE,
+  "--skill",
+  "scrappycoco",
+  "-g",
+  "-y"
+];
+function npxCommand() {
+  return process.platform === "win32" ? "npx.cmd" : "npx";
+}
+function skillInstallInvocation() {
+  return { command: npxCommand(), args: SKILL_INSTALL_ARGS };
+}
+function runCommand(command, args) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, [...args], {
+      stdio: ["ignore", "pipe", "pipe"],
+      windowsHide: true
+    });
+    child.stdout.on("data", (chunk) => process.stderr.write(chunk));
+    child.stderr.on("data", (chunk) => process.stderr.write(chunk));
+    child.on("error", (error) => reject(
+      new CliError(`Could not start the skill installer: ${error.message}`, EXIT.api)
+    ));
+    child.on("close", (code) => {
+      if (code === 0) {
+        resolve();
+        return;
+      }
+      reject(new CliError(
+        `Skill installation failed with exit code ${code ?? "unknown"}.`,
+        EXIT.api
+      ));
+    });
+  });
+}
+async function installSkill(runner = runCommand) {
+  const invocation = skillInstallInvocation();
+  await runner(invocation.command, invocation.args);
+}
+function defaultDependencies(apiUrl) {
+  const client2 = new ApiClient(apiUrl);
+  return {
+    hasApiKey: () => Boolean(process.env.SCRAPPYCOCO_API_KEY),
+    clearRefreshToken,
+    loadRefreshToken,
+    login,
+    installSkill,
+    listAvailableScrapers: () => client2.get("/scrapers?available_only=true")
+  };
+}
+async function performSetup(options, dependencies = defaultDependencies(options.apiUrl)) {
+  const usingApiKey = dependencies.hasApiKey();
+  let authentication = usingApiKey ? "api_key" : "oauth";
+  let credentialStorage = usingApiKey ? "environment" : "existing";
+  const hadStoredToken = !usingApiKey && Boolean(await dependencies.loadRefreshToken());
+  if (!usingApiKey && !hadStoredToken) {
+    const authenticated = await dependencies.login({
+      apiUrl: options.apiUrl,
+      noBrowser: options.noBrowser
+    });
+    authentication = "oauth";
+    credentialStorage = authenticated.storage;
+  }
+  let catalog;
+  try {
+    catalog = await dependencies.listAvailableScrapers();
+  } catch (error) {
+    if (usingApiKey || !hadStoredToken || !(error instanceof CliError) || error.exitCode !== EXIT.auth) {
+      throw error;
+    }
+    await dependencies.clearRefreshToken();
+    const authenticated = await dependencies.login({
+      apiUrl: options.apiUrl,
+      noBrowser: options.noBrowser
+    });
+    credentialStorage = authenticated.storage;
+    catalog = await dependencies.listAvailableScrapers();
+  }
+  await dependencies.installSkill();
+  return {
+    authenticated: true,
+    authentication,
+    credential_storage: credentialStorage,
+    skill: {
+      installed: true,
+      source: SKILL_SOURCE
+    },
+    verification: {
+      catalog_reachable: true,
+      available_capabilities: catalog.length
+    },
+    next_step: "Reload or restart your agent, then ask it to list available Scrappycoco scrapers."
+  };
+}
+
 // src/index.ts
+var packageMetadata = JSON.parse(
+  readFileSync(new URL("../package.json", import.meta.url), "utf8")
+);
 var program = new Command();
-program.name("scrappycoco").description("Discover, run, and compare scraper capabilities through one API").version("0.1.0").option("--json", "emit machine-readable JSON to stdout").option("--api-url <url>", "API base URL", process.env.SCRAPPYCOCO_API_URL || "https://api.scrappycoco.ai").showHelpAfterError().exitOverride();
+program.name("scrappycoco").description("Discover, run, and compare scraper capabilities through one API").version(packageMetadata.version).option("--json", "emit machine-readable JSON to stdout").option("--api-url <url>", "API base URL", process.env.SCRAPPYCOCO_API_URL || "https://api.scrappycoco.ai").showHelpAfterError().exitOverride();
 function globals(command) {
   return command.optsWithGlobals();
 }
@@ -378,6 +484,13 @@ function client(command) {
 function collect(value, previous) {
   return [...previous, value];
 }
+program.command("setup").description("Authenticate, install the Scrappycoco skill, and verify the connection").option("--no-browser", "print the authorization URL without opening it").action(async (options, command) => {
+  const result = await performSetup({
+    apiUrl: globals(command).apiUrl,
+    noBrowser: options.browser === false
+  });
+  await emit(result, globals(command).json || false);
+});
 function splitScraperId(value) {
   const separator = value.indexOf(".");
   if (separator <= 0 || separator === value.length - 1) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scrappycoco/cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "CLI for Scrappycoco scraper discovery, execution, and provider comparison",
   "type": "module",
   "bin": {