firecrawl-cli 1.9.4 → 1.9.5

package/dist/commands/experimental/shared.js

@@ -0,0 +1,154 @@
+"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 browser "open <url>"\` -- Cloud browser session
+- \`firecrawl browser "snapshot"\` -- Get page state
+- \`firecrawl browser "click @<ref>"\` -- Click an element
+- \`firecrawl browser "type @<ref> <text>"\` -- Type into an input`;
+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\` and \`firecrawl browser --help\` to see all 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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/commands/experimental/shared.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwBH,oCAEC;AAGD,0CAIC;AA+DD,oCAEC;AAID,8CAwBC;AA5HD,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;;;;;;;;;;;;;;mEAc8B,CAAC;AAEvD,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/competitor-analysis.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Workflow: Competitor Analysis
+ *
+ * Spawns parallel agents -- one per company -- to scrape and profile the target
+ * and each competitor simultaneously. Synthesizes into a full competitive report.
+ */
+import { Command } from 'commander';
+import { type Backend } from '../backends';
+export declare function register(parentCmd: Command, backend: Backend): void;
+//# sourceMappingURL=competitor-analysis.d.ts.map

package/dist/commands/experimental/workflows/competitor-analysis.d.ts.map

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

package/dist/commands/experimental/workflows/competitor-analysis.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * Workflow: Competitor Analysis
+ *
+ * Spawns parallel agents -- one per company -- to scrape and profile the target
+ * and each competitor simultaneously. Synthesizes into a full competitive report.
+ */
+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) {
+    const { input, select } = await Promise.resolve().then(() => __importStar(require('@inquirer/prompts')));
+    const rawUrl = prefill?.url ||
+        (await input({
+            message: "What's the URL of the site you want to analyze?",
+            validate: shared_1.validateUrl,
+        }));
+    const competitors = await input({
+        message: 'Are there particular competitors you want to flag? (leave blank to auto-discover)',
+        default: '',
+    });
+    const context = await input({
+        message: 'Anything else I should know? (leave blank to skip)',
+        default: '',
+    });
+    const output = await select({
+        message: 'How should the report be delivered?',
+        choices: [
+            { name: 'Print to terminal', value: 'terminal' },
+            { name: 'Save as Markdown file', value: 'markdown' },
+            { name: 'Save as JSON (structured data)', value: 'json' },
+        ],
+    });
+    return { url: (0, shared_1.normalizeUrl)(rawUrl), competitors, context, output };
+}
+// ─── System prompt ──────────────────────────────────────────────────────────
+function buildSystemPrompt(opts) {
+    const outputInstructions = {
+        terminal: 'Print the full report to the terminal in well-formatted markdown.',
+        markdown: 'Save the report to a file called `competitor-analysis.md` in the current directory. Tell the user the file path when done.',
+        json: `Save the report as structured JSON to \`competitor-analysis.json\` in the current directory. Tell the user the file path when done.
+
+Use this exact schema:
+\`\`\`json
+{
+  "target": {
+    "name": "string",
+    "url": "string",
+    "description": "string",
+    "features": ["string"],
+    "pricing": { "model": "string", "tiers": [{ "name": "string", "price": "string", "features": ["string"] }] },
+    "targetAudience": "string",
+    "valueProposition": "string",
+    "sources": ["url"]
+  },
+  "competitors": [
+    {
+      "name": "string",
+      "url": "string",
+      "description": "string",
+      "features": ["string"],
+      "pricing": { "model": "string", "tiers": [{ "name": "string", "price": "string", "features": ["string"] }] },
+      "targetAudience": "string",
+      "sources": ["url"]
+    }
+  ],
+  "featureMatrix": {
+    "features": ["string"],
+    "comparison": { "companyName": { "featureName": "yes | no | partial | string" } }
+  },
+  "positioning": [{ "company": "string", "tone": "string", "keyClaims": ["string"], "differentiators": ["string"] }],
+  "strengths": ["string"],
+  "weaknesses": ["string"],
+  "opportunities": ["string"],
+  "sources": [{ "url": "string", "title": "string", "usedFor": "string" }]
+}
+\`\`\``,
+    };
+    return `You are a competitive analysis team lead powered by Firecrawl. You orchestrate parallel research agents to analyze a target company and its competitors simultaneously.
+
+${shared_1.FIRECRAWL_TOOLS_BLOCK}
+
+## Your Strategy
+
+You are a **team lead**, not a solo researcher. Your job is to:
+
+1. **Identify the landscape** -- Do a quick search yourself to find competitors if not provided. Search for "<product> alternatives", "<product> vs", "<industry> tools".
+2. **Spawn parallel subagents** -- Launch one agent per company (target + each competitor). Each agent scrapes and profiles one company in depth.
+3. **Collect results** -- Each agent reports back structured company data with source URLs.
+4. **Synthesize** -- Build the comparative analysis, feature matrix, positioning breakdown, and recommendations from all agent findings.
+
+## Agent Assignments
+
+Spawn these agents in parallel:
+1. **Target Company Agent** -- Scrape the target site thoroughly. Extract: features, pricing, positioning, messaging, target audience, value proposition, content strategy. Return all findings with source URLs.
+2. **Competitor Agent** (one per competitor) -- Each agent scrapes one competitor's site. Extract: company name, URL, what they do, key features, pricing (if public), target audience, value proposition. Return findings with source URLs.
+
+${shared_1.SUBAGENT_INSTRUCTIONS}
+
+## Output Format
+
+${outputInstructions[opts.output]}
+
+Produce a comprehensive competitive analysis report with:
+
+### 1. Target Company Overview
+- What they do (one paragraph)
+- Key features / product offerings
+- Pricing model (if public)
+- Target audience
+- Unique value proposition
+
+### 2. Competitor Profiles
+For each competitor:
+- Company name & URL
+- What they do
+- Key features
+- Pricing (if public)
+- Target audience
+
+### 3. Feature Comparison Matrix
+A markdown table comparing features across all companies.
+
+### 4. Positioning & Messaging Analysis
+How each company positions itself -- tone, key claims, differentiators.
+
+### 5. Strengths & Weaknesses
+For the target company relative to competitors.
+
+### 6. Opportunities & Recommendations
+Actionable insights based on competitive gaps.
+
+### 7. Sources & Citations
+For every claim, cite the source URL where you found the information. List all URLs scraped at the end with a one-line note on what was found there.
+
+---
+
+Be thorough. Scrape real pages, extract real data. Do not make things up -- if pricing isn't public, say so. If a page fails to scrape, try an alternative URL or note the limitation.
+
+Start working immediately when given a target.`;
+}
+// ─── Command registration ───────────────────────────────────────────────────
+function register(parentCmd, backend) {
+    const config = backends_1.BACKENDS[backend];
+    parentCmd
+        .command('competitor-analysis')
+        .description('Analyze a website and its competitive landscape')
+        .argument('[url]', 'URL to analyze')
+        .option('-y, --yes', 'Auto-approve all tool permissions')
+        .action(async (url, options) => {
+        const inputs = await gatherInputs(url ? { url } : undefined);
+        const skipPermissions = options.yes || (await (0, shared_1.askPermissionMode)(backend));
+        console.log(`\nLaunching ${config.displayName}...\n`);
+        (0, backends_1.launchAgent)(backend, buildSystemPrompt({ output: inputs.output }), (0, shared_1.buildMessage)([
+            `Analyze ${inputs.url}`,
+            inputs.competitors && `Competitors to include: ${inputs.competitors}`,
+            inputs.context,
+        ]), skipPermissions);
+    });
+}
+//# sourceMappingURL=competitor-analysis.js.map

