firecrawl-cli 1.17.0 → 1.18.0

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

@@ -1,260 +0,0 @@
-"use strict";
-/**
- * Workflow: Market Research
- *
- * Browses financial portals, earnings pages, and market data sites using a
- * cloud browser. Interacts with charts, filters, and dropdowns to extract
- * earnings data, market metrics, and financial comparisons across companies.
- */
-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?.query) {
-        return {
-            query: prefill.query,
-            companies: '',
-            dataPoints: 'all',
-            output: 'json',
-            context: '',
-        };
-    }
-    const { input, select } = await Promise.resolve().then(() => __importStar(require('@inquirer/prompts')));
-    const query = await input({
-        message: 'What market or industry to research? (e.g., "cloud infrastructure", "AI SaaS")',
-        validate: (0, shared_1.validateRequired)('Market or industry'),
-    });
-    const companies = await input({
-        message: 'Specific companies to include? (comma-separated, leave blank to discover)',
-        default: '',
-    });
-    const dataPoints = await select({
-        message: 'What data are you looking for?',
-        choices: [
-            { name: 'Everything (revenue, earnings, metrics, news)', value: 'all' },
-            {
-                name: 'Financial data (revenue, earnings, margins)',
-                value: 'financial',
-            },
-            {
-                name: 'Market metrics (market cap, P/E, growth rates)',
-                value: 'metrics',
-            },
-            { name: 'Industry trends and news', value: 'trends' },
-        ],
-    });
-    const output = await select({
-        message: 'Output format?',
-        choices: [
-            { name: 'JSON (structured data)', value: 'json' },
-            { name: 'Markdown report', value: 'markdown' },
-            { name: 'Print to terminal', value: 'terminal' },
-        ],
-    });
-    const context = await input({
-        message: 'Any specific angle? (e.g., "focus on Q4 2024 earnings", "compare gross margins")',
-        default: '',
-    });
-    return { query, companies, dataPoints, output, context };
-}
-// ─── System prompt ──────────────────────────────────────────────────────────
-function buildSystemPrompt(opts) {
-    const focusInstructions = {
-        all: 'Extract comprehensive data: revenue, earnings, margins, market cap, P/E ratio, growth rates, recent news, and analyst estimates.',
-        financial: 'Focus on financial statements: quarterly/annual revenue, net income, gross margin, operating margin, EPS, and YoY growth.',
-        metrics: 'Focus on market metrics: market cap, P/E ratio, P/S ratio, EV/EBITDA, 52-week range, average volume, and beta.',
-        trends: 'Focus on industry trends: market size estimates, growth forecasts, major deals/acquisitions, regulatory changes, and emerging players.',
-    };
-    const outputInstructions = {
-        terminal: 'Print the full market research report to the terminal in well-formatted markdown with data tables.',
-        json: `Save the report to \`market-research.json\` in the current directory. Tell the user the file path when done.
-
-Use this schema:
-\`\`\`json
-{
-  "market": "string",
-  "researchedAt": "ISO-8601",
-  "companies": [
-    {
-      "name": "string",
-      "ticker": "string",
-      "sector": "string",
-      "financials": {
-        "revenue": { "value": "string", "period": "string", "yoyGrowth": "string" },
-        "netIncome": { "value": "string", "period": "string" },
-        "grossMargin": "string",
-        "operatingMargin": "string",
-        "eps": "string"
-      },
-      "marketMetrics": {
-        "marketCap": "string",
-        "peRatio": "string",
-        "psRatio": "string",
-        "52weekHigh": "string",
-        "52weekLow": "string"
-      },
-      "recentNews": [{ "date": "string", "headline": "string", "source": "string", "url": "string" }],
-      "sources": ["url"]
-    }
-  ],
-  "industryTrends": [{ "trend": "string", "details": "string", "source": "url" }],
-  "sources": [{ "url": "string", "type": "string", "dataExtracted": "string" }]
-}
-\`\`\``,
-        markdown: 'Save the report to `market-research.md` in the current directory. Tell the user the file path when done.',
-    };
-    return `You are a market research agent powered by Firecrawl. You use a real cloud browser to navigate financial portals, interact with data visualizations, and extract structured market 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: Identify Target Companies
-
-If the user didn't specify companies, search for key players in the market:
-
-\`\`\`bash
-firecrawl search "<market> top public companies"
-firecrawl search "<market> industry leaders revenue"
-\`\`\`
-
-## STEP 3: Extract Data from Financial Portals
-
-For each company, visit financial data sources and interact with their UIs:
-
-### Primary sources to visit:
-- **Yahoo Finance** (finance.yahoo.com) -- Company profile, financials, statistics
-- **Macrotrends** (macrotrends.net) -- Historical financials, charts
-- **SEC filings** (sec.gov/cgi-bin/browse-edgar) -- For US public companies
-- **Company investor relations pages** -- Direct earnings reports
-
-### How to extract data:
-1. Navigate to the company's financial page
-2. Snapshot to see available data sections
-3. Click tabs like "Financials", "Statistics", "Historical Data"
-4. Interact with period selectors (quarterly/annual toggles)
-5. Scroll through data tables and extract values
-6. Click into earnings reports or press releases for details
-
-### Browser commands:
-\`\`\`bash
-firecrawl browser "open <url>"
-firecrawl browser "snapshot"
-firecrawl browser "click @<ref>"
-firecrawl browser "type @<ref> <text>"
-firecrawl browser "scroll down"
-firecrawl browser "scrape"
-\`\`\`
-
-Also use \`firecrawl scrape <url>\` for quick page grabs when browser interaction isn't needed.
-
-## Data Focus
-
-${focusInstructions[opts.dataPoints]}
-
-## Output Format
-
-${outputInstructions[opts.output]}
-
-Structure your report with:
-
-### Market Overview
-- Industry description, size, and growth trajectory
-- Key players and market share (if available)
-
-### Company Profiles
-For each company:
-- Financial summary (revenue, margins, growth)
-- Market metrics (cap, ratios)
-- Recent developments
-
-### Comparison Tables
-- Revenue comparison across companies
-- Margin comparison
-- Valuation multiples side-by-side
-
-### Trends & Outlook
-- Industry trends and forecasts
-- Analyst consensus if available
-
-### Sources
-- Every URL visited with what data was extracted
-
----
-
-Do everything sequentially. Cross-reference data across sources when possible. Note any conflicting numbers. Start immediately.`;
-}
-// ─── Command registration ───────────────────────────────────────────────────
-function register(parentCmd, backend) {
-    const config = backends_1.BACKENDS[backend];
-    parentCmd
-        .command('market-research')
-        .description('Extract financial data, earnings, and market metrics via browser')
-        .argument('[query...]', 'Market, industry, or company to research')
-        .option('-y, --yes', 'Auto-approve all tool permissions')
-        .action(async (queryParts, options) => {
-        const prefillQuery = queryParts.length > 0 ? queryParts.join(' ') : undefined;
-        const inputs = await gatherInputs(prefillQuery ? { query: prefillQuery } : undefined);
-        const parts = [`Research market: ${inputs.query}`];
-        if (inputs.companies)
-            parts.push(`Include these companies: ${inputs.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({
-            dataPoints: inputs.dataPoints,
-            output: inputs.output,
-        }), userMessage, skipPermissions);
-    });
-}
-//# sourceMappingURL=market-research.js.map

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

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

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

@@ -1,11 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,184 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,11 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,151 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,11 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}