firecrawl-cli 1.9.4 → 1.9.5

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

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * Workflow: Lead Research
+ *
+ * Spawns parallel agents to research a company, recent news/activity, and
+ * optionally a specific person -- all at once. Results are synthesized into
+ * a brief with talking points and pain points.
+ */
+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 company = prefill?.company ||
+        (await input({
+            message: 'What company do you want to research?',
+            validate: (0, shared_1.validateRequired)('Company name or URL'),
+        }));
+    const person = await input({
+        message: 'Specific person to research? (leave blank to skip)',
+        default: '',
+    });
+    const context = await input({
+        message: 'What\'s the context? (e.g., "preparing for a sales call", "partnership eval")',
+        default: '',
+    });
+    const output = await select({
+        message: 'How should the brief be delivered?',
+        choices: [
+            { name: 'Print to terminal', value: 'terminal' },
+            { name: 'Save as Markdown file', value: 'markdown' },
+        ],
+    });
+    return { company, person, context, output };
+}
+// ─── System prompt ──────────────────────────────────────────────────────────
+function buildSystemPrompt(opts) {
+    const outputInstructions = opts.output === 'markdown'
+        ? 'Save the brief to a file called `lead-brief.md` in the current directory. Tell the user the file path when done.'
+        : 'Print the full brief to the terminal in well-formatted markdown.';
+    return `You are a lead research team lead powered by Firecrawl. You orchestrate parallel research agents to prepare intelligence briefs before meetings, calls, or outreach.
+
+${shared_1.FIRECRAWL_TOOLS_BLOCK}
+
+## Your Strategy
+
+You are a **team lead**, not a solo researcher. Your job is to:
+
+1. **Spawn parallel subagents** -- Launch agents to research the company, recent activity, and person simultaneously.
+2. **Collect results** -- Each agent reports back findings with sources.
+3. **Synthesize** -- Build the brief with talking points and pain points from all agent findings.
+
+## Agent Assignments
+
+Spawn these agents in parallel:
+1. **Company Profile Agent** -- Scrape the company website: about page, team/careers, product pages, pricing. Return what they do, size, stage, tech stack, key metrics.
+2. **News & Activity Agent** -- Search for recent news about the company: funding, launches, hires, partnerships, press coverage from the last 6 months. Scrape the top results.
+3. **Person Research Agent** (if a person is specified) -- Search for the person: their role, background, recent talks/posts/tweets, interests, public profiles. Scrape relevant pages.
+
+${shared_1.SUBAGENT_INSTRUCTIONS}
+
+## Output Format
+
+${outputInstructions}
+
+Structure the brief as:
+
+### Company Overview
+What they do, size, stage, key metrics.
+
+### Recent Activity
+News, launches, funding, hires from the last 6 months.
+
+### Key People
+Relevant people at the company with their roles and backgrounds.
+
+### Talking Points
+5-7 specific conversation starters based on your research.
+
+### Potential Pain Points
+What challenges might they be facing based on their industry/stage/tech?
+
+### Sources
+Every URL you scraped.
+
+---
+
+Be concise and actionable. This is a pre-meeting brief, not a thesis.
+
+Start working immediately.`;
+}
+// ─── Command registration ───────────────────────────────────────────────────
+function register(parentCmd, backend) {
+    const config = backends_1.BACKENDS[backend];
+    parentCmd
+        .command('lead-research')
+        .description('Research a company or person before a meeting or outreach')
+        .argument('[company]', 'Company name or URL')
+        .option('-y, --yes', 'Auto-approve all tool permissions')
+        .action(async (company, options) => {
+        const inputs = await gatherInputs(company ? { company } : 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)([
+            `Research ${inputs.company}`,
+            inputs.person && `Focus on ${inputs.person}`,
+            inputs.context && `Context: ${inputs.context}`,
+        ]), skipPermissions);
+    });
+}
+//# sourceMappingURL=lead-research.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lead-research.js","sourceRoot":"","sources":["../../../../src/commands/experimental/workflows/lead-research.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqHH,4BAyBC;AA3ID,0CAAkE;AAClE,sCAMmB;AAWnB,+EAA+E;AAE/E,KAAK,UAAU,YAAY,CAAC,OAA8B;IACxD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,wDAAa,mBAAmB,GAAC,CAAC;IAE5D,MAAM,OAAO,GACX,OAAO,EAAE,OAAO;QAChB,CAAC,MAAM,KAAK,CAAC;YACX,OAAO,EAAE,uCAAuC;YAChD,QAAQ,EAAE,IAAA,yBAAgB,EAAC,qBAAqB,CAAC;SAClD,CAAC,CAAC,CAAC;IAEN,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC;QACzB,OAAO,EAAE,oDAAoD;QAC7D,OAAO,EAAE,EAAE;KACZ,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC;QAC1B,OAAO,EACL,+EAA+E;QACjF,OAAO,EAAE,EAAE;KACZ,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC;QAC1B,OAAO,EAAE,oCAAoC;QAC7C,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,UAAU,EAAE;YAChD,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,UAAU,EAAE;SACrD;KACF,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC9C,CAAC;AAED,+EAA+E;AAE/E,SAAS,iBAAiB,CAAC,IAAwB;IACjD,MAAM,kBAAkB,GACtB,IAAI,CAAC,MAAM,KAAK,UAAU;QACxB,CAAC,CAAC,kHAAkH;QACpH,CAAC,CAAC,kEAAkE,CAAC;IAEzE,OAAO;;EAEP,8BAAqB;;;;;;;;;;;;;;;;;EAiBrB,8BAAqB;;;;EAIrB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;2BA0BO,CAAC;AAC5B,CAAC;AAED,+EAA+E;AAE/E,SAAgB,QAAQ,CAAC,SAAkB,EAAE,OAAgB;IAC3D,MAAM,MAAM,GAAG,mBAAQ,CAAC,OAAO,CAAC,CAAC;IAEjC,SAAS;SACN,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,2DAA2D,CAAC;SACxE,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;SAC5C,MAAM,CAAC,WAAW,EAAE,mCAAmC,CAAC;SACxD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;QACjC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAErE,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAA,0BAAiB,EAAC,OAAO,CAAC,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,WAAW,OAAO,CAAC,CAAC;QAEtD,IAAA,sBAAW,EACT,OAAO,EACP,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EAC5C,IAAA,qBAAY,EAAC;YACX,YAAY,MAAM,CAAC,OAAO,EAAE;YAC5B,MAAM,CAAC,MAAM,IAAI,YAAY,MAAM,CAAC,MAAM,EAAE;YAC5C,MAAM,CAAC,OAAO,IAAI,YAAY,MAAM,CAAC,OAAO,EAAE;SAC/C,CAAC,EACF,eAAe,CAChB,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Workflow: QA / Dogfood
+ *
+ * Acts as a QA team lead: maps the site, then spawns 3-4 parallel subagents
+ * that use Firecrawl's cloud browser to click around, fill forms, test
+ * interactions, and find bugs simultaneously.
+ */
+import { Command } from 'commander';
+import { type Backend } from '../backends';
+export declare function register(parentCmd: Command, backend: Backend): void;
+//# sourceMappingURL=qa.d.ts.map

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

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

