feat: sync CLI with scrapegraph-js v2 PR #13 head (096c110)

- bump scrapegraph-js to latest PR HEAD (adds monitor.activity, renames SGAI_TIMEOUT_S → SGAI_TIMEOUT, bakes /api/v2 into default base URL)
- add `just-scrape monitor activity --id <id> [--limit] [--cursor]` for paginated tick history
- bridge legacy SGAI_TIMEOUT_S (and JUST_SCRAPE_TIMEOUT_S) to new SGAI_TIMEOUT
- README: document activity command, update default base URL, note SGAI_DEBUG
- bump CLI to v1.0.0 to track SDK v2.0.0

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: VinciGit00

README.md

@@ -78,10 +78,11 @@ Four ways to provide it (checked in order):
 | Variable | Description | Default |
 |---|---|---|
 | `SGAI_API_KEY` | ScrapeGraph API key | — |
-| `SGAI_API_URL` | Override API base URL | `https://api.scrapegraphai.com` |
-| `SGAI_TIMEOUT_S` | Request timeout in seconds | `30` |
+| `SGAI_API_URL` | Override API base URL | `https://api.scrapegraphai.com/api/v2` |
+| `SGAI_TIMEOUT` | Request timeout in seconds | `120` |
+| `SGAI_DEBUG` | Set to `1` to log requests/responses | — |
 
-Legacy variables (`JUST_SCRAPE_API_URL`, `JUST_SCRAPE_TIMEOUT_S`, `JUST_SCRAPE_DEBUG`) are still bridged.
+Legacy variables are still bridged transparently: `JUST_SCRAPE_API_URL` → `SGAI_API_URL`, `JUST_SCRAPE_TIMEOUT_S` / `SGAI_TIMEOUT_S` → `SGAI_TIMEOUT`, `JUST_SCRAPE_DEBUG` → `SGAI_DEBUG`.
 
 ## JSON Mode (`--json`)
 
@@ -272,6 +273,9 @@ just-scrape monitor update --id <id> --interval 2h             # Update interval
 just-scrape monitor pause --id <id>                            # Pause a monitor
 just-scrape monitor resume --id <id>                           # Resume a paused monitor
 just-scrape monitor delete --id <id>                           # Delete a monitor
+just-scrape monitor activity --id <id>                         # Paginated tick history
+just-scrape monitor activity --id <id> --limit 50              # Ticks per page (max 100)
+just-scrape monitor activity --id <id> --cursor <cursor>       # Paginate with a cursor
 ```
 
 ### Examples
@@ -294,6 +298,10 @@ just-scrape monitor list
 # Pause and resume
 just-scrape monitor pause --id abc123
 just-scrape monitor resume --id abc123
+
+# Inspect recent ticks (checks the monitor performed) with their diffs
+just-scrape monitor activity --id abc123 --limit 20
+just-scrape monitor activity --id abc123 --json | jq '.ticks[] | select(.hasChanges == true)'
 ```
 
 ## History

bun.lock

@@ -1,6 +1,6 @@
 {
 	"name": "just-scrape",
-	"version": "0.3.0",
+	"version": "1.0.0",
 	"description": "ScrapeGraph AI CLI tool",
 	"type": "module",
 	"main": "dist/cli.mjs",
@@ -28,7 +28,7 @@
 		"chalk": "^5.4.1",
 		"citty": "^0.1.6",
 		"dotenv": "^17.2.4",
-		"scrapegraph-js": "github:ScrapeGraphAI/scrapegraph-js#0738786"
+		"scrapegraph-js": "github:ScrapeGraphAI/scrapegraph-js#096c110"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^1.9.4",

package.json

@@ -45,7 +45,8 @@ export default defineCommand({
 			.filter(Boolean);
 
 		const formats = requestedFormats.map((f) => {
-			if (f === "markdown" || f === "html") return { type: f as "markdown" | "html", mode: "normal" as const };
+			if (f === "markdown" || f === "html")
+				return { type: f as "markdown" | "html", mode: "normal" as const };
 			return { type: f };
 		});
 

src/commands/crawl.ts

@@ -25,11 +25,7 @@ function label(row: HistoryRow): string {
 	const urlShort = url.length > 50 ? `${url.slice(0, 49)}...` : url;
 
 	const color =
-		status === "completed"
-			? chalk.green
-			: status === "failed"
-				? chalk.red
-				: chalk.yellow;
+		status === "completed" ? chalk.green : status === "failed" ? chalk.red : chalk.yellow;
 
 	return `${chalk.dim(short)}  ${color(status)}  ${urlShort}`;
 }

src/commands/history.ts

@@ -5,10 +5,28 @@ import { monitor } from "scrapegraph-js";
 import { getApiKey } from "../lib/client.js";
 import * as log from "../lib/log.js";
 
-const ACTIONS = ["create", "list", "get", "update", "delete", "pause", "resume"] as const;
+const ACTIONS = [
+	"create",
+	"list",
+	"get",
+	"update",
+	"delete",
+	"pause",
+	"resume",
+	"activity",
+] as const;
 type Action = (typeof ACTIONS)[number];
 
-const FORMATS = ["markdown", "html", "screenshot", "branding", "links", "images", "summary", "json"] as const;
+const FORMATS = [
+	"markdown",
+	"html",
+	"screenshot",
+	"branding",
+	"links",
+	"images",
+	"summary",
+	"json",
+] as const;
 
 export default defineCommand({
 	meta: {
@@ -52,6 +70,14 @@ export default defineCommand({
 			description: "Fetch mode: auto (default), fast, js",
 		},
 		stealth: { type: "boolean", description: "Enable stealth mode" },
+		limit: {
+			type: "string",
+			description: "Ticks per page for activity (max 100)",
+		},
+		cursor: {
+			type: "string",
+			description: "Pagination cursor for activity",
+		},
 		json: { type: "boolean", description: "Output raw JSON (pipeable)" },
 	},
 	run: async ({ args }) => {
@@ -76,7 +102,8 @@ export default defineCommand({
 					.filter(Boolean);
 
 				const formats = requestedFormats.map((f) => {
-					if (f === "markdown" || f === "html") return { type: f as "markdown" | "html", mode: "normal" as const };
+					if (f === "markdown" || f === "html")
+						return { type: f as "markdown" | "html", mode: "normal" as const };
 					return { type: f };
 				});
 
@@ -236,6 +263,27 @@ export default defineCommand({
 				break;
 			}
 
+			case "activity": {
+				if (!args.id) {
+					out.error("--id is required for activity");
+					return;
+				}
+				const params: { limit?: number; cursor?: string } = {};
+				if (args.limit) params.limit = Number(args.limit);
+				if (args.cursor) params.cursor = args.cursor;
+
+				out.start("Fetching monitor activity");
+				try {
+					const result = await monitor.activity(apiKey, args.id, params);
+					out.stop(result.elapsedMs);
+					out.result(result.data);
+				} catch (err) {
+					out.stop(0);
+					out.error(err instanceof Error ? err.message : String(err));
+				}
+				break;
+			}
+
 			default:
 				out.error(`Unknown action: ${action}. Valid: ${ACTIONS.join(", ")}`);
 		}

src/commands/monitor.ts

@@ -10,8 +10,13 @@ if (process.env.JUST_SCRAPE_API_URL && !process.env.SGAI_API_URL)
 
 if (process.env.JUST_SCRAPE_DEBUG === "1" && !process.env.SGAI_DEBUG) process.env.SGAI_DEBUG = "1";
 
-if (process.env.JUST_SCRAPE_TIMEOUT_S && !process.env.SGAI_TIMEOUT_S)
-	process.env.SGAI_TIMEOUT_S = process.env.JUST_SCRAPE_TIMEOUT_S;
+// Bridge legacy JUST_SCRAPE_TIMEOUT_S and SGAI_TIMEOUT_S to the new SGAI_TIMEOUT var
+// (renamed in scrapegraph-js v2; see scrapegraph-js PR #13 / commit 2eba148).
+if (process.env.JUST_SCRAPE_TIMEOUT_S && !process.env.SGAI_TIMEOUT)
+	process.env.SGAI_TIMEOUT = process.env.JUST_SCRAPE_TIMEOUT_S;
+
+if (process.env.SGAI_TIMEOUT_S && !process.env.SGAI_TIMEOUT)
+	process.env.SGAI_TIMEOUT = process.env.SGAI_TIMEOUT_S;
 
 function loadConfigFile(): Record<string, unknown> {
 	if (!existsSync(CONFIG_PATH)) return {};