firecrawl-cli 1.16.2 → 1.17.1

package/dist/commands/experimental/workflows/dashboard-reporting.js

@@ -1,254 +0,0 @@
-"use strict";
-/**
- * Workflow: Dashboard Reporting
- *
- * Uses saved browser profiles to log into analytics platforms and internal
- * tools, navigate dashboards, extract metrics, trigger exports, and compile
- * cross-platform reports. Supports any login-gated web dashboard.
- */
-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?.dashboards) {
-        return {
-            dashboards: prefill.dashboards,
-            profile: '',
-            metrics: '',
-            dateRange: 'last 7 days',
-            output: 'json',
-            context: '',
-        };
-    }
-    const { input, select } = await Promise.resolve().then(() => __importStar(require('@inquirer/prompts')));
-    const dashboards = await input({
-        message: 'Which dashboards to pull from? (URLs, comma-separated -- e.g., "analytics.google.com, app.mixpanel.com")',
-        validate: (0, shared_1.validateRequired)('At least one dashboard URL'),
-    });
-    const profile = await input({
-        message: 'Browser profile for auth? (required for most dashboards)',
-        default: '',
-    });
-    const metrics = await input({
-        message: 'What metrics or data to extract? (leave blank for "everything visible")',
-        default: '',
-    });
-    const dateRange = await select({
-        message: 'Date range?',
-        choices: [
-            { name: 'Last 7 days', value: 'last 7 days' },
-            { name: 'Last 30 days', value: 'last 30 days' },
-            { name: 'Last 90 days', value: 'last 90 days' },
-            { name: 'Month to date', value: 'month to date' },
-            { name: 'Year to date', value: 'year to date' },
-            { name: 'Custom (specify in context)', value: 'custom' },
-        ],
-    });
-    const output = await select({
-        message: 'Output format?',
-        choices: [
-            { name: 'JSON (structured metrics)', value: 'json' },
-            { name: 'Markdown report', value: 'markdown' },
-            { name: 'Print to terminal', value: 'terminal' },
-        ],
-    });
-    const context = await input({
-        message: 'Any other instructions? (e.g., "compare to previous period", "focus on conversion funnel")',
-        default: '',
-    });
-    return { dashboards, profile, metrics, dateRange, output, context };
-}
-// ─── System prompt ──────────────────────────────────────────────────────────
-function buildSystemPrompt(opts) {
-    const profileBlock = opts.profile
-        ? `\n### Authentication\n\nUse the saved browser profile \`${opts.profile}\` to access dashboards:\n\`\`\`bash\nfirecrawl browser "open <url>" --profile ${opts.profile}\n\`\`\`\nAfter the first \`open\` with \`--profile\`, subsequent browser commands don't need the flag.\n\nIf you encounter a login page, use the profile's saved cookies/session. If those have expired, tell the user and ask them to re-authenticate the profile.`
-        : `\n### Authentication\n\nNo browser profile was specified. If dashboards require login, tell the user they need to provide a browser profile with saved auth. You can still attempt to access public dashboards or demo instances.`;
-    const outputInstructions = {
-        terminal: 'Print the full dashboard report to the terminal in well-formatted markdown with data tables.',
-        json: `Save the report to \`dashboard-report.json\` in the current directory. Tell the user the file path when done.
-
-Use this schema:
-\`\`\`json
-{
-  "reportedAt": "ISO-8601",
-  "dateRange": "string",
-  "dashboards": [
-    {
-      "name": "string (platform name)",
-      "url": "string",
-      "metrics": [
-        {
-          "name": "string",
-          "value": "string | number",
-          "unit": "string (e.g. %, users, $)",
-          "change": "string (e.g. +12% vs previous period)",
-          "period": "string"
-        }
-      ],
-      "tables": [
-        {
-          "title": "string",
-          "headers": ["string"],
-          "rows": [["string"]]
-        }
-      ],
-      "exports": [{ "filename": "string", "description": "string" }],
-      "notes": "string"
-    }
-  ],
-  "summary": {
-    "highlights": ["string"],
-    "alerts": ["string"],
-    "trends": ["string"]
-  }
-}
-\`\`\``,
-        markdown: 'Save the report to `dashboard-report.md` in the current directory. Tell the user the file path when done.',
-    };
-    return `You are a dashboard reporting agent powered by Firecrawl. You use a real cloud browser to log into analytics platforms and internal tools, navigate dashboards, extract metrics, and compile cross-platform reports.
-
-## 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.
-${profileBlock}
-
-## STEP 2: Visit Each Dashboard
-
-For each dashboard URL the user provides:
-
-1. **Navigate** to the dashboard
-2. **Snapshot** to see the current state
-3. **Set the date range** to "${opts.dateRange}" -- look for date pickers, dropdowns, or preset buttons and click them
-4. **Extract visible metrics** -- KPIs, summary cards, headline numbers
-5. **Explore data tables** -- click through tabs, expand sections, scroll tables
-6. **Look for exports** -- if there's a "Download CSV", "Export", or "Report" button, click it
-7. **Screenshot key views** by scraping the page content
-
-### 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"
-\`\`\`
-
-### Common dashboard patterns:
-- **Google Analytics**: Navigate to Reports > Engagement, Acquisition, etc.
-- **Mixpanel / Amplitude**: Click through funnels, retention, user flows
-- **Stripe / Billing dashboards**: Revenue, MRR, churn, customer counts
-- **Internal tools**: Look for nav menus, sidebar items, tab strips
-- **Grafana / Datadog**: Expand panels, hover charts for values, adjust time range
-
-### Handling charts and visualizations:
-- Charts can't be "read" visually -- instead, look for:
-  - Data tables below/beside charts
-  - Hover tooltips (snapshot after hovering)
-  - "View as table" or "Show data" toggles
-  - Export/download buttons for raw data
-- If a metric is only in a chart, describe what you can see from the page content
-
-## STEP 3: Compile Report
-
-After visiting all dashboards, compile findings into a unified report:
-
-### Dashboard-by-Dashboard Breakdown
-For each platform:
-- Platform name and URL
-- All metrics extracted with values and units
-- Any data tables captured
-- Files exported (if any)
-
-### Cross-Platform Summary
-- Key highlights across all dashboards
-- Alerts (metrics that changed significantly)
-- Trends (patterns across platforms)
-
-## Output Format
-
-${outputInstructions[opts.output]}
-
----
-
-Do everything sequentially -- visit one dashboard at a time. Be thorough: click through tabs, expand sections, scroll to load lazy content. Extract actual numbers, not just labels.
-
-Start immediately.`;
-}
-// ─── Command registration ───────────────────────────────────────────────────
-function register(parentCmd, backend) {
-    const config = backends_1.BACKENDS[backend];
-    parentCmd
-        .command('dashboard-reporting')
-        .description('Pull metrics from analytics dashboards and internal tools via browser')
-        .argument('[dashboards...]', 'Dashboard URLs to pull from')
-        .option('-y, --yes', 'Auto-approve all tool permissions')
-        .action(async (dashboardParts, options) => {
-        const prefillDashboards = dashboardParts.length > 0 ? dashboardParts.join(' ') : undefined;
-        const inputs = await gatherInputs(prefillDashboards ? { dashboards: prefillDashboards } : undefined);
-        const parts = [`Pull reports from: ${inputs.dashboards}`];
-        if (inputs.metrics)
-            parts.push(`Focus on these metrics: ${inputs.metrics}`);
-        if (inputs.dateRange !== 'custom')
-            parts.push(`Date range: ${inputs.dateRange}`);
-        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({
-            profile: inputs.profile,
-            dateRange: inputs.dateRange,
-            output: inputs.output,
-        }), userMessage, skipPermissions);
-    });
-}
-//# sourceMappingURL=dashboard-reporting.js.map

