mcp-scraper 0.2.19 → 0.2.21

package/dist/chunk-DUEW4EOO.js

@@ -0,0 +1,214 @@
+// src/lib/chrome-profiles.ts
+import { readFile } from "fs/promises";
+import { homedir } from "os";
+import { join } from "path";
+function defaultChromeUserDataDir() {
+  if (process.platform === "darwin") return join(homedir(), "Library", "Application Support", "Google", "Chrome");
+  if (process.platform === "win32") {
+    return join(process.env.LOCALAPPDATA ?? join(homedir(), "AppData", "Local"), "Google", "Chrome", "User Data");
+  }
+  return join(process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), "google-chrome");
+}
+function recommendedKernelProfileName(value) {
+  return value.trim().toLowerCase().replace(/@/g, "-").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80) || "browser-profile";
+}
+async function listLocalChromeProfiles(userDataDir = defaultChromeUserDataDir(), emailFilter) {
+  const raw = await readFile(join(userDataDir, "Local State"), "utf8");
+  const localState = JSON.parse(raw);
+  const wanted = emailFilter?.trim().toLowerCase();
+  return Object.entries(localState.profile?.info_cache ?? {}).map(([directory, info]) => {
+    const email = (info.user_name ?? "").trim();
+    const displayName = (info.name ?? info.shortcut_name ?? "").trim();
+    const labelSource = email || displayName || directory;
+    return {
+      email,
+      displayName,
+      chromeProfileDirectory: directory,
+      chromeProfilePath: join(userDataDir, directory),
+      recommendedKernelProfileName: recommendedKernelProfileName(labelSource)
+    };
+  }).filter((row) => !wanted || row.email.toLowerCase() === wanted || row.displayName.toLowerCase().includes(wanted));
+}
+
+// src/lib/local-browser-profiles.ts
+import { existsSync } from "fs";
+import { cp, mkdir, readFile as readFile2, rm, stat, writeFile } from "fs/promises";
+import { homedir as homedir2 } from "os";
+import { join as join2, relative, sep } from "path";
+var EXCLUDED_PROFILE_NAMES = [
+  "Cache",
+  "Code Cache",
+  "Crashpad",
+  "DawnCache",
+  "DawnGraphiteCache",
+  "DawnWebGPUCache",
+  "GPUCache",
+  "GrShaderCache",
+  "ShaderCache",
+  "Shared Dictionary"
+];
+function defaultImportedBrowserProfilesDir() {
+  return process.env.MCP_SCRAPER_BROWSER_PROFILE_BASE_DIR?.trim() || join2(homedir2(), ".mcp-scraper", "browser-profiles");
+}
+function defaultChromeExecutablePath() {
+  const envPath = process.env.MCP_SCRAPER_BROWSER_EXECUTABLE?.trim() || process.env.CHROME_PATH?.trim();
+  if (envPath) return envPath;
+  const candidates = process.platform === "darwin" ? ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"] : process.platform === "win32" ? [
+    join2(process.env.PROGRAMFILES ?? "C:\\Program Files", "Google", "Chrome", "Application", "chrome.exe"),
+    join2(process.env["PROGRAMFILES(X86)"] ?? "C:\\Program Files (x86)", "Google", "Chrome", "Application", "chrome.exe")
+  ] : ["/usr/bin/google-chrome", "/usr/bin/google-chrome-stable", "/usr/bin/chromium-browser", "/usr/bin/chromium"];
+  return candidates.find((candidate) => existsSync(candidate));
+}
+function localBrowserModeEnabled() {
+  return process.env.MCP_SCRAPER_BROWSER_MODE?.trim().toLowerCase() === "local";
+}
+function importedProfileName(value) {
+  return recommendedKernelProfileName(value);
+}
+function importedProfileRoot(name, outputDir = defaultImportedBrowserProfilesDir()) {
+  return join2(outputDir, importedProfileName(name));
+}
+function importedProfileManifestPath(name, outputDir = defaultImportedBrowserProfilesDir()) {
+  return join2(importedProfileRoot(name, outputDir), "manifest.json");
+}
+function importedProfileUserDataDir(name, outputDir = defaultImportedBrowserProfilesDir()) {
+  return join2(importedProfileRoot(name, outputDir), "user-data");
+}
+async function readExistingManifest(path) {
+  try {
+    return JSON.parse(await readFile2(path, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function isExcludedProfilePath(sourceRoot, sourcePath) {
+  const rel = relative(sourceRoot, sourcePath);
+  if (!rel) return false;
+  const parts = rel.split(sep).filter(Boolean);
+  const last = parts[parts.length - 1] ?? "";
+  if (last.startsWith("Singleton")) return true;
+  if (last === "LOCK" || last.endsWith(".lock")) return true;
+  if (parts.some((part) => EXCLUDED_PROFILE_NAMES.includes(part))) return true;
+  if (parts.includes("Service Worker") && parts.includes("CacheStorage")) return true;
+  return false;
+}
+async function copyProfileTree(sourceProfilePath, destinationProfilePath) {
+  await cp(sourceProfilePath, destinationProfilePath, {
+    recursive: true,
+    force: true,
+    errorOnExist: false,
+    dereference: false,
+    filter: (source) => !isExcludedProfilePath(sourceProfilePath, source)
+  });
+}
+function selectProfile(profiles, options) {
+  const requestedDirectory = options.chromeProfileDirectory?.trim();
+  const requestedEmail = options.email?.trim().toLowerCase();
+  const exactDirectory = requestedDirectory ? profiles.find((profile) => profile.chromeProfileDirectory === requestedDirectory) : void 0;
+  if (exactDirectory) return exactDirectory;
+  const exactEmail = requestedEmail ? profiles.find((profile) => profile.email.toLowerCase() === requestedEmail) : void 0;
+  if (exactEmail) return exactEmail;
+  const first = profiles[0];
+  if (first) return first;
+  const hint = requestedDirectory ? `Chrome profile directory "${requestedDirectory}"` : requestedEmail ? `Chrome account "${requestedEmail}"` : "Chrome profile";
+  throw new Error(`${hint} was not found in ${options.sourceUserDataDir ?? defaultChromeUserDataDir()}`);
+}
+async function ensureProfilePathExists(profile) {
+  const details = await stat(profile.chromeProfilePath).catch(() => null);
+  if (!details?.isDirectory()) {
+    throw new Error(`Chrome profile path does not exist or is not a directory: ${profile.chromeProfilePath}`);
+  }
+}
+async function writeNormalizedLocalState(sourceLocalStatePath, destinationLocalStatePath, sourceProfileDirectory) {
+  const raw = await readFile2(sourceLocalStatePath, "utf8");
+  const localState = JSON.parse(raw);
+  const selectedInfo = localState.profile?.info_cache?.[sourceProfileDirectory] ?? localState.profile?.info_cache?.Default ?? {};
+  localState.profile = {
+    ...localState.profile ?? {},
+    info_cache: { Default: selectedInfo },
+    last_used: "Default",
+    last_active_profiles: ["Default"]
+  };
+  await writeFile(destinationLocalStatePath, `${JSON.stringify(localState, null, 2)}
+`);
+}
+async function importChromeProfile(options = {}) {
+  const sourceUserDataDir = options.sourceUserDataDir?.trim() || defaultChromeUserDataDir();
+  const profiles = await listLocalChromeProfiles(sourceUserDataDir, options.email);
+  const sourceProfile = selectProfile(profiles, { ...options, sourceUserDataDir });
+  await ensureProfilePathExists(sourceProfile);
+  const name = importedProfileName(options.name?.trim() || sourceProfile.recommendedKernelProfileName);
+  const outputDir = options.outputDir?.trim() || defaultImportedBrowserProfilesDir();
+  const profileRoot = importedProfileRoot(name, outputDir);
+  const manifestPath = importedProfileManifestPath(name, outputDir);
+  const userDataDir = importedProfileUserDataDir(name, outputDir);
+  const existingManifest = await readExistingManifest(manifestPath);
+  const existing = existsSync(profileRoot);
+  if (existing && !options.overwrite) {
+    throw new Error(`Imported browser profile "${name}" already exists at ${profileRoot}. Re-run with --overwrite to refresh it.`);
+  }
+  if (existing) await rm(profileRoot, { recursive: true, force: true });
+  await mkdir(join2(userDataDir, "Default"), { recursive: true });
+  await writeNormalizedLocalState(
+    join2(sourceUserDataDir, "Local State"),
+    join2(userDataDir, "Local State"),
+    sourceProfile.chromeProfileDirectory
+  );
+  await copyProfileTree(sourceProfile.chromeProfilePath, join2(userDataDir, "Default"));
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const manifest = {
+    layoutVersion: 1,
+    name,
+    profileRoot,
+    userDataDir,
+    browserExecutablePath: options.browserExecutablePath?.trim() || defaultChromeExecutablePath() || null,
+    sourceUserDataDir,
+    sourceProfileDirectory: sourceProfile.chromeProfileDirectory,
+    sourceProfilePath: sourceProfile.chromeProfilePath,
+    email: sourceProfile.email,
+    displayName: sourceProfile.displayName,
+    createdAt: existingManifest?.createdAt ?? now,
+    updatedAt: now,
+    copyMode: "chrome-profile-clone"
+  };
+  await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}
+`);
+  return {
+    profile: manifest,
+    sourceProfile,
+    excludedNames: EXCLUDED_PROFILE_NAMES
+  };
+}
+async function loadImportedBrowserProfile(name = process.env.MCP_SCRAPER_BROWSER_PROFILE?.trim() || "default", outputDir = defaultImportedBrowserProfilesDir()) {
+  const profileName = importedProfileName(name);
+  const manifestPath = importedProfileManifestPath(profileName, outputDir);
+  const manifest = await readExistingManifest(manifestPath);
+  if (!manifest) {
+    throw new Error(
+      `Imported browser profile "${profileName}" was not found. Run: mcp-scraper-cli browser import-chrome --name ${profileName}`
+    );
+  }
+  return manifest;
+}
+async function syncImportedChromeProfile(name, options = {}) {
+  const outputDir = options.outputDir?.trim() || defaultImportedBrowserProfilesDir();
+  const manifest = await loadImportedBrowserProfile(name, outputDir);
+  return importChromeProfile({
+    name: manifest.name,
+    sourceUserDataDir: manifest.sourceUserDataDir,
+    chromeProfileDirectory: manifest.sourceProfileDirectory,
+    outputDir,
+    overwrite: true,
+    browserExecutablePath: options.browserExecutablePath ?? manifest.browserExecutablePath ?? void 0
+  });
+}
+
+export {
+  listLocalChromeProfiles,
+  defaultChromeExecutablePath,
+  localBrowserModeEnabled,
+  importChromeProfile,
+  loadImportedBrowserProfile,
+  syncImportedChromeProfile
+};
+//# sourceMappingURL=chunk-DUEW4EOO.js.map

package/dist/chunk-DUEW4EOO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/chrome-profiles.ts","../src/lib/local-browser-profiles.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport interface LocalChromeProfile {\n  email: string\n  displayName: string\n  chromeProfileDirectory: string\n  chromeProfilePath: string\n  recommendedKernelProfileName: string\n}\n\nexport function defaultChromeUserDataDir(): string {\n  if (process.platform === 'darwin') return join(homedir(), 'Library', 'Application Support', 'Google', 'Chrome')\n  if (process.platform === 'win32') {\n    return join(process.env.LOCALAPPDATA ?? join(homedir(), 'AppData', 'Local'), 'Google', 'Chrome', 'User Data')\n  }\n  return join(process.env.XDG_CONFIG_HOME ?? join(homedir(), '.config'), 'google-chrome')\n}\n\nexport function recommendedKernelProfileName(value: string): string {\n  return value\n    .trim()\n    .toLowerCase()\n    .replace(/@/g, '-')\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '')\n    .slice(0, 80) || 'browser-profile'\n}\n\nexport async function listLocalChromeProfiles(\n  userDataDir = defaultChromeUserDataDir(),\n  emailFilter?: string,\n): Promise<LocalChromeProfile[]> {\n  const raw = await readFile(join(userDataDir, 'Local State'), 'utf8')\n  const localState = JSON.parse(raw) as {\n    profile?: {\n      info_cache?: Record<string, {\n        name?: string\n        shortcut_name?: string\n        user_name?: string\n        gaia_name?: string\n      }>\n    }\n  }\n  const wanted = emailFilter?.trim().toLowerCase()\n  return Object.entries(localState.profile?.info_cache ?? {})\n    .map(([directory, info]) => {\n      const email = (info.user_name ?? '').trim()\n      const displayName = (info.name ?? info.shortcut_name ?? '').trim()\n      const labelSource = email || displayName || directory\n      return {\n        email,\n        displayName,\n        chromeProfileDirectory: directory,\n        chromeProfilePath: join(userDataDir, directory),\n        recommendedKernelProfileName: recommendedKernelProfileName(labelSource),\n      }\n    })\n    .filter(row => !wanted || row.email.toLowerCase() === wanted || row.displayName.toLowerCase().includes(wanted))\n}\n","import { existsSync } from 'node:fs'\nimport { cp, mkdir, readFile, rm, stat, writeFile } from 'node:fs/promises'\nimport { homedir } from 'node:os'\nimport { join, relative, sep } from 'node:path'\nimport {\n  defaultChromeUserDataDir,\n  listLocalChromeProfiles,\n  recommendedKernelProfileName,\n  type LocalChromeProfile,\n} from './chrome-profiles.js'\n\nexport interface ImportedBrowserProfileManifest {\n  layoutVersion: 1\n  name: string\n  profileRoot: string\n  userDataDir: string\n  browserExecutablePath: string | null\n  sourceUserDataDir: string\n  sourceProfileDirectory: string\n  sourceProfilePath: string\n  email: string\n  displayName: string\n  createdAt: string\n  updatedAt: string\n  copyMode: 'chrome-profile-clone'\n}\n\nexport interface ImportChromeProfileOptions {\n  email?: string\n  name?: string\n  chromeProfileDirectory?: string\n  sourceUserDataDir?: string\n  outputDir?: string\n  overwrite?: boolean\n  browserExecutablePath?: string\n}\n\nexport interface ImportChromeProfileResult {\n  profile: ImportedBrowserProfileManifest\n  sourceProfile: LocalChromeProfile\n  excludedNames: string[]\n}\n\nconst EXCLUDED_PROFILE_NAMES = [\n  'Cache',\n  'Code Cache',\n  'Crashpad',\n  'DawnCache',\n  'DawnGraphiteCache',\n  'DawnWebGPUCache',\n  'GPUCache',\n  'GrShaderCache',\n  'ShaderCache',\n  'Shared Dictionary',\n]\n\nexport function defaultImportedBrowserProfilesDir(): string {\n  return process.env.MCP_SCRAPER_BROWSER_PROFILE_BASE_DIR?.trim()\n    || join(homedir(), '.mcp-scraper', 'browser-profiles')\n}\n\nexport function defaultChromeExecutablePath(): string | undefined {\n  const envPath = process.env.MCP_SCRAPER_BROWSER_EXECUTABLE?.trim() || process.env.CHROME_PATH?.trim()\n  if (envPath) return envPath\n\n  const candidates = process.platform === 'darwin'\n    ? ['/Applications/Google Chrome.app/Contents/MacOS/Google Chrome']\n    : process.platform === 'win32'\n      ? [\n          join(process.env.PROGRAMFILES ?? 'C:\\\\Program Files', 'Google', 'Chrome', 'Application', 'chrome.exe'),\n          join(process.env['PROGRAMFILES(X86)'] ?? 'C:\\\\Program Files (x86)', 'Google', 'Chrome', 'Application', 'chrome.exe'),\n        ]\n      : ['/usr/bin/google-chrome', '/usr/bin/google-chrome-stable', '/usr/bin/chromium-browser', '/usr/bin/chromium']\n\n  return candidates.find(candidate => existsSync(candidate))\n}\n\nexport function localBrowserModeEnabled(): boolean {\n  return process.env.MCP_SCRAPER_BROWSER_MODE?.trim().toLowerCase() === 'local'\n}\n\nexport function importedProfileName(value: string): string {\n  return recommendedKernelProfileName(value)\n}\n\nexport function importedProfileRoot(name: string, outputDir = defaultImportedBrowserProfilesDir()): string {\n  return join(outputDir, importedProfileName(name))\n}\n\nexport function importedProfileManifestPath(name: string, outputDir = defaultImportedBrowserProfilesDir()): string {\n  return join(importedProfileRoot(name, outputDir), 'manifest.json')\n}\n\nexport function importedProfileUserDataDir(name: string, outputDir = defaultImportedBrowserProfilesDir()): string {\n  return join(importedProfileRoot(name, outputDir), 'user-data')\n}\n\nasync function readExistingManifest(path: string): Promise<ImportedBrowserProfileManifest | null> {\n  try {\n    return JSON.parse(await readFile(path, 'utf8')) as ImportedBrowserProfileManifest\n  } catch {\n    return null\n  }\n}\n\nfunction isExcludedProfilePath(sourceRoot: string, sourcePath: string): boolean {\n  const rel = relative(sourceRoot, sourcePath)\n  if (!rel) return false\n  const parts = rel.split(sep).filter(Boolean)\n  const last = parts[parts.length - 1] ?? ''\n  if (last.startsWith('Singleton')) return true\n  if (last === 'LOCK' || last.endsWith('.lock')) return true\n  if (parts.some(part => EXCLUDED_PROFILE_NAMES.includes(part))) return true\n  if (parts.includes('Service Worker') && parts.includes('CacheStorage')) return true\n  return false\n}\n\nasync function copyProfileTree(sourceProfilePath: string, destinationProfilePath: string): Promise<void> {\n  await cp(sourceProfilePath, destinationProfilePath, {\n    recursive: true,\n    force: true,\n    errorOnExist: false,\n    dereference: false,\n    filter: source => !isExcludedProfilePath(sourceProfilePath, source),\n  })\n}\n\nfunction selectProfile(profiles: LocalChromeProfile[], options: ImportChromeProfileOptions): LocalChromeProfile {\n  const requestedDirectory = options.chromeProfileDirectory?.trim()\n  const requestedEmail = options.email?.trim().toLowerCase()\n  const exactDirectory = requestedDirectory\n    ? profiles.find(profile => profile.chromeProfileDirectory === requestedDirectory)\n    : undefined\n  if (exactDirectory) return exactDirectory\n\n  const exactEmail = requestedEmail\n    ? profiles.find(profile => profile.email.toLowerCase() === requestedEmail)\n    : undefined\n  if (exactEmail) return exactEmail\n\n  const first = profiles[0]\n  if (first) return first\n\n  const hint = requestedDirectory\n    ? `Chrome profile directory \"${requestedDirectory}\"`\n    : requestedEmail\n      ? `Chrome account \"${requestedEmail}\"`\n      : 'Chrome profile'\n  throw new Error(`${hint} was not found in ${options.sourceUserDataDir ?? defaultChromeUserDataDir()}`)\n}\n\nasync function ensureProfilePathExists(profile: LocalChromeProfile): Promise<void> {\n  const details = await stat(profile.chromeProfilePath).catch(() => null)\n  if (!details?.isDirectory()) {\n    throw new Error(`Chrome profile path does not exist or is not a directory: ${profile.chromeProfilePath}`)\n  }\n}\n\nasync function writeNormalizedLocalState(\n  sourceLocalStatePath: string,\n  destinationLocalStatePath: string,\n  sourceProfileDirectory: string,\n): Promise<void> {\n  const raw = await readFile(sourceLocalStatePath, 'utf8')\n  const localState = JSON.parse(raw) as {\n    profile?: {\n      info_cache?: Record<string, unknown>\n      last_used?: string\n      last_active_profiles?: string[]\n    }\n  }\n  const selectedInfo = localState.profile?.info_cache?.[sourceProfileDirectory]\n    ?? localState.profile?.info_cache?.Default\n    ?? {}\n  localState.profile = {\n    ...(localState.profile ?? {}),\n    info_cache: { Default: selectedInfo },\n    last_used: 'Default',\n    last_active_profiles: ['Default'],\n  }\n  await writeFile(destinationLocalStatePath, `${JSON.stringify(localState, null, 2)}\\n`)\n}\n\nexport async function importChromeProfile(options: ImportChromeProfileOptions = {}): Promise<ImportChromeProfileResult> {\n  const sourceUserDataDir = options.sourceUserDataDir?.trim() || defaultChromeUserDataDir()\n  const profiles = await listLocalChromeProfiles(sourceUserDataDir, options.email)\n  const sourceProfile = selectProfile(profiles, { ...options, sourceUserDataDir })\n  await ensureProfilePathExists(sourceProfile)\n\n  const name = importedProfileName(options.name?.trim() || sourceProfile.recommendedKernelProfileName)\n  const outputDir = options.outputDir?.trim() || defaultImportedBrowserProfilesDir()\n  const profileRoot = importedProfileRoot(name, outputDir)\n  const manifestPath = importedProfileManifestPath(name, outputDir)\n  const userDataDir = importedProfileUserDataDir(name, outputDir)\n  const existingManifest = await readExistingManifest(manifestPath)\n  const existing = existsSync(profileRoot)\n\n  if (existing && !options.overwrite) {\n    throw new Error(`Imported browser profile \"${name}\" already exists at ${profileRoot}. Re-run with --overwrite to refresh it.`)\n  }\n\n  if (existing) await rm(profileRoot, { recursive: true, force: true })\n  await mkdir(join(userDataDir, 'Default'), { recursive: true })\n  await writeNormalizedLocalState(\n    join(sourceUserDataDir, 'Local State'),\n    join(userDataDir, 'Local State'),\n    sourceProfile.chromeProfileDirectory,\n  )\n  await copyProfileTree(sourceProfile.chromeProfilePath, join(userDataDir, 'Default'))\n\n  const now = new Date().toISOString()\n  const manifest: ImportedBrowserProfileManifest = {\n    layoutVersion: 1,\n    name,\n    profileRoot,\n    userDataDir,\n    browserExecutablePath: options.browserExecutablePath?.trim() || defaultChromeExecutablePath() || null,\n    sourceUserDataDir,\n    sourceProfileDirectory: sourceProfile.chromeProfileDirectory,\n    sourceProfilePath: sourceProfile.chromeProfilePath,\n    email: sourceProfile.email,\n    displayName: sourceProfile.displayName,\n    createdAt: existingManifest?.createdAt ?? now,\n    updatedAt: now,\n    copyMode: 'chrome-profile-clone',\n  }\n  await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\\n`)\n\n  return {\n    profile: manifest,\n    sourceProfile,\n    excludedNames: EXCLUDED_PROFILE_NAMES,\n  }\n}\n\nexport async function loadImportedBrowserProfile(\n  name = process.env.MCP_SCRAPER_BROWSER_PROFILE?.trim() || 'default',\n  outputDir = defaultImportedBrowserProfilesDir(),\n): Promise<ImportedBrowserProfileManifest> {\n  const profileName = importedProfileName(name)\n  const manifestPath = importedProfileManifestPath(profileName, outputDir)\n  const manifest = await readExistingManifest(manifestPath)\n  if (!manifest) {\n    throw new Error(\n      `Imported browser profile \"${profileName}\" was not found. Run: mcp-scraper-cli browser import-chrome --name ${profileName}`,\n    )\n  }\n  return manifest\n}\n\nexport async function syncImportedChromeProfile(\n  name: string,\n  options: Pick<ImportChromeProfileOptions, 'outputDir' | 'browserExecutablePath'> = {},\n): Promise<ImportChromeProfileResult> {\n  const outputDir = options.outputDir?.trim() || defaultImportedBrowserProfilesDir()\n  const manifest = await loadImportedBrowserProfile(name, outputDir)\n  return importChromeProfile({\n    name: manifest.name,\n    sourceUserDataDir: manifest.sourceUserDataDir,\n    chromeProfileDirectory: manifest.sourceProfileDirectory,\n    outputDir,\n    overwrite: true,\n    browserExecutablePath: options.browserExecutablePath ?? manifest.browserExecutablePath ?? undefined,\n  })\n}\n"],"mappings":"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","names":["readFile","homedir","join","join","homedir","readFile"]}

package/dist/{chunk-F44RBOJ5.js → chunk-H2R232HK.js}

@@ -1,3 +1,7 @@
+import {
+  DEFAULT_MAPS_PROXY_MODE
+} from "./chunk-LFATOGDF.js";
+
 // src/workflows/artifact-writer.ts
 import { mkdir, readFile, stat, writeFile } from "fs/promises";
 import { existsSync } from "fs";
@@ -206,6 +210,7 @@ async function openWorkflowReport(id, outputDir) {
 }
 
 // src/workflows/registry.ts
+import { readFile as readFile2 } from "fs/promises";
 import { z as z5 } from "zod";
 
 // src/workflows/http-client.ts
@@ -387,102 +392,141 @@ var agentPacketWorkflowDefinition = {
   title: "Agent-Ready SEO Packet",
   description: "Create an evidence folder for AI agents from live SERP/PAA/AI search surfaces.",
   inputSchema: AgentPacketInputSchema,
-  async run(input, ctx) {
-    await ctx.artifacts.writeManifest("running", {}, [], []);
-    const warnings = [];
-    const errors = [];
-    let serp = null;
-    let paa = null;
-    if (input.includeSerp) {
-      try {
-        serp = await ctx.client.post("/harvest/sync", {
-          query: input.keyword,
-          location: input.location,
-          serpOnly: true,
-          maxQuestions: 1,
-          format: "json"
-        }, 18e4);
-      } catch (err) {
-        warnings.push(`SERP evidence unavailable: ${err instanceof Error ? err.message : String(err)}`);
+  createState: () => ({ serp: null, paa: null, warnings: [] }),
+  steps: [
+    {
+      id: "harvest-serp",
+      title: "Harvest organic SERP + AI Overview",
+      async run({ input, state, ctx }) {
+        if (!input.includeSerp) {
+          return { state, output: { skipped: true, reason: "includeSerp is false" } };
+        }
+        try {
+          const serp = await ctx.client.post("/harvest/sync", {
+            query: input.keyword,
+            location: input.location,
+            serpOnly: true,
+            maxQuestions: 1,
+            format: "json"
+          }, 18e4);
+          await ctx.artifacts.writeJson("SERP raw JSON", "raw/serp.json", serp);
+          return {
+            state: { ...state, serp },
+            output: {
+              organicResults: serp.organicResults?.length ?? 0,
+              localPack: serp.localPack?.length ?? 0,
+              aiOverviewDetected: Boolean(serp.aiOverview?.detected),
+              aiOverviewCitations: serp.aiOverview?.citations?.length ?? 0
+            }
+          };
+        } catch (err) {
+          const message = `SERP evidence unavailable: ${err instanceof Error ? err.message : String(err)}`;
+          return { state: { ...state, warnings: [...state.warnings, message] }, output: { error: message }, warnings: [message] };
+        }
       }
-    }
-    if (input.includePaa) {
-      try {
-        paa = await ctx.client.post("/harvest/sync", {
-          query: input.keyword,
-          location: input.location,
-          maxQuestions: input.maxQuestions,
-          format: "json"
-        }, 28e4);
-      } catch (err) {
-        warnings.push(`PAA evidence unavailable: ${err instanceof Error ? err.message : String(err)}`);
+    },
+    {
+      id: "harvest-paa",
+      title: "Harvest People Also Ask",
+      async run({ input, state, ctx }) {
+        if (!input.includePaa) {
+          return { state, output: { skipped: true, reason: "includePaa is false" } };
+        }
+        try {
+          const paa = await ctx.client.post("/harvest/sync", {
+            query: input.keyword,
+            location: input.location,
+            maxQuestions: input.maxQuestions,
+            format: "json"
+          }, 28e4);
+          await ctx.artifacts.writeJson("PAA raw JSON", "raw/paa.json", paa);
+          return {
+            state: { ...state, paa },
+            output: { paaQuestions: paa.flat?.length ?? 0 }
+          };
+        } catch (err) {
+          const message = `PAA evidence unavailable: ${err instanceof Error ? err.message : String(err)}`;
+          return { state: { ...state, warnings: [...state.warnings, message] }, output: { error: message }, warnings: [message] };
+        }
+      }
+    },
+    {
+      id: "assemble",
+      title: "Assemble evidence packet",
+      async run({ input, state, ctx }) {
+        const { serp, paa } = state;
+        const warnings = state.warnings;
+        if (!serp && !paa && !input.returnPartial) throw new Error("No SEO evidence was collected");
+        const rows = sourceRows(input, serp, paa);
+        const target = normalizeDomain(input.domain);
+        const competitors = competitorRows(rows, target);
+        const evidence = {
+          input,
+          serp: serp ?? { status: "skipped" },
+          paa: paa ?? { status: "skipped" },
+          target: {
+            domain: target,
+            organicPositions: rows.filter((r) => r.surface === "organic" && r.is_target).map((r) => Number(r.position)),
+            citedInAiOverview: rows.some((r) => r.surface === "ai_overview" && r.is_target),
+            citedInPaa: rows.some((r) => r.surface === "paa" && r.is_target)
+          },
+          competitors,
+          warnings
+        };
+        await ctx.artifacts.writeJson("Evidence JSON", "evidence.json", evidence);
+        await ctx.artifacts.writeCsv("Sources CSV", "sources.csv", ["surface", "position", "title", "url", "domain", "question", "answer_excerpt", "is_target", "is_competitor"], rows);
+        await ctx.artifacts.writeCsv("Competitors CSV", "competitors.csv", ["domain", "organic_best_position", "organic_count", "paa_mentions", "ai_overview_citations", "source_url_count"], competitors);
+        const brief = [
+          `# SEO Evidence Brief: ${input.keyword}`,
+          "",
+          `Location: ${input.location ?? "not specified"}`,
+          `Target domain: ${target ?? "not specified"}`,
+          "",
+          "## Evidence Summary",
+          `- Organic rows: ${rows.filter((r) => r.surface === "organic").length}`,
+          `- PAA rows: ${rows.filter((r) => r.surface === "paa").length}`,
+          `- AI Overview citations: ${rows.filter((r) => r.surface === "ai_overview").length}`,
+          `- Competitor domains: ${competitors.length}`,
+          "",
+          "## Recommended Use",
+          "Use the CSV files as source of truth. Tie content recommendations to evidence rows and mark unsupported ideas as assumptions."
+        ].join("\n");
+        await ctx.artifacts.writeText("Brief", "brief.md", brief);
+        await ctx.artifacts.writeText("Agent tasks", "tasks.md", [
+          "# Agent Tasks",
+          "",
+          "- [ ] Read `evidence.json` before writing recommendations.",
+          "- [ ] Compare the target domain against `competitors.csv`.",
+          "- [ ] Use `sources.csv` for citations and source-grounded page sections.",
+          "- [ ] Mark unsupported recommendations as assumptions."
+        ].join("\n"));
+        await ctx.artifacts.writeText("Agent instructions", "agent-instructions.md", [
+          "# Agent Instructions",
+          "",
+          "You are working from an MCP Scraper SEO evidence packet. Use `evidence.json` and CSV files as source of truth. Do not invent citations. If a recommendation is not supported by evidence, mark it as an assumption."
+        ].join("\n"));
+        const summary = `${rows.length} evidence rows and ${competitors.length} competitor domains collected.`;
+        const reportPath = await ctx.artifacts.writeHtml("HTML report", "report.html", renderWorkflowReport({
+          title: "Agent-Ready SEO Packet",
+          subtitle: `${input.keyword}${input.location ? ` \xB7 ${input.location}` : ""}`,
+          summary,
+          warnings,
+          tables: [
+            { title: "Competitor Domains", columns: ["domain", "organic_best_position", "organic_count", "paa_mentions", "ai_overview_citations", "source_url_count"], rows: competitors.slice(0, 50) },
+            { title: "Evidence Sources", columns: ["surface", "position", "title", "domain", "question", "is_target"], rows: rows.slice(0, 100) }
+          ]
+        }));
+        const status = warnings.length ? "partial" : "succeeded";
+        const counts = { sources: rows.length, competitors: competitors.length };
+        await ctx.artifacts.writeManifest(status, counts, warnings, []);
+        return {
+          state,
+          output: { sources: rows.length, competitors: competitors.length, status },
+          summary: { title: "Agent-Ready SEO Packet", summary, status, counts, warnings, errors: [], reportPath }
+        };
       }
     }
-    if (!serp && !paa && !input.returnPartial) throw new Error("No SEO evidence was collected");
-    const rows = sourceRows(input, serp, paa);
-    const target = normalizeDomain(input.domain);
-    const competitors = competitorRows(rows, target);
-    const evidence = {
-      input,
-      serp: serp ?? { status: "skipped" },
-      paa: paa ?? { status: "skipped" },
-      target: {
-        domain: target,
-        organicPositions: rows.filter((r) => r.surface === "organic" && r.is_target).map((r) => Number(r.position)),
-        citedInAiOverview: rows.some((r) => r.surface === "ai_overview" && r.is_target),
-        citedInPaa: rows.some((r) => r.surface === "paa" && r.is_target)
-      },
-      competitors,
-      warnings
-    };
-    await ctx.artifacts.writeJson("Evidence JSON", "evidence.json", evidence);
-    await ctx.artifacts.writeCsv("Sources CSV", "sources.csv", ["surface", "position", "title", "url", "domain", "question", "answer_excerpt", "is_target", "is_competitor"], rows);
-    await ctx.artifacts.writeCsv("Competitors CSV", "competitors.csv", ["domain", "organic_best_position", "organic_count", "paa_mentions", "ai_overview_citations", "source_url_count"], competitors);
-    const brief = [
-      `# SEO Evidence Brief: ${input.keyword}`,
-      "",
-      `Location: ${input.location ?? "not specified"}`,
-      `Target domain: ${target ?? "not specified"}`,
-      "",
-      "## Evidence Summary",
-      `- Organic rows: ${rows.filter((r) => r.surface === "organic").length}`,
-      `- PAA rows: ${rows.filter((r) => r.surface === "paa").length}`,
-      `- AI Overview citations: ${rows.filter((r) => r.surface === "ai_overview").length}`,
-      `- Competitor domains: ${competitors.length}`,
-      "",
-      "## Recommended Use",
-      "Use the CSV files as source of truth. Tie content recommendations to evidence rows and mark unsupported ideas as assumptions."
-    ].join("\n");
-    await ctx.artifacts.writeText("Brief", "brief.md", brief);
-    await ctx.artifacts.writeText("Agent tasks", "tasks.md", [
-      "# Agent Tasks",
-      "",
-      "- [ ] Read `evidence.json` before writing recommendations.",
-      "- [ ] Compare the target domain against `competitors.csv`.",
-      "- [ ] Use `sources.csv` for citations and source-grounded page sections.",
-      "- [ ] Mark unsupported recommendations as assumptions."
-    ].join("\n"));
-    await ctx.artifacts.writeText("Agent instructions", "agent-instructions.md", [
-      "# Agent Instructions",
-      "",
-      "You are working from an MCP Scraper SEO evidence packet. Use `evidence.json` and CSV files as source of truth. Do not invent citations. If a recommendation is not supported by evidence, mark it as an assumption."
-    ].join("\n"));
-    const summary = `${rows.length} evidence rows and ${competitors.length} competitor domains collected.`;
-    const reportPath = await ctx.artifacts.writeHtml("HTML report", "report.html", renderWorkflowReport({
-      title: "Agent-Ready SEO Packet",
-      subtitle: `${input.keyword}${input.location ? ` \xB7 ${input.location}` : ""}`,
-      summary,
-      warnings,
-      tables: [
-        { title: "Competitor Domains", columns: ["domain", "organic_best_position", "organic_count", "paa_mentions", "ai_overview_citations", "source_url_count"], rows: competitors.slice(0, 50) },
-        { title: "Evidence Sources", columns: ["surface", "position", "title", "domain", "question", "is_target"], rows: rows.slice(0, 100) }
-      ]
-    }));
-    const status = warnings.length ? "partial" : "succeeded";
-    const counts = { sources: rows.length, competitors: competitors.length };
-    await ctx.artifacts.writeManifest(status, counts, warnings, errors);
-    return { title: "Agent-Ready SEO Packet", summary, status, counts, warnings, errors, reportPath };
-  }
+  ]
 };
 
 // src/workflows/workflows/directory.ts
@@ -494,7 +538,7 @@ var DirectoryWorkflowCliInputSchema = z2.object({
   maxCities: z2.number().int().min(1).max(100).default(25),
   maxResultsPerCity: z2.number().int().min(1).max(50).default(20),
   concurrency: z2.number().int().min(1).max(5).default(5),
-  proxyMode: z2.enum(["location", "configured", "none"]).default("location"),
+  proxyMode: z2.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE),
   saveCsv: z2.boolean().default(true)
 });
 function directoryRows(result) {
@@ -629,7 +673,7 @@ var LocalCompetitiveAuditInputSchema = z3.object({
   hydrateTop: z3.number().int().min(0).max(10).default(5),
   maxReviews: z3.number().int().min(0).max(500).default(50),
   concurrency: z3.number().int().min(1).max(5).default(5),
-  proxyMode: z3.enum(["location", "configured", "none"]).default("location"),
+  proxyMode: z3.enum(["location", "configured", "none"]).default(DEFAULT_MAPS_PROXY_MODE),
   returnPartial: z3.boolean().default(true)
 });
 async function mapLimit(items, limit, fn) {
@@ -987,7 +1031,7 @@ var MapComparisonInputSchema = z4.object({
   hydrateTop: z4.number().int().min(0).max(10).default(5),
   maxReviews: z4.number().int().min(0).max(500).default(25),
   concurrency: z4.number().int().min(1).max(5).default(5),
-  proxyMode: ProxyModeSchema.default("location"),
+  proxyMode: ProxyModeSchema.default(DEFAULT_MAPS_PROXY_MODE),
   returnPartial: z4.boolean().default(true)
 }).refine((input) => input.location || input.state, {
   message: "Either location or state is required for map-comparison"
@@ -1534,22 +1578,44 @@ function workflowDefinition(id) {
   if (!definition) throw new Error(`Unknown workflow "${id}". Available: ${DEFINITIONS.map((def) => def.id).join(", ")}`);
   return definition;
 }
-async function runWorkflow(id, rawInput, options = {}) {
+function workflowStepCount(id) {
   const definition = workflowDefinition(id);
-  const input = definition.inputSchema.parse(rawInput);
+  return definition.steps?.length ?? 1;
+}
+function workflowSupportsSteps(id) {
+  const definition = workflowDefinition(id);
+  return Boolean(definition.steps && definition.steps.length > 0);
+}
+function resolveApiKey(options) {
   const apiKey = options.apiKey?.trim() || process.env.MCP_SCRAPER_API_KEY?.trim();
   if (!apiKey) throw new Error("MCP_SCRAPER_API_KEY is required for workflow runs. Pass --api-key or set the environment variable.");
-  const apiUrl = options.apiUrl?.trim() || process.env.MCP_SCRAPER_API_URL?.trim() || "https://mcpscraper.dev";
+  return apiKey;
+}
+function resolveApiUrl(options) {
+  return options.apiUrl?.trim() || process.env.MCP_SCRAPER_API_URL?.trim() || "https://mcpscraper.dev";
+}
+async function runWorkflow(id, rawInput, options = {}) {
+  const definition = workflowDefinition(id);
+  const input = definition.inputSchema.parse(rawInput);
+  const apiKey = resolveApiKey(options);
+  const apiUrl = resolveApiUrl(options);
   const artifacts = await ArtifactWriter.create(definition.id, definition.title, input, options.outputDir, options.runId);
   const client = new WorkflowHttpClient(apiUrl, apiKey, options.fetchImpl, options.headers);
+  const ctx = { runId: artifacts.runId, startedAt: artifacts.startedAt, client, artifacts, signal: options.signal };
   try {
-    return await definition.run(input, {
-      runId: artifacts.runId,
-      startedAt: artifacts.startedAt,
-      client,
-      artifacts,
-      signal: options.signal
-    });
+    if (definition.steps && definition.steps.length > 0) {
+      let state = definition.createState ? definition.createState(input) : {};
+      let summary = null;
+      for (const step of definition.steps) {
+        const outcome = await step.run({ input, state, ctx });
+        state = outcome.state;
+        if (outcome.summary) summary = outcome.summary;
+      }
+      if (!summary) throw new Error(`Workflow "${id}" produced no terminal step summary`);
+      return summary;
+    }
+    if (definition.run) return await definition.run(input, ctx);
+    throw new Error(`Workflow "${id}" has neither steps nor a run() implementation`);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
     await artifacts.writeText("Failure", "summary.md", `# ${definition.title}
@@ -1560,6 +1626,45 @@ ${message}
     throw err;
   }
 }
+async function runWorkflowStep(id, rawInput, opts) {
+  const definition = workflowDefinition(id);
+  const steps = definition.steps;
+  if (!steps || steps.length === 0) throw new Error(`Workflow "${id}" does not support stepwise execution`);
+  if (opts.stepIndex < 0 || opts.stepIndex >= steps.length) {
+    throw new Error(`Step index ${opts.stepIndex} is out of range for "${id}" (${steps.length} steps)`);
+  }
+  const options = opts.options ?? {};
+  const input = definition.inputSchema.parse(rawInput);
+  const apiKey = resolveApiKey(options);
+  const apiUrl = resolveApiUrl(options);
+  const artifacts = await ArtifactWriter.create(definition.id, definition.title, input, options.outputDir, options.runId);
+  const client = new WorkflowHttpClient(apiUrl, apiKey, options.fetchImpl, options.headers);
+  const ctx = { runId: artifacts.runId, startedAt: artifacts.startedAt, client, artifacts, signal: options.signal };
+  const state = opts.state ?? (definition.createState ? definition.createState(input) : {});
+  const step = steps[opts.stepIndex];
+  const outcome = await step.run({ input, state, ctx });
+  const writtenArtifacts = await Promise.all(
+    artifacts.artifacts.map(async (artifact) => ({
+      ...artifact,
+      content: await readFile2(artifact.path, "utf8").catch(() => "")
+    }))
+  );
+  return {
+    runId: artifacts.runId,
+    workflowId: definition.id,
+    title: definition.title,
+    stepIndex: opts.stepIndex,
+    stepId: step.id,
+    stepTitle: step.title,
+    totalSteps: steps.length,
+    isLast: opts.stepIndex === steps.length - 1,
+    output: outcome.output,
+    state: outcome.state,
+    warnings: outcome.warnings ?? [],
+    summary: outcome.summary ?? null,
+    artifacts: writtenArtifacts
+  };
+}
 
 export {
   csvRecords,
@@ -1570,6 +1675,9 @@ export {
   openWorkflowReport,
   listWorkflowDefinitions,
   workflowDefinition,
-  runWorkflow
+  workflowStepCount,
+  workflowSupportsSteps,
+  runWorkflow,
+  runWorkflowStep
 };
-//# sourceMappingURL=chunk-F44RBOJ5.js.map
+//# sourceMappingURL=chunk-H2R232HK.js.map