firecrawl-cli 1.16.2 → 1.17.1

package/dist/commands/experimental/index.js

@@ -1,200 +0,0 @@
-"use strict";
-/**
- * Experimental: AI Workflow commands
- *
- * Launches interactive coding agent sessions with pre-built system prompts.
- * Similar to `ollama run <model>` -- one command spins up a specialized agent.
- *
- * Supports multiple backends: Claude Code, Codex (OpenAI), OpenCode.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createClaudeCommand = createClaudeCommand;
-exports.createCodexCommand = createCodexCommand;
-exports.createOpenCodeCommand = createOpenCodeCommand;
-const commander_1 = require("commander");
-const backends_1 = require("./backends");
-const competitor_analysis_1 = require("./workflows/competitor-analysis");
-const competitive_intel_1 = require("./workflows/competitive-intel");
-const company_directories_1 = require("./workflows/company-directories");
-const dashboard_reporting_1 = require("./workflows/dashboard-reporting");
-const deep_research_1 = require("./workflows/deep-research");
-const knowledge_base_1 = require("./workflows/knowledge-base");
-const knowledge_ingest_1 = require("./workflows/knowledge-ingest");
-const lead_gen_1 = require("./workflows/lead-gen");
-const lead_research_1 = require("./workflows/lead-research");
-const market_research_1 = require("./workflows/market-research");
-const seo_audit_1 = require("./workflows/seo-audit");
-const qa_1 = require("./workflows/qa");
-const research_papers_1 = require("./workflows/research-papers");
-const demo_1 = require("./workflows/demo");
-const shop_1 = require("./workflows/shop");
-// ─── Workflow Registration (shared across backends) ──────────────────────────
-function registerWorkflows(parentCmd, backend) {
-    (0, competitor_analysis_1.register)(parentCmd, backend);
-    (0, competitive_intel_1.register)(parentCmd, backend);
-    (0, company_directories_1.register)(parentCmd, backend);
-    (0, dashboard_reporting_1.register)(parentCmd, backend);
-    (0, deep_research_1.register)(parentCmd, backend);
-    (0, knowledge_base_1.register)(parentCmd, backend);
-    (0, knowledge_ingest_1.register)(parentCmd, backend);
-    (0, lead_gen_1.register)(parentCmd, backend);
-    (0, lead_research_1.register)(parentCmd, backend);
-    (0, market_research_1.register)(parentCmd, backend);
-    (0, seo_audit_1.register)(parentCmd, backend);
-    (0, qa_1.register)(parentCmd, backend);
-    (0, research_papers_1.register)(parentCmd, backend);
-    (0, demo_1.register)(parentCmd, backend);
-    (0, shop_1.register)(parentCmd, backend);
-}
-// ─── Help text (shared) ─────────────────────────────────────────────────────
-function buildHelpText(cmdName) {
-    return `
-Workflows:
-  competitor-analysis    Scrape a site + competitors, compare features, pricing, positioning
-  competitive-intel      Monitor competitor dashboards, pricing tiers, and feature changes
-  company-directories    Scrape startup directories (YC, Crunchbase, etc.) into structured lists
-  dashboard-reporting    Pull metrics from analytics dashboards and internal tools via browser
-  deep-research          Multi-source research with configurable depth (5-25+ sources)
-  knowledge-base         Build a knowledge base from web content (docs, RAG, fine-tuning)
-  knowledge-ingest       Extract auth-gated docs portals into structured JSON or markdown
-  lead-gen               Extract prospect contact details from databases at scale via browser
-  lead-research          Pre-meeting intelligence brief on a company or person
-  market-research        Extract financial data, earnings, and market metrics via browser
-  seo-audit              Map a site, check meta/headings, compare to competitors
-  qa                     Spawn parallel browser agents to QA test a live site
-  research-papers        Find and synthesize research papers, whitepapers, and PDFs
-  demo                   Walk through a product's key flows using cloud browser
-  shop                   Research products across the web, then buy using your saved Amazon session
-
-Examples:
-
-  Prep for a sales call -- research the company, key people, and talking points:
-  $ firecrawl ${cmdName} lead-research "Vercel"
-  $ firecrawl ${cmdName} lead-research "Stripe"
-
-  Scope out the competition before a pitch:
-  $ firecrawl ${cmdName} competitor-analysis https://firecrawl.dev
-  $ firecrawl ${cmdName} competitor-analysis https://crawlee.dev
-
-  Research a market, integration opportunity, or partnership angle:
-  $ firecrawl ${cmdName} deep-research "RAG pipeline data ingestion tools landscape"
-  $ firecrawl ${cmdName} deep-research "Cursor AI editor architecture and extensions"
-
-  Scrape docs so you actually understand a product before the call:
-  $ firecrawl ${cmdName} knowledge-base https://docs.langchain.com
-  $ firecrawl ${cmdName} knowledge-base https://sdk.vercel.ai/docs
-
-  Build a fine-tuning dataset or RAG corpus from web content:
-  $ firecrawl ${cmdName} knowledge-base "Neon serverless postgres"
-
-  Walk through a product's UX -- signup, pricing, docs, dashboard:
-  $ firecrawl ${cmdName} demo https://resend.com
-  $ firecrawl ${cmdName} demo https://neon.tech
-
-  QA test a site before a demo or client handoff:
-  $ firecrawl ${cmdName} qa https://myapp.com
-
-  Audit a site's SEO and get specific fix recommendations:
-  $ firecrawl ${cmdName} seo-audit https://example.com
-
-  Find and synthesize research papers on a topic:
-  $ firecrawl ${cmdName} research-papers "web scraping compliance healthcare HIPAA"
-
-  Research and shop -- find the best deal, then add to your Amazon cart:
-  $ firecrawl ${cmdName} shop "mac mini for SF office delivery"
-  $ firecrawl ${cmdName} shop "best mechanical keyboard for developers"
-
-  Monitor competitor pricing and feature changes weekly:
-  $ firecrawl ${cmdName} competitive-intel "Linear, Asana, Monday.com"
-  $ firecrawl ${cmdName} competitive-intel https://openai.com https://anthropic.com
-
-  Build targeted company lists from startup directories:
-  $ firecrawl ${cmdName} company-directories "YC Series A B2B SaaS"
-  $ firecrawl ${cmdName} company-directories
-
-  Ingest auth-gated docs portals into structured data:
-  $ firecrawl ${cmdName} knowledge-ingest https://docs.internal.company.com
-  $ firecrawl ${cmdName} knowledge-ingest https://notion.so/team-wiki
-
-  Extract financial data and market metrics:
-  $ firecrawl ${cmdName} market-research "cloud infrastructure market"
-  $ firecrawl ${cmdName} market-research "AI SaaS companies"
-
-  Generate leads from prospect databases at scale:
-  $ firecrawl ${cmdName} lead-gen "CTOs at Series B fintech startups"
-  $ firecrawl ${cmdName} lead-gen "VP Engineering at healthcare companies"
-
-  Pull metrics from analytics dashboards behind login walls:
-  $ firecrawl ${cmdName} dashboard-reporting "analytics.google.com, app.mixpanel.com"
-  $ firecrawl ${cmdName} dashboard-reporting https://app.stripe.com/dashboard
-
-  Run any workflow fully interactive (no args, prompts guide you):
-  $ firecrawl ${cmdName} competitor-analysis
-  $ firecrawl ${cmdName} deep-research
-
-Pass -y to auto-approve all tool permissions.
-`;
-}
-// ─── Passthrough (natural language fallback) ─────────────────────────────────
-function buildPassthroughSystemPrompt(_userInput) {
-    return `You are a Firecrawl power user. You have the full Firecrawl CLI at your disposal to accomplish any web task the user describes.
-
-## First Steps
-
-**Run \`firecrawl --help\` to see all available commands and capabilities.** This is critical -- read the output carefully before proceeding.
-
-Then run \`firecrawl <command> --help\` for whichever specific commands you need.
-
-## Available Tools
-
-Use ONLY \`firecrawl\` for ALL web operations. It is already installed and authenticated. Run firecrawl commands via Bash. Do not use any other tools, skills, plugins, or built-in web features for web access -- only \`firecrawl\`. If the CLI has issues, you may fall back to Firecrawl MCP tools if available.
-
-Quick reference:
-- \`firecrawl search "<query>"\` -- Search the web
-- \`firecrawl scrape <url>\` -- Scrape a page as markdown
-- \`firecrawl scrape <url> --format html\` -- Scrape as HTML
-- \`firecrawl map <url>\` -- Discover all URLs on a site
-- \`firecrawl crawl <url>\` -- Crawl an entire site
-- \`firecrawl interact "Click the login button"\` -- Interact with a scraped page
-- \`firecrawl agent "<prompt>"\` -- AI agent for complex extraction
-
-## Guidelines
-
-- Figure out the right firecrawl commands for the task by reading --help output
-- Be resourceful -- combine multiple commands if needed
-- Show your work and explain what you're doing
-- Start working immediately`;
-}
-function createBackendCommand(name, description, backend) {
-    const cmd = new commander_1.Command(name)
-        .description(description)
-        .argument('[input...]', 'Natural language task or workflow name')
-        .option('-y, --yes', 'Auto-approve all tool permissions')
-        .allowUnknownOption()
-        .addHelpText('after', buildHelpText(name));
-    registerWorkflows(cmd, backend);
-    // Catch-all: if no subcommand matched, treat args as natural language
-    cmd.action(async (input, options) => {
-        const userInput = input.join(' ').trim();
-        if (!userInput) {
-            cmd.outputHelp();
-            return;
-        }
-        const config = backends_1.BACKENDS[backend];
-        const skipPermissions = true;
-        console.log(`\nLaunching ${config.displayName}...\n`);
-        (0, backends_1.launchAgent)(backend, buildPassthroughSystemPrompt(userInput), userInput, skipPermissions);
-    });
-    return cmd;
-}
-// ─── Command Exports ─────────────────────────────────────────────────────────
-function createClaudeCommand() {
-    return createBackendCommand('claude', 'AI workflows powered by Claude Code', 'claude');
-}
-function createCodexCommand() {
-    return createBackendCommand('codex', 'AI workflows powered by Codex (coming soon)', 'codex');
-}
-function createOpenCodeCommand() {
-    return createBackendCommand('opencode', 'AI workflows powered by OpenCode (coming soon)', 'opencode');
-}
-//# sourceMappingURL=index.js.map

package/dist/commands/experimental/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/experimental/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/experimental/shared.d.ts

@@ -1,17 +0,0 @@
-/**
- * Shared constants and helpers for AI workflows.
- */
-import { type Backend } from './backends';
-export declare const validateUrl: (value: string) => true | string;
-export declare const validateRequired: (label: string) => (value: string) => true | string;
-/** Ensure a URL has a protocol prefix. */
-export declare function normalizeUrl(url: string): string;
-/** Normalize a source that might be a URL or a plain topic string. */
-export declare function normalizeSource(source: string): string;
-export declare const FIRECRAWL_TOOLS_BLOCK = "## Your Tools -- READ THIS FIRST\n\nUse ONLY `firecrawl` for ALL web operations. It is already installed and authenticated. Run firecrawl commands via Bash. Do not use any other tools, skills, plugins, or built-in web features for web access -- only `firecrawl`. If the CLI has issues, you may fall back to Firecrawl MCP tools if available.\n\n**First step: run `firecrawl --help` to see all available commands.** Then run `firecrawl <command> --help` for any command you plan to use heavily.\n\nQuick reference:\n- `firecrawl search \"<query>\"` -- Search the web\n- `firecrawl scrape <url>` -- Scrape a page as markdown\n- `firecrawl map <url>` -- Discover all URLs on a site\n- `firecrawl crawl <url>` -- Crawl an entire site\n- `firecrawl interact \"Click the login button\"` -- Interact with a scraped page\n- `firecrawl agent \"<prompt>\"` -- AI agent for complex extraction";
-export declare const QA_TOOLS_BLOCK = "## Your Tools -- READ THIS FIRST\n\nUse ONLY `firecrawl` for ALL web operations. It is already installed and authenticated. Run firecrawl commands via Bash. Do not use any other tools, skills, plugins, or built-in web features for web access -- only `firecrawl`. If the CLI has issues, you may fall back to Firecrawl MCP tools if available.\n\n**First step: run `firecrawl --help` to see all available commands.** Tell each subagent to do the same.\n\n## IMPORTANT: Launch Browser with Live View FIRST\n\nBefore doing anything else, launch a browser session with streaming enabled so the user can watch in real-time:\n\n```bash\nfirecrawl browser launch-session --json\n```\n\nThis prints a **Live View URL**. Try to open it automatically for the user:\n\n```bash\nopen \"<liveViewUrl>\"          # macOS\nxdg-open \"<liveViewUrl>\"     # Linux\n```\n\nIf the `open` command fails or errors, just print the URL clearly so the user can copy-paste it into their browser. Either way, make sure the user sees the live view URL before you start working.\n\nQuick reference:\n- `firecrawl browser \"open <url>\"` -- Navigate to a URL in a cloud browser\n- `firecrawl browser \"snapshot\"` -- Get the current page state (accessibility tree)\n- `firecrawl browser \"click @<ref>\"` -- Click an element by its reference ID\n- `firecrawl browser \"type @<ref> <text>\"` -- Type text into an input\n- `firecrawl browser \"scrape\"` -- Get the full page content as markdown\n- `firecrawl browser \"scroll down\"` / `\"scroll up\"` -- Scroll the page\n- `firecrawl scrape <url>` -- Quick scrape without browser session\n- `firecrawl map <url>` -- Discover all URLs on the site";
-export declare const SUBAGENT_INSTRUCTIONS = "**IMPORTANT:** When spawning agents with the Agent tool:\n- Use `subagent_type: \"general-purpose\"` for each agent\n- Give each agent a clear, specific mandate in the prompt\n- Tell each agent: \"Use ONLY firecrawl for all web access via Bash. Do not use any other tools, skills, or plugins for web access. If the CLI has issues, fall back to Firecrawl MCP tools. Run `firecrawl --help` first.\"\n- Launch ALL agents in a SINGLE message (parallel, not sequential)\n- Each agent should return structured findings with source URLs";
-/** Join non-empty parts into a message string. */
-export declare function buildMessage(parts: string[]): string;
-export declare function askPermissionMode(backend: Backend): Promise<boolean>;
-//# sourceMappingURL=shared.d.ts.map

package/dist/commands/experimental/shared.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/commands/experimental/shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAY,MAAM,YAAY,CAAC;AAIpD,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,IAAI,GAAG,MAQlD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC1B,OAAO,MAAM,MACb,OAAO,MAAM,KAAG,IAAI,GAAG,MACsB,CAAC;AAIjD,0CAA0C;AAC1C,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAItD;AAID,eAAO,MAAM,qBAAqB,q3BAYkC,CAAC;AAErE,eAAO,MAAM,cAAc,ooDA+BgC,CAAC;AAE5D,eAAO,MAAM,qBAAqB,shBAK8B,CAAC;AAIjE,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEpD;AAID,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAwB1E"}

package/dist/commands/experimental/shared.js

@@ -1,152 +0,0 @@
-"use strict";
-/**
- * Shared constants and helpers for AI workflows.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SUBAGENT_INSTRUCTIONS = exports.QA_TOOLS_BLOCK = exports.FIRECRAWL_TOOLS_BLOCK = exports.validateRequired = exports.validateUrl = void 0;
-exports.normalizeUrl = normalizeUrl;
-exports.normalizeSource = normalizeSource;
-exports.buildMessage = buildMessage;
-exports.askPermissionMode = askPermissionMode;
-const backends_1 = require("./backends");
-// ─── Validators ─────────────────────────────────────────────────────────────
-const validateUrl = (value) => {
-    if (!value.trim())
-        return 'URL is required';
-    try {
-        new URL(value.startsWith('http') ? value : `https://${value}`);
-        return true;
-    }
-    catch {
-        return 'Please enter a valid URL';
-    }
-};
-exports.validateUrl = validateUrl;
-const validateRequired = (label) => (value) => value.trim() ? true : `${label} is required`;
-exports.validateRequired = validateRequired;
-// ─── URL helpers ────────────────────────────────────────────────────────────
-/** Ensure a URL has a protocol prefix. */
-function normalizeUrl(url) {
-    return url.startsWith('http') ? url : `https://${url}`;
-}
-/** Normalize a source that might be a URL or a plain topic string. */
-function normalizeSource(source) {
-    if (source.startsWith('http'))
-        return source;
-    if (/\.\w{2,}/.test(source))
-        return `https://${source}`;
-    return source;
-}
-// ─── Prompt blocks ──────────────────────────────────────────────────────────
-exports.FIRECRAWL_TOOLS_BLOCK = `## Your Tools -- READ THIS FIRST
-
-Use ONLY \`firecrawl\` for ALL web operations. It is already installed and authenticated. Run firecrawl commands via Bash. Do not use any other tools, skills, plugins, or built-in web features for web access -- only \`firecrawl\`. If the CLI has issues, you may fall back to Firecrawl MCP tools if available.
-
-**First step: run \`firecrawl --help\` to see all available commands.** Then run \`firecrawl <command> --help\` for any command you plan to use heavily.
-
-Quick reference:
-- \`firecrawl search "<query>"\` -- Search the web
-- \`firecrawl scrape <url>\` -- Scrape a page as markdown
-- \`firecrawl map <url>\` -- Discover all URLs on a site
-- \`firecrawl crawl <url>\` -- Crawl an entire site
-- \`firecrawl interact "Click the login button"\` -- Interact with a scraped page
-- \`firecrawl agent "<prompt>"\` -- AI agent for complex extraction`;
-exports.QA_TOOLS_BLOCK = `## Your Tools -- READ THIS FIRST
-
-Use ONLY \`firecrawl\` for ALL web operations. It is already installed and authenticated. Run firecrawl commands via Bash. Do not use any other tools, skills, plugins, or built-in web features for web access -- only \`firecrawl\`. If the CLI has issues, you may fall back to Firecrawl MCP tools if available.
-
-**First step: run \`firecrawl --help\` to see all available commands.** Tell each subagent to do the same.
-
-## IMPORTANT: Launch Browser with Live View FIRST
-
-Before doing anything else, launch a browser session with streaming enabled so the user can watch in real-time:
-
-\`\`\`bash
-firecrawl browser launch-session --json
-\`\`\`
-
-This prints a **Live View URL**. Try to open it automatically for the user:
-
-\`\`\`bash
-open "<liveViewUrl>"          # macOS
-xdg-open "<liveViewUrl>"     # Linux
-\`\`\`
-
-If the \`open\` command fails or errors, just print the URL clearly so the user can copy-paste it into their browser. Either way, make sure the user sees the live view URL before you start working.
-
-Quick reference:
-- \`firecrawl browser "open <url>"\` -- Navigate to a URL in a cloud browser
-- \`firecrawl browser "snapshot"\` -- Get the current page state (accessibility tree)
-- \`firecrawl browser "click @<ref>"\` -- Click an element by its reference ID
-- \`firecrawl browser "type @<ref> <text>"\` -- Type text into an input
-- \`firecrawl browser "scrape"\` -- Get the full page content as markdown
-- \`firecrawl browser "scroll down"\` / \`"scroll up"\` -- Scroll the page
-- \`firecrawl scrape <url>\` -- Quick scrape without browser session
-- \`firecrawl map <url>\` -- Discover all URLs on the site`;
-exports.SUBAGENT_INSTRUCTIONS = `**IMPORTANT:** When spawning agents with the Agent tool:
-- Use \`subagent_type: "general-purpose"\` for each agent
-- Give each agent a clear, specific mandate in the prompt
-- Tell each agent: "Use ONLY firecrawl for all web access via Bash. Do not use any other tools, skills, or plugins for web access. If the CLI has issues, fall back to Firecrawl MCP tools. Run \`firecrawl --help\` first."
-- Launch ALL agents in a SINGLE message (parallel, not sequential)
-- Each agent should return structured findings with source URLs`;
-// ─── Message builder ────────────────────────────────────────────────────────
-/** Join non-empty parts into a message string. */
-function buildMessage(parts) {
-    return parts.filter(Boolean).join('. ') + '.';
-}
-// ─── Permission helper ──────────────────────────────────────────────────────
-async function askPermissionMode(backend) {
-    const { select } = await Promise.resolve().then(() => __importStar(require('@inquirer/prompts')));
-    const config = backends_1.BACKENDS[backend];
-    const skipLabel = backend === 'codex' ? '--full-auto' : '--dangerously-skip-permissions';
-    const mode = await select({
-        message: 'How should the agent handle tool permissions?',
-        choices: [
-            {
-                name: 'Auto-approve all (recommended)',
-                value: 'skip',
-                description: `Runs fully autonomous, no manual approvals. Uses ${skipLabel}.`,
-            },
-            {
-                name: 'Ask me each time',
-                value: 'ask',
-                description: `${config.displayName} will prompt before running each tool (slower but more control).`,
-            },
-        ],
-    });
-    return mode === 'skip';
-}
-//# sourceMappingURL=shared.js.map