package/dist/commands/experimental/workflows/dashboard-reporting.js.map

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

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

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

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

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

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

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

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

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

@@ -1,190 +0,0 @@
-"use strict";
-/**
- * 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.
- */
-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 product do you want to walk through?',
-            validate: shared_1.validateUrl,
-        }));
-    const focus = await select({
-        message: 'What flows should the agent explore?',
-        choices: [
-            { name: 'Full product walkthrough (all key flows)', value: 'full' },
-            { name: 'Signup and onboarding flow', value: 'signup' },
-            { name: 'Pricing and plans', value: 'pricing' },
-            { name: 'Documentation and developer experience', value: 'docs' },
-            { name: 'Dashboard and core product', value: 'dashboard' },
-        ],
-    });
-    const context = await input({
-        message: 'Anything specific to look for? (leave blank to skip)',
-        default: '',
-    });
-    const output = await select({
-        message: 'How should the walkthrough 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 walkthrough to a file called `demo-walkthrough.md` in the current directory. Tell the user the file path when done.'
-        : 'Print the full walkthrough to the terminal in well-formatted markdown.';
-    const focusInstructions = {
-        full: `Spawn these parallel agents, each walking a different flow:
-1. **Homepage & Marketing Agent** -- Open the homepage. Click through marketing pages (features, about, use cases). Document the messaging, value prop, key claims, and CTAs. Note what's above the fold vs below.
-2. **Signup & Onboarding Agent** -- Find the signup/get-started flow. Walk through every step of signup and onboarding. Document each screen, what's required, friction points, and the first-run experience. Do NOT submit real credentials -- just document the flow.
-3. **Pricing & Plans Agent** -- Navigate to pricing. Click to expand tiers, toggle monthly/annual, check feature comparisons. Document every plan, price, and feature. Look for hidden costs or confusing language.
-4. **Docs & Developer Experience Agent** -- Navigate to docs. Walk through the quickstart guide. Check navigation, code examples, search functionality. Document the developer onboarding experience.`,
-        signup: `Spawn these parallel agents to thoroughly explore the signup and onboarding experience:
-1. **Signup Discovery Agent** -- Find every signup entry point (header CTA, pricing page, landing pages). Document how many clicks to get to signup from different starting points.
-2. **Signup Flow Agent** -- Walk through the signup form step by step. Document every field, validation message, and screen transition. Note required vs optional fields. Do NOT submit real credentials.
-3. **Onboarding Agent** -- After signup screens, document the onboarding flow: welcome screens, setup wizards, tutorials, first-run experience. Walk through every step.
-4. **Social Proof Agent** -- Look for trust signals during signup: testimonials, logos, security badges, terms. Document what reassurance the user gets during the flow.`,
-        pricing: `Spawn these parallel agents to deeply analyze the pricing experience:
-1. **Pricing Page Agent** -- Navigate to the pricing page. Snapshot the full layout. Toggle between monthly/annual. Click to expand feature lists. Document every plan name, price, and feature.
-2. **Feature Comparison Agent** -- Find the feature comparison table or matrix. Click through each tier's detail page. Document what's included and excluded at each level.
-3. **Pricing Discovery Agent** -- Check multiple entry points to pricing (nav, footer, CTAs). Look for different pricing shown to different segments. Check if pricing changes based on region or plan selection.
-4. **Competitor Pricing Agent** -- Search for and scrape competitor pricing pages. Build a side-by-side comparison of pricing tiers and features.`,
-        docs: `Spawn these parallel agents to walk through the documentation experience:
-1. **Quickstart Agent** -- Find and follow the quickstart guide from start to finish. Try every step. Document the experience: was it clear? Were code examples correct? How long would it take a new developer?
-2. **Navigation Agent** -- Explore the doc structure. Click through the sidebar, use search, check breadcrumbs. Document the information architecture and how easy it is to find things.
-3. **Code Examples Agent** -- Find code examples across the docs. Check multiple languages/SDKs. Document which are available, their quality, and whether they look copy-pasteable.
-4. **API Reference Agent** -- Find the API reference. Walk through endpoints, check request/response examples, look for interactive "try it" features. Document completeness and usability.`,
-        dashboard: `Spawn these parallel agents to explore the core product experience:
-1. **Entry Point Agent** -- Find the login/dashboard entry. Document what the user sees on first login. Walk through the main navigation. Map out the product sections.
-2. **Core Flow Agent** -- Identify the primary user action (create something, configure something). Walk through it step by step. Document each screen and interaction.
-3. **Settings & Config Agent** -- Explore settings, integrations, API keys, team management. Document what's configurable and how.
-4. **Help & Support Agent** -- Find help resources within the product: tooltips, help center links, chat widgets, documentation links. Document what support is available in-context.`,
-    };
-    return `You are a product demo team lead powered by Firecrawl. You walk through a product's key flows using cloud browser automation, documenting every screen and interaction.
-
-${shared_1.QA_TOOLS_BLOCK}
-
-## Your Strategy
-
-You are a **team lead**. Your job is to:
-
-1. **Open the site first** -- Run \`firecrawl browser "open <url>"\` yourself to get the initial page state and understand the site structure.
-2. **Spawn parallel subagents** -- Each agent walks through a different flow using \`firecrawl browser\`. They click, scroll, type, and snapshot their way through the product.
-3. **Collect results** -- Each agent reports back a step-by-step walkthrough of their flow.
-4. **Synthesize** -- Merge all walkthroughs into one structured report.
-
-## Agent Assignments
-
-${focusInstructions[opts.focus]}
-
-${shared_1.SUBAGENT_INSTRUCTIONS}
-
-- Tell each agent to use \`firecrawl browser\` commands to navigate interactively
-- Each agent should describe every screen they see: layout, content, CTAs, forms
-- Agents should \`firecrawl browser "snapshot"\` at each step to see interactive elements
-- Agents should note the user experience: what's clear, what's confusing, what's missing
-
-## Output Format
-
-${outputInstructions}
-
-Structure the walkthrough as:
-
-### Product Overview
-One paragraph summary of what the product does based on exploring it.
-
-### Flow Walkthroughs
-
-For each flow explored:
-
-#### [Flow Name]
-Step-by-step walkthrough:
-1. **[Screen/Page Name]** -- What's on screen, key elements, what the user would do next
-2. **[Next Screen]** -- What changed, new elements, user actions available
-...
-
-Key observations:
-- What works well
-- What's confusing or could be improved
-- Notable UX patterns
-
-### Key Findings
-- First impression and overall UX quality
-- Standout features or patterns
-- Friction points or usability issues
-- How the product compares to typical products in the space
-
-### Recommendations
-What could be improved, from a user experience perspective.
-
-### Pages Visited
-Full list of every URL the agents navigated to.
-
----
-
-Be specific and descriptive. Don't just say "the pricing page looks good" -- describe what's on it, how it's organized, and what makes it effective or not.
-
-Start by opening the site, then immediately fan out your agents to walk through different flows in parallel.`;
-}
-// ─── Command registration ───────────────────────────────────────────────────
-function register(parentCmd, backend) {
-    const config = backends_1.BACKENDS[backend];
-    parentCmd
-        .command('demo')
-        .description("Walk through a product's key flows using cloud browser")
-        .argument('[url]', 'Product URL to explore')
-        .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)([`Walk through ${inputs.url}`, inputs.context]), skipPermissions);
-    });
-}
-//# sourceMappingURL=demo.js.map

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

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