package/dist/commands/experimental/workflows/competitor-analysis.js.map

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

package/dist/commands/experimental/workflows/deep-research.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Workflow: Deep Research
+ *
+ * Breaks a topic into research angles, then spawns parallel agents -- one per
+ * angle (overview, technical, market, contrarian). Results are cross-referenced
+ * and synthesized into a structured report.
+ */
+import { Command } from 'commander';
+import { type Backend } from '../backends';
+export declare function register(parentCmd: Command, backend: Backend): void;
+//# sourceMappingURL=deep-research.d.ts.map

package/dist/commands/experimental/workflows/deep-research.d.ts.map

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

package/dist/commands/experimental/workflows/deep-research.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * Workflow: Deep Research
+ *
+ * Breaks a topic into research angles, then spawns parallel agents -- one per
+ * angle (overview, technical, market, contrarian). Results are cross-referenced
+ * and synthesized into a structured report.
+ */
+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) {
+    const { input, select } = await Promise.resolve().then(() => __importStar(require('@inquirer/prompts')));
+    const topic = prefill?.topic ||
+        (await input({
+            message: 'What topic do you want to research?',
+            validate: (0, shared_1.validateRequired)('Topic'),
+        }));
+    const depth = await select({
+        message: 'How deep should the research go?',
+        choices: [
+            { name: 'Quick overview (5-10 sources)', value: 'quick' },
+            { name: 'Thorough analysis (15-25 sources)', value: 'thorough' },
+            { name: 'Exhaustive deep-dive (25+ sources)', value: 'exhaustive' },
+        ],
+    });
+    const context = await input({
+        message: 'Any specific angles or questions to focus on? (leave blank to skip)',
+        default: '',
+    });
+    const output = await select({
+        message: 'How should the research be delivered?',
+        choices: [
+            { name: 'Print to terminal', value: 'terminal' },
+            { name: 'Save as Markdown file', value: 'markdown' },
+            { name: 'Save as JSON (structured data)', value: 'json' },
+        ],
+    });
+    return { topic, depth, context, output };
+}
+// ─── System prompt ──────────────────────────────────────────────────────────
+function buildSystemPrompt(opts) {
+    const depthInstructions = {
+        quick: 'Search 3-5 queries and scrape 5-10 of the most relevant pages.',
+        thorough: 'Search 5-10 queries from different angles and scrape 15-25 pages. Cross-reference claims across sources.',
+        exhaustive: 'Search 10+ queries covering every angle. Scrape 25+ pages including primary sources, research papers, expert opinions, and contrarian views. Cross-reference everything.',
+    };
+    const outputInstructions = {
+        terminal: 'Print the full research report to the terminal in well-formatted markdown.',
+        markdown: 'Save the report to a file called `research-report.md` in the current directory. Tell the user the file path when done.',
+        json: 'Save the report as structured JSON to `research-report.json` in the current directory. Tell the user the file path when done.',
+    };
+    return `You are a deep research team lead powered by Firecrawl. You orchestrate parallel research agents to investigate a topic from every angle simultaneously.
+
+${shared_1.FIRECRAWL_TOOLS_BLOCK}
+
+## Research Depth
+
+${depthInstructions[opts.depth]}
+
+## Your Strategy
+
+You are a **team lead**, not a solo researcher. Your job is to:
+
+1. **Break the topic into angles** -- Identify 3-5 distinct research angles or subtopics.
+2. **Spawn parallel subagents** -- One agent per angle. Each searches, scrapes, and analyzes from their specific perspective.
+3. **Collect results** -- Each agent reports back findings with sources.
+4. **Cross-reference and synthesize** -- Merge findings, resolve conflicting claims, build the unified report.
+
+## Agent Assignments
+
+Based on the topic, spawn agents like:
+1. **Overview Agent** -- Broad searches, foundational context, definitions, key players. Scrape Wikipedia, encyclopedia-style sources, overview articles.
+2. **Technical Deep-Dive Agent** -- Technical details, documentation, specifications, architecture. Scrape docs, technical blogs, research papers.
+3. **Market & Industry Agent** -- Market size, trends, adoption, industry analyst perspectives. Scrape reports, news articles, industry publications.
+4. **Contrarian & Risks Agent** -- Counterarguments, criticisms, failure cases, limitations. Search for "<topic> problems", "<topic> criticism", "<topic> limitations".
+
+Adjust the number and focus of agents based on the topic and depth level.
+
+${shared_1.SUBAGENT_INSTRUCTIONS}
+
+## Output Format
+
+${outputInstructions[opts.output]}
+
+Structure the report as:
+
+### Executive Summary
+2-3 paragraph overview of key findings.
+
+### Key Findings
+Numbered list of the most important discoveries, each with supporting evidence.
+
+### Detailed Analysis
+Deep dive into each major theme or subtopic.
+
+### Contrarian Views & Risks
+What are the counterarguments? What could go wrong?
+
+### Sources
+Every URL you scraped, with a one-line summary of what you found there.
+
+---
+
+Be thorough and honest. Cite your sources. Flag uncertainty. Do not fabricate information.
+
+Start working immediately when given a topic.`;
+}
+// ─── Command registration ───────────────────────────────────────────────────
+function register(parentCmd, backend) {
+    const config = backends_1.BACKENDS[backend];
+    parentCmd
+        .command('deep-research')
+        .description('Deep research any topic using web search and scraping')
+        .argument('[topic]', 'Topic to research')
+        .option('-y, --yes', 'Auto-approve all tool permissions')
+        .action(async (topic, options) => {
+        const inputs = await gatherInputs(topic ? { topic } : undefined);
+        const skipPermissions = options.yes || (await (0, shared_1.askPermissionMode)(backend));
+        console.log(`\nLaunching ${config.displayName}...\n`);
+        (0, backends_1.launchAgent)(backend, buildSystemPrompt({ depth: inputs.depth, output: inputs.output }), (0, shared_1.buildMessage)([inputs.topic, inputs.context]), skipPermissions);
+    });
+}
+//# sourceMappingURL=deep-research.js.map

package/dist/commands/experimental/workflows/deep-research.js.map

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

package/dist/commands/experimental/workflows/demo.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Workflow: Demo Walkthrough
+ *
+ * Uses Firecrawl's cloud browser to walk through a product's key flows --
+ * signup, onboarding, pricing, docs -- step by step. Captures every screen,
+ * documents interactions, and produces a structured walkthrough report.
+ */
+import { Command } from 'commander';
+import { type Backend } from '../backends';
+export declare function register(parentCmd: Command, backend: Backend): void;
+//# sourceMappingURL=demo.d.ts.map

package/dist/commands/experimental/workflows/demo.d.ts.map

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