package/dist/commands/experimental/shared.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/commands/experimental/shared.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwBH,oCAEC;AAGD,0CAIC;AA6DD,oCAEC;AAID,8CAwBC;AA1HD,yCAAoD;AAEpD,+EAA+E;AAExE,MAAM,WAAW,GAAG,CAAC,KAAa,EAAiB,EAAE;IAC1D,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO,iBAAiB,CAAC;IAC5C,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,0BAA0B,CAAC;IACpC,CAAC;AACH,CAAC,CAAC;AARW,QAAA,WAAW,eAQtB;AAEK,MAAM,gBAAgB,GAC3B,CAAC,KAAa,EAAE,EAAE,CAClB,CAAC,KAAa,EAAiB,EAAE,CAC/B,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,cAAc,CAAC;AAHpC,QAAA,gBAAgB,oBAGoB;AAEjD,+EAA+E;AAE/E,0CAA0C;AAC1C,SAAgB,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,GAAG,EAAE,CAAC;AACzD,CAAC;AAED,sEAAsE;AACtE,SAAgB,eAAe,CAAC,MAAc;IAC5C,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAC7C,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,WAAW,MAAM,EAAE,CAAC;IACxD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+EAA+E;AAElE,QAAA,qBAAqB,GAAG;;;;;;;;;;;;oEAY+B,CAAC;AAExD,QAAA,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2DA+B6B,CAAC;AAE/C,QAAA,qBAAqB,GAAG;;;;;gEAK2B,CAAC;AAEjE,+EAA+E;AAE/E,kDAAkD;AAClD,SAAgB,YAAY,CAAC,KAAe;IAC1C,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;AAChD,CAAC;AAED,+EAA+E;AAExE,KAAK,UAAU,iBAAiB,CAAC,OAAgB;IACtD,MAAM,EAAE,MAAM,EAAE,GAAG,wDAAa,mBAAmB,GAAC,CAAC;IACrD,MAAM,MAAM,GAAG,mBAAQ,CAAC,OAAO,CAAC,CAAC;IAEjC,MAAM,SAAS,GACb,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,gCAAgC,CAAC;IAEzE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC;QACxB,OAAO,EAAE,+CAA+C;QACxD,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,gCAAgC;gBACtC,KAAK,EAAE,MAAM;gBACb,WAAW,EAAE,oDAAoD,SAAS,GAAG;aAC9E;YACD;gBACE,IAAI,EAAE,kBAAkB;gBACxB,KAAK,EAAE,KAAK;gBACZ,WAAW,EAAE,GAAG,MAAM,CAAC,WAAW,kEAAkE;aACrG;SACF;KACF,CAAC,CAAC;IAEH,OAAO,IAAI,KAAK,MAAM,CAAC;AACzB,CAAC"}

package/dist/commands/experimental/workflows/company-directories.d.ts

@@ -1,11 +0,0 @@
-/**
- * Workflow: Company Directories
- *
- * Browses startup directories (YC, Crunchbase, Product Hunt, etc.), applies
- * filters, paginates through results, and builds targeted company lists
- * with structured data for outreach, research, or CRM import.
- */
-import { Command } from 'commander';
-import { type Backend } from '../backends';
-export declare function register(parentCmd: Command, backend: Backend): void;
-//# sourceMappingURL=company-directories.d.ts.map

package/dist/commands/experimental/workflows/company-directories.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"company-directories.d.ts","sourceRoot":"","sources":["../../../../src/commands/experimental/workflows/company-directories.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,OAAO,EAAyB,MAAM,aAAa,CAAC;AAgNlE,wBAAgB,QAAQ,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAsCnE"}

package/dist/commands/experimental/workflows/company-directories.js

@@ -1,245 +0,0 @@
-"use strict";
-/**
- * Workflow: Company Directories
- *
- * Browses startup directories (YC, Crunchbase, Product Hunt, etc.), applies
- * filters, paginates through results, and builds targeted company lists
- * with structured data for outreach, research, or CRM import.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.register = register;
-const backends_1 = require("../backends");
-const shared_1 = require("../shared");
-// ─── Input gathering ────────────────────────────────────────────────────────
-async function gatherInputs(prefill) {
-    if (prefill?.directory) {
-        return {
-            directory: prefill.directory,
-            filters: '',
-            maxResults: '50',
-            output: 'json',
-            context: '',
-        };
-    }
-    const { input, select } = await Promise.resolve().then(() => __importStar(require('@inquirer/prompts')));
-    const directory = await select({
-        message: 'Which directory do you want to scrape?',
-        choices: [
-            { name: 'Y Combinator (ycombinator.com/companies)', value: 'yc' },
-            { name: 'Crunchbase', value: 'crunchbase' },
-            { name: 'Product Hunt', value: 'producthunt' },
-            { name: 'G2', value: 'g2' },
-            { name: 'Custom URL', value: 'custom' },
-        ],
-    });
-    let directoryValue = directory;
-    if (directory === 'custom') {
-        directoryValue = await input({
-            message: 'Enter the directory URL:',
-            validate: (0, shared_1.validateRequired)('URL'),
-        });
-    }
-    const filters = await input({
-        message: 'What filters should the agent apply? (e.g., "Series A, B2B SaaS, founded 2023+")',
-        default: '',
-    });
-    const maxResults = await input({
-        message: 'How many companies to extract?',
-        default: '50',
-    });
-    const output = await select({
-        message: 'Output format?',
-        choices: [
-            { name: 'JSON (structured, CRM-ready)', value: 'json' },
-            { name: 'CSV (spreadsheet-ready)', value: 'csv' },
-            { name: 'Print to terminal', value: 'terminal' },
-        ],
-    });
-    const context = await input({
-        message: 'Any other criteria? (e.g., "only companies with pricing pages", "must have API")',
-        default: '',
-    });
-    return {
-        directory: directoryValue,
-        filters,
-        maxResults,
-        output,
-        context,
-    };
-}
-// ─── System prompt ──────────────────────────────────────────────────────────
-function buildSystemPrompt(opts) {
-    const directoryUrls = {
-        yc: 'https://www.ycombinator.com/companies',
-        crunchbase: 'https://www.crunchbase.com/discover/organization.companies',
-        producthunt: 'https://www.producthunt.com',
-        g2: 'https://www.g2.com/categories',
-    };
-    const startUrl = directoryUrls[opts.directory] || opts.directory;
-    const outputInstructions = {
-        terminal: 'Print the full company list to the terminal as a formatted markdown table.',
-        json: `Save the results to \`company-list.json\` in the current directory. Tell the user the file path when done.
-
-Use this schema:
-\`\`\`json
-{
-  "source": "string (directory name)",
-  "filters": "string (filters applied)",
-  "extractedAt": "ISO-8601",
-  "totalResults": 0,
-  "companies": [
-    {
-      "name": "string",
-      "url": "string",
-      "description": "string",
-      "industry": "string",
-      "stage": "string (e.g. Seed, Series A)",
-      "founded": "string",
-      "location": "string",
-      "teamSize": "string",
-      "funding": "string",
-      "tags": ["string"],
-      "profileUrl": "string (directory listing URL)",
-      "websiteUrl": "string (company website)"
-    }
-  ]
-}
-\`\`\``,
-        csv: `Save the results to \`company-list.csv\` in the current directory with columns: name, url, description, industry, stage, founded, location, teamSize, funding, tags, profileUrl, websiteUrl. Tell the user the file path when done.`,
-    };
-    return `You are a company directory scraping agent powered by Firecrawl. You use a real cloud browser to navigate startup directories, apply filters, paginate through results, and extract structured company data.
-
-## STEP 1: Launch Browser and Open Live View
-
-Before anything else, launch a browser session so the user can watch:
-
-\`\`\`bash
-firecrawl browser launch-session --json
-\`\`\`
-
-Extract the \`interactiveLiveViewUrl\` from the JSON output and open it (NOT the regular \`liveViewUrl\` -- the interactive one lets the user click and interact):
-
-\`\`\`bash
-open "<interactiveLiveViewUrl>"          # macOS
-xdg-open "<interactiveLiveViewUrl>"     # Linux
-\`\`\`
-
-If the \`open\` command fails, print the URL clearly.
-
-## STEP 2: Navigate to Directory
-
-Open the directory:
-\`\`\`bash
-firecrawl browser "open ${startUrl}"
-\`\`\`
-
-## STEP 3: Apply Filters
-
-Take a snapshot to see the page layout:
-\`\`\`bash
-firecrawl browser "snapshot"
-\`\`\`
-
-Look for filter controls (dropdowns, checkboxes, search fields, sidebar filters) and apply the user's requested filters by clicking and typing.
-
-### Browser commands:
-\`\`\`bash
-firecrawl browser "click @<ref>"
-firecrawl browser "type @<ref> <text>"
-firecrawl browser "scroll down"
-firecrawl browser "snapshot"
-firecrawl browser "scrape"
-\`\`\`
-
-## STEP 4: Paginate and Extract
-
-After applying filters:
-
-1. **Snapshot** the results page to see company listings
-2. **Extract** data from each visible company (name, description, tags, etc.)
-3. **Click into** individual company profiles if the listing doesn't have enough detail
-4. **Navigate back** and continue to the next listing
-5. **Paginate** -- find and click "Next", "Load More", or scroll to trigger infinite scroll
-6. Repeat until you've collected ~${opts.maxResults} companies or exhausted results
-
-### Pagination tips:
-- Look for "Next" / ">" buttons, page number links, or "Load More"
-- Some directories use infinite scroll -- keep scrolling down and snapshotting
-- Track how many companies you've extracted to know when to stop
-- If a page loads slowly, wait a moment and snapshot again
-
-## Output Format
-
-${outputInstructions[opts.output]}
-
-## Quality Guidelines
-
-- Extract real data from the page, don't infer or guess
-- If a field isn't visible, leave it empty rather than fabricating
-- Deduplicate companies (same company might appear in multiple pages)
-- For each company, try to get at minimum: name, description, and URL
-
-Do everything sequentially. Start immediately.`;
-}
-// ─── Command registration ───────────────────────────────────────────────────
-function register(parentCmd, backend) {
-    const config = backends_1.BACKENDS[backend];
-    parentCmd
-        .command('company-directories')
-        .description('Scrape startup directories (YC, Crunchbase, etc.) into structured lists')
-        .argument('[query...]', 'Directory name or filters to apply')
-        .option('-y, --yes', 'Auto-approve all tool permissions')
-        .action(async (queryParts, options) => {
-        const prefillDir = queryParts.length > 0 ? queryParts.join(' ') : undefined;
-        const inputs = await gatherInputs(prefillDir ? { directory: prefillDir } : undefined);
-        const parts = [`Scrape directory: ${inputs.directory}`];
-        if (inputs.filters)
-            parts.push(`Filters: ${inputs.filters}`);
-        if (inputs.maxResults)
-            parts.push(`Extract up to ${inputs.maxResults} companies`);
-        if (inputs.context)
-            parts.push(inputs.context);
-        const userMessage = parts.join('. ') + '.';
-        const skipPermissions = true;
-        console.log(`\nLaunching ${config.displayName}...\n`);
-        (0, backends_1.launchAgent)(backend, buildSystemPrompt({
-            directory: inputs.directory,
-            output: inputs.output,
-            maxResults: inputs.maxResults,
-        }), userMessage, skipPermissions);
-    });
-}
-//# sourceMappingURL=company-directories.js.map