package/dist/commands/experimental/workflows/qa.js

@@ -0,0 +1,184 @@
+"use strict";
+/**
+ * Workflow: QA / Dogfood
+ *
+ * Acts as a QA team lead: maps the site, then spawns 3-4 parallel subagents
+ * that use Firecrawl's cloud browser to click around, fill forms, test
+ * interactions, and find bugs simultaneously.
+ */
+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 to test?",
+            validate: shared_1.validateUrl,
+        }));
+    const focus = await select({
+        message: 'What should the QA focus on?',
+        choices: [
+            { name: 'Full exploratory test (everything)', value: 'full' },
+            { name: 'Forms and user flows', value: 'forms' },
+            { name: 'Navigation and links', value: 'navigation' },
+            { name: 'Responsive / mobile issues', value: 'responsive' },
+            { name: 'Performance and load times', value: 'performance' },
+        ],
+    });
+    const context = await input({
+        message: 'Any specific areas or known issues to check? (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' },
+        ],
+    });
+    return { url: (0, shared_1.normalizeUrl)(rawUrl), focus, context, output };
+}
+// ─── System prompt ──────────────────────────────────────────────────────────
+function buildSystemPrompt(opts) {
+    const outputInstructions = opts.output === 'markdown'
+        ? 'Save the QA report to a file called `qa-report.md` in the current directory. Tell the user the file path when done.'
+        : 'Print the final unified QA report to the terminal in well-formatted markdown.';
+    const focusInstructions = {
+        full: `Spawn ALL of these parallel agents:
+1. **Navigation & Links Agent** -- Map the site, visit every nav item, check footer links, breadcrumbs, 404s, broken links.
+2. **Forms & Interactions Agent** -- Find every form, test valid/invalid submissions, check validation messages, test edge cases (empty, too long, special chars).
+3. **Content & Visual Agent** -- Check content quality, heading hierarchy, image alt tags, visual consistency, scroll through all pages.
+4. **Error States Agent** -- Hit invalid URLs, test error pages, try unauthorized access, check API error responses visible in the UI.`,
+        forms: `Spawn these parallel agents:
+1. **Form Discovery Agent** -- Map the site and find every form, input, and interactive element.
+2. **Happy Path Agent** -- Test every form with valid data, verify success states.
+3. **Edge Case Agent** -- Test with empty fields, max-length inputs, special characters, SQL injection strings, XSS payloads.
+4. **Validation Agent** -- Test field-level validation, required fields, format validation (email, phone, etc).`,
+        navigation: `Spawn these parallel agents:
+1. **Sitemap Agent** -- Map the full site, check sitemap.xml, compare discovered vs listed URLs.
+2. **Nav Testing Agent** -- Click every nav item, dropdown, mega menu. Test mobile nav if responsive.
+3. **Link Checker Agent** -- Scrape every page for links, verify each one returns 200.
+4. **Routing Agent** -- Test back/forward, deep linking, query params, hash routing.`,
+        responsive: `Spawn these parallel agents:
+1. **Desktop Agent** -- Test at 1920px, 1440px, 1024px widths.
+2. **Tablet Agent** -- Test at 768px and 1024px portrait/landscape.
+3. **Mobile Agent** -- Test at 375px and 390px widths.
+4. **Interaction Agent** -- Test touch targets, overflow, horizontal scroll, zoom behavior.`,
+        performance: `Spawn these parallel agents:
+1. **Page Load Agent** -- Measure load times for key pages (homepage, product, blog, pricing).
+2. **Asset Audit Agent** -- Check image sizes, unoptimized assets, render-blocking scripts.
+3. **Content Efficiency Agent** -- Check for lazy loading, pagination, infinite scroll behavior.
+4. **Comparison Agent** -- Load competitor sites, compare performance characteristics.`,
+    };
+    return `You are a QA team lead powered by Firecrawl. You orchestrate parallel testing agents to thoroughly test live websites.
+
+${shared_1.QA_TOOLS_BLOCK}
+
+## Your Strategy
+
+You are a **team lead**, not a solo tester. Your job is to:
+
+1. **Map the site first** -- Run \`firecrawl map\` yourself to discover all pages.
+2. **Spawn parallel subagents** -- Use the Agent tool to launch multiple testing agents simultaneously. Each agent gets a specific testing mandate and a subset of pages.
+3. **Collect results** -- Each agent reports back its findings.
+4. **Synthesize** -- Merge all agent findings into one unified report, deduplicate issues, and assign severity.
+
+## Agent Assignments
+
+${focusInstructions[opts.focus]}
+
+${shared_1.SUBAGENT_INSTRUCTIONS}
+
+- Tell each agent which pages to test (divide the sitemap between them)
+- Tell each agent to use \`firecrawl browser\` and \`firecrawl scrape\` commands
+- Each agent should report findings as: severity (critical/major/minor), URL, description, steps to reproduce
+
+## Output Format
+
+${outputInstructions}
+
+Structure the unified QA report as:
+
+### Summary
+- Overall health score (out of 10)
+- Pages tested: X
+- Issues found: X critical, X major, X minor
+- Agents deployed: X
+
+### Critical Issues
+Bugs that break functionality or block users:
+- **[C-1]** URL | Description | Steps to reproduce | Expected vs actual
+
+### Major Issues
+Significant UX problems or broken features:
+- **[M-1]** URL | Description | Steps to reproduce
+
+### Minor Issues
+Visual glitches, inconsistencies, polish items:
+- **[m-1]** URL | Description
+
+### Positive Observations
+Things that work particularly well.
+
+### Pages Tested
+Full list of every URL visited across all agents.
+
+### Agent Summary
+Which agent found what -- brief summary of each agent's work.
+
+---
+
+Start by mapping the site, then immediately fan out your testing agents in parallel.`;
+}
+// ─── Command registration ───────────────────────────────────────────────────
+function register(parentCmd, backend) {
+    const config = backends_1.BACKENDS[backend];
+    parentCmd
+        .command('qa')
+        .description('QA test a live website using Firecrawl cloud browser')
+        .argument('[url]', 'URL to test')
+        .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({ focus: inputs.focus, output: inputs.output }), (0, shared_1.buildMessage)([`Test ${inputs.url}`, inputs.context]), skipPermissions);
+    });
+}
+//# sourceMappingURL=qa.js.map

package/dist/commands/experimental/workflows/qa.js.map

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

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

@@ -0,0 +1,11 @@
+/**
+ * Workflow: Research Papers
+ *
+ * Spawns parallel agents by source type (academic, industry, technical) to find,
+ * scrape, and synthesize research papers, whitepapers, and PDFs into a
+ * structured literature review.
+ */
+import { Command } from 'commander';
+import { type Backend } from '../backends';
+export declare function register(parentCmd: Command, backend: Backend): void;
+//# sourceMappingURL=research-papers.d.ts.map

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

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

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

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * Workflow: Research Papers
+ *
+ * Spawns parallel agents by source type (academic, industry, technical) to find,
+ * scrape, and synthesize research papers, whitepapers, and PDFs into a
+ * structured literature review.
+ */
+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 find papers on?',
+            validate: (0, shared_1.validateRequired)('Topic'),
+        }));
+    const count = await input({
+        message: 'How many papers/sources to target? (default: 10)',
+        default: '10',
+    });
+    const context = await input({
+        message: 'Any specific angles or questions? (leave blank to skip)',
+        default: '',
+    });
+    const output = await select({
+        message: 'How should the literature review be delivered?',
+        choices: [
+            { name: 'Print to terminal', value: 'terminal' },
+            { name: 'Save as Markdown file', value: 'markdown' },
+        ],
+    });
+    return { topic, count, context, output };
+}
+// ─── System prompt ──────────────────────────────────────────────────────────
+function buildSystemPrompt(opts) {
+    const outputInstructions = opts.output === 'markdown'
+        ? 'Save the literature review to `literature-review.md` in the current directory. Tell the user the file path when done.'
+        : 'Print the full literature review to the terminal in well-formatted markdown.';
+    return `You are a research papers team lead powered by Firecrawl. You find, scrape, and synthesize research papers, whitepapers, and PDFs into a structured literature review.
+
+${shared_1.FIRECRAWL_TOOLS_BLOCK}
+
+## Your Strategy
+
+You are a **team lead**. Your job is to:
+
+1. **Find papers and PDFs** -- Search for research papers, whitepapers, technical reports, and PDFs on the topic. Target sources like arXiv, Google Scholar, IEEE, ACM, company research blogs, and PDF links.
+2. **Spawn parallel subagents** -- Each agent scrapes and analyzes a subset of papers.
+3. **Synthesize** -- Build a structured literature review from all agent findings.
+
+## Agent Assignments
+
+Spawn agents by source type:
+1. **Academic Papers Agent** -- Search for and scrape research papers from arXiv, Google Scholar links, university sites. Use \`firecrawl scrape\` on PDF URLs directly -- Firecrawl handles PDFs natively.
+2. **Industry Reports Agent** -- Search for whitepapers, technical reports, and industry publications. Scrape company research blogs and report PDFs.
+3. **Technical Articles Agent** -- Search for in-depth technical articles, blog posts from researchers, and conference talk summaries.
+
+${shared_1.SUBAGENT_INSTRUCTIONS}
+
+## Output Format
+
+${outputInstructions}
+
+Structure the literature review as:
+
+### Abstract
+2-3 paragraph summary of the research landscape.
+
+### Key Papers
+For each paper/source:
+- **Title** and authors (if available)
+- **Source URL**
+- **Key findings** (2-3 bullet points)
+- **Methodology** (if applicable)
+- **Relevance** to the topic
+
+### Themes & Consensus
+What do the papers agree on? What are the established findings?
+
+### Open Questions & Debates
+Where do papers disagree? What's unresolved?
+
+### Emerging Trends
+Recent developments and where the field is heading.
+
+### Sources
+Every URL scraped, organized by type (paper, report, article).
+
+---
+
+Be thorough with citations. Every claim should trace back to a specific source. If a PDF fails to scrape, note it and try an alternative.
+
+Start by searching for papers on the topic.`;
+}
+// ─── Command registration ───────────────────────────────────────────────────
+function register(parentCmd, backend) {
+    const config = backends_1.BACKENDS[backend];
+    parentCmd
+        .command('research-papers')
+        .description('Find and synthesize research papers, whitepapers, and PDFs')
+        .argument('[topic]', 'Research topic')
+        .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({ output: inputs.output }), (0, shared_1.buildMessage)([
+            `Research papers on: ${inputs.topic}`,
+            `Target ~${inputs.count} papers`,
+            inputs.context,
+        ]), skipPermissions);
+    });
+}
+//# sourceMappingURL=research-papers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"research-papers.js","sourceRoot":"","sources":["../../../../src/commands/experimental/workflows/research-papers.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyHH,4BAyBC;AA/ID,0CAAkE;AAClE,sCAMmB;AAWnB,+EAA+E;AAE/E,KAAK,UAAU,YAAY,CAAC,OAA4B;IACtD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,wDAAa,mBAAmB,GAAC,CAAC;IAE5D,MAAM,KAAK,GACT,OAAO,EAAE,KAAK;QACd,CAAC,MAAM,KAAK,CAAC;YACX,OAAO,EAAE,2CAA2C;YACpD,QAAQ,EAAE,IAAA,yBAAgB,EAAC,OAAO,CAAC;SACpC,CAAC,CAAC,CAAC;IAEN,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC;QACxB,OAAO,EAAE,kDAAkD;QAC3D,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC;QAC1B,OAAO,EAAE,yDAAyD;QAClE,OAAO,EAAE,EAAE;KACZ,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC;QAC1B,OAAO,EAAE,gDAAgD;QACzD,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,UAAU,EAAE;YAChD,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,UAAU,EAAE;SACrD;KACF,CAAC,CAAC;IAEH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC3C,CAAC;AAED,+EAA+E;AAE/E,SAAS,iBAAiB,CAAC,IAAwB;IACjD,MAAM,kBAAkB,GACtB,IAAI,CAAC,MAAM,KAAK,UAAU;QACxB,CAAC,CAAC,uHAAuH;QACzH,CAAC,CAAC,8EAA8E,CAAC;IAErF,OAAO;;EAEP,8BAAqB;;;;;;;;;;;;;;;;;EAiBrB,8BAAqB;;;;EAIrB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4CA+BwB,CAAC;AAC7C,CAAC;AAED,+EAA+E;AAE/E,SAAgB,QAAQ,CAAC,SAAkB,EAAE,OAAgB;IAC3D,MAAM,MAAM,GAAG,mBAAQ,CAAC,OAAO,CAAC,CAAC;IAEjC,SAAS;SACN,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,4DAA4D,CAAC;SACzE,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;SACrC,MAAM,CAAC,WAAW,EAAE,mCAAmC,CAAC;SACxD,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAEjE,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAA,0BAAiB,EAAC,OAAO,CAAC,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,WAAW,OAAO,CAAC,CAAC;QAEtD,IAAA,sBAAW,EACT,OAAO,EACP,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EAC5C,IAAA,qBAAY,EAAC;YACX,uBAAuB,MAAM,CAAC,KAAK,EAAE;YACrC,WAAW,MAAM,CAAC,KAAK,SAAS;YAChC,MAAM,CAAC,OAAO;SACf,CAAC,EACF,eAAe,CAChB,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/experimental/workflows/seo-audit.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Workflow: SEO Audit
+ *
+ * Maps the site, then spawns parallel agents for site structure, on-page SEO,
+ * and keyword/competitor analysis. Produces a prioritized audit with specific
+ * (not generic) recommendations.
+ */
+import { Command } from 'commander';
+import { type Backend } from '../backends';
+export declare function register(parentCmd: Command, backend: Backend): void;
+//# sourceMappingURL=seo-audit.d.ts.map

package/dist/commands/experimental/workflows/seo-audit.d.ts.map

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