@scrappycoco/cli 0.7.0 → 0.8.1

package/README.md

@@ -56,8 +56,9 @@ From a repository checkout, use `npm ci`, `npm run build`, and
 `node dist/index.js <command>` instead.
 
 Discover is optional. Use Run directly when the current capability, provider,
-and native options are already clear. The CLI does not expose legacy
-assistant, agent, workflow, or schedule commands.
+and native options are already clear. The CLI does not expose legacy assistant,
+agent, general workflow, or scheduler commands. For repeated checks, callers
+schedule ordinary Runs and pass each returned cursor into the next Run.
 
 Node.js 20 or newer is required. Interactive use authenticates with Clerk OAuth Authorization Code + PKCE. CI can set `SCRAPPYCOCO_API_KEY`.
 
@@ -72,6 +73,20 @@ Use `--json` for machine-readable responses. Execution commands support
 poll for completion. When `--output` is used, records go to the file and a
 compact execution summary remains on stdout.
 
+Canonical Run request files use `providers` as a top-level array and
+`provider_options` keyed by provider ID:
+
+```json
+{
+  "input": {"query": "unified API for scraping"},
+  "providers": ["exa"],
+  "provider_options": {"exa": {}}
+}
+```
+
+Do not use a singular `provider` field. With flags, use repeatable
+`--provider <id>` instead.
+
 For a long run, add `--detach` to return a job ID immediately, then finish with
 `scrappycoco jobs wait <job-id> --output results.json`. Use
 `scrappycoco jobs get <job-id>` for a single status check or

package/dist/index.js

@@ -1119,6 +1119,12 @@ function splitScraperId(value) {
 }
 async function requestPayload(options, scraperId) {
   const fromFile = options.file ? await readJsonFile(options.file) : {};
+  if ("provider" in fromFile) {
+    throw new CliError(
+      'Run request files use "providers": ["provider_id"] (plural), or pass the repeatable --provider flag.',
+      EXIT.usage
+    );
+  }
   const { source, capability } = splitScraperId(scraperId);
   const input = options.input ? parseJsonObject(options.input, "input JSON") : fromFile.input;
   if (!input) throw new CliError("Provide input through --file or --input.", EXIT.usage);
@@ -1219,7 +1225,7 @@ function executionSummary(response) {
       return route;
     });
   }
-  for (const field of ["cursor", "monitor"]) {
+  for (const field of ["cursor", "snapshot"]) {
     if (summary[field] === null) delete summary[field];
   }
   return summary;
@@ -1391,7 +1397,7 @@ program.command("doctor").description("Check the CLI, authentication, installed
   if (!ok) process.exitCode = authentication.configured ? EXIT.api : EXIT.auth;
 });
 var scrapers = program.command("scrapers", { hidden: true }).description("Legacy scraper commands");
-scrapers.command("list").option("--source <source>", "filter by web, x, reddit, or filings").option("--provider <provider>", "filter by provider implementation").option("--available", "only include available providers").action(async (options, command) => {
+scrapers.command("list").option("--source <source>", "filter by web, x, reddit, instagram, tiktok, or filings").option("--provider <provider>", "filter by provider implementation").option("--available", "only include available providers").action(async (options, command) => {
   const query = new URLSearchParams();
   if (options.source) query.set("source", options.source);
   if (options.provider) query.set("provider", options.provider);
@@ -1409,7 +1415,7 @@ scrapers.command("inspect <scraper-id>").action(async (scraperId, _options, comm
   );
 });
 var catalog = program.command("catalog").description("Inspect capabilities, provider schemas, options, and pricing");
-catalog.command("list").option("--source <source>", "filter by web, x, reddit, or filings").option("--provider <provider>", "filter by provider implementation").option("--available", "only include configured providers; this is not a live health check").option("--full", "include input/output and provider option schemas in JSON output").action(async (options, command) => {
+catalog.command("list").option("--source <source>", "filter by web, x, reddit, instagram, tiktok, or filings").option("--provider <provider>", "filter by provider implementation").option("--available", "only include configured providers; this is not a live health check").option("--full", "include input/output and provider option schemas in JSON output").action(async (options, command) => {
   const query = new URLSearchParams();
   if (options.source) query.set("source", options.source);
   if (options.provider) query.set("provider", options.provider);

package/package.json

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