firecrawl-cli 1.17.0 → 1.18.0

package/dist/commands/monitor.js

@@ -0,0 +1,395 @@
+"use strict";
+/**
+ * `firecrawl monitor` — manage Firecrawl monitors.
+ *
+ * Monitors run recurring scrapes/crawls and diff each result against the last
+ * retained snapshot. See features/monitoring in the docs.
+ *
+ * @mendable/firecrawl-js@4.22.2 exposes monitor methods (createMonitor,
+ * listMonitors, getMonitor, updateMonitor, deleteMonitor, runMonitor,
+ * listMonitorChecks, getMonitorCheck), but its HttpClient injects a top-level
+ * `origin: js-sdk@<version>` field into every POST/PATCH body and the
+ * /v2/monitor endpoint rejects that with "Unrecognized key in body". Until the
+ * SDK strips `origin` for monitor requests (or the API accepts it), we hit
+ * /v2/monitor directly via fetch — same pattern parse.ts uses.
+ *
+ * Subcommands:
+ *   create | list | get | update | delete | run | checks | check
+ */
+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.createMonitorCommand = createMonitorCommand;
+const fs = __importStar(require("fs"));
+const commander_1 = require("commander");
+const config_1 = require("../utils/config");
+const output_1 = require("../utils/output");
+const DEFAULT_API_URL = 'https://api.firecrawl.dev';
+async function monitorRequest(path, options, init = {}) {
+    const config = (0, config_1.getConfig)();
+    const apiKey = options.apiKey || config.apiKey;
+    (0, config_1.validateConfig)(apiKey);
+    const baseUrl = (options.apiUrl || config.apiUrl || DEFAULT_API_URL).replace(/\/$/, '');
+    let url = `${baseUrl}/v2${path}`;
+    if (init.query) {
+        const qs = new URLSearchParams();
+        for (const [k, v] of Object.entries(init.query)) {
+            if (v !== undefined && v !== null && v !== '')
+                qs.set(k, String(v));
+        }
+        const s = qs.toString();
+        if (s)
+            url += `?${s}`;
+    }
+    const headers = {
+        Authorization: `Bearer ${apiKey}`,
+        'X-Origin': 'cli',
+    };
+    if (init.body !== undefined)
+        headers['Content-Type'] = 'application/json';
+    const response = await fetch(url, {
+        method: init.method ?? 'GET',
+        headers,
+        body: init.body !== undefined ? JSON.stringify(init.body) : undefined,
+    });
+    const payload = (await response.json().catch(() => ({})));
+    if (!response.ok || payload?.success === false) {
+        const message = payload?.error ||
+            `HTTP ${response.status}: ${response.statusText || 'Request failed'}`;
+        throw new Error(message);
+    }
+    return payload;
+}
+function emit(payload, options) {
+    const text = JSON.stringify(payload, null, options.pretty ? 2 : 0);
+    (0, output_1.writeOutput)(text, options.output, !!options.output);
+}
+/**
+ * Read a JSON payload from a positional arg or piped stdin.
+ *
+ * - `file` is a path to a .json file, or `-` to read stdin explicitly.
+ * - If `file` is omitted and stdin is a pipe, stdin is used.
+ * - Returns `undefined` when no source is provided — caller falls back to flags.
+ */
+async function readJsonPayload(file) {
+    if (file === '-' || (!file && !process.stdin.isTTY)) {
+        const chunks = [];
+        for await (const chunk of process.stdin)
+            chunks.push(chunk);
+        const raw = Buffer.concat(chunks).toString('utf-8').trim();
+        if (!raw)
+            return undefined;
+        return JSON.parse(raw);
+    }
+    if (file) {
+        const raw = fs.readFileSync(file, 'utf-8');
+        return JSON.parse(raw);
+    }
+    return undefined;
+}
+function parseCommaList(value) {
+    return value
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+function fail(error) {
+    console.error('Error:', error instanceof Error ? error.message : error);
+    process.exit(1);
+}
+/**
+ * Build the request body for `monitor create` from CLI flags.
+ *
+ * For full control, callers can pass a JSON file path positionally or pipe
+ * JSON on stdin instead. The flags cover the common scrape-target shape.
+ */
+function buildCreateBody(opts) {
+    if (!opts.name) {
+        throw new Error('--name is required (or pass a JSON file / stdin payload)');
+    }
+    if (!opts.cron && !opts.scheduleText) {
+        throw new Error('--cron or --schedule is required');
+    }
+    const hasScrape = opts.urls && opts.urls.length > 0;
+    const hasCrawl = !!opts.crawlUrl;
+    if (!hasScrape && !hasCrawl) {
+        throw new Error('Provide --scrape-urls or --crawl-url');
+    }
+    const schedule = {};
+    if (opts.cron)
+        schedule.cron = opts.cron;
+    if (opts.scheduleText)
+        schedule.text = opts.scheduleText;
+    if (opts.timezone)
+        schedule.timezone = opts.timezone;
+    const targets = [];
+    if (hasScrape)
+        targets.push({ type: 'scrape', urls: opts.urls });
+    if (hasCrawl)
+        targets.push({ type: 'crawl', url: opts.crawlUrl });
+    const body = {
+        name: opts.name,
+        schedule,
+        targets,
+    };
+    if (opts.webhookUrl) {
+        body.webhook = {
+            url: opts.webhookUrl,
+            ...(opts.webhookEvents && opts.webhookEvents.length > 0
+                ? { events: opts.webhookEvents }
+                : {}),
+        };
+    }
+    if (opts.emailRecipients && opts.emailRecipients.length > 0) {
+        body.notification = {
+            email: {
+                enabled: true,
+                recipients: opts.emailRecipients,
+            },
+        };
+    }
+    if (opts.retentionDays !== undefined)
+        body.retentionDays = opts.retentionDays;
+    return body;
+}
+function commonOptions(cmd) {
+    return cmd
+        .option('-k, --api-key <key>', 'Firecrawl API key (overrides global --api-key)')
+        .option('--api-url <url>', 'API URL (overrides global --api-url)')
+        .option('-o, --output <path>', 'Output file path (default: stdout)')
+        .option('--pretty', 'Pretty print JSON output', false);
+}
+/**
+ * Build the `firecrawl monitor` command tree.
+ */
+function createMonitorCommand() {
+    const monitor = new commander_1.Command('monitor').description('Schedule recurring scrapes/crawls and track content changes');
+    // create
+    commonOptions(monitor
+        .command('create')
+        .description('Create a monitor (flags, or JSON from file/stdin)')
+        .argument('[file]', 'Path to JSON payload (use "-" or pipe stdin to read from stdin)')
+        .option('--name <name>', 'Monitor name')
+        .option('--cron <expression>', 'Cron schedule (e.g. "*/30 * * * *")')
+        .option('--schedule <text>', 'Natural-language schedule (e.g. "every 30 minutes")')
+        .option('--timezone <tz>', 'Schedule timezone', 'UTC')
+        .option('--scrape-urls <list>', 'Comma-separated URLs to scrape on each check', parseCommaList)
+        .option('--crawl-url <url>', 'Root URL for a crawl target')
+        .option('--webhook-url <url>', 'Webhook destination')
+        .option('--webhook-events <list>', 'Comma-separated events (monitor.page, monitor.check.completed)', parseCommaList)
+        .option('--email <list>', 'Comma-separated email recipients for change notifications', parseCommaList)
+        .option('--retention-days <n>', 'Snapshot retention window', parseInt)).action(async (file, options) => {
+        try {
+            const fromJson = await readJsonPayload(file);
+            const body = fromJson ??
+                buildCreateBody({
+                    name: options.name,
+                    cron: options.cron,
+                    scheduleText: options.schedule,
+                    timezone: options.timezone,
+                    urls: options.scrapeUrls,
+                    crawlUrl: options.crawlUrl,
+                    webhookUrl: options.webhookUrl,
+                    webhookEvents: options.webhookEvents,
+                    emailRecipients: options.email,
+                    retentionDays: options.retentionDays,
+                });
+            const payload = await monitorRequest('/monitor', options, {
+                method: 'POST',
+                body,
+            });
+            emit(payload, options);
+        }
+        catch (err) {
+            fail(err);
+        }
+    });
+    // list
+    commonOptions(monitor
+        .command('list')
+        .description('List monitors')
+        .option('--limit <n>', 'Maximum results', parseInt)
+        .option('--offset <n>', 'Result offset', parseInt)).action(async (options) => {
+        try {
+            const payload = await monitorRequest('/monitor', options, {
+                query: { limit: options.limit, offset: options.offset },
+            });
+            emit(payload, options);
+        }
+        catch (err) {
+            fail(err);
+        }
+    });
+    // get
+    commonOptions(monitor
+        .command('get')
+        .description('Get a monitor by ID')
+        .argument('<monitorId>', 'Monitor ID')).action(async (monitorId, options) => {
+        try {
+            const payload = await monitorRequest(`/monitor/${encodeURIComponent(monitorId)}`, options);
+            emit(payload, options);
+        }
+        catch (err) {
+            fail(err);
+        }
+    });
+    // update
+    commonOptions(monitor
+        .command('update')
+        .description('Update a monitor (flags, or JSON from file/stdin)')
+        .argument('<monitorId>', 'Monitor ID')
+        .argument('[file]', 'Path to JSON payload (use "-" or pipe stdin to read from stdin)')
+        .option('--name <name>', 'New name')
+        .option('--cron <expression>', 'New cron schedule')
+        .option('--schedule <text>', 'New natural-language schedule')
+        .option('--timezone <tz>', 'Schedule timezone')
+        .option('--state <state>', 'active | paused')
+        .option('--retention-days <n>', 'Snapshot retention window', parseInt)).action(async (monitorId, file, options) => {
+        try {
+            const fromJson = await readJsonPayload(file);
+            let body;
+            if (fromJson) {
+                body = fromJson;
+            }
+            else {
+                body = {};
+                if (options.name)
+                    body.name = options.name;
+                if (options.state)
+                    body.status = options.state;
+                if (options.retentionDays !== undefined)
+                    body.retentionDays = options.retentionDays;
+                if (options.cron || options.schedule || options.timezone) {
+                    const schedule = {};
+                    if (options.cron)
+                        schedule.cron = options.cron;
+                    if (options.schedule)
+                        schedule.text = options.schedule;
+                    if (options.timezone)
+                        schedule.timezone = options.timezone;
+                    body.schedule = schedule;
+                }
+                if (Object.keys(body).length === 0) {
+                    throw new Error('Provide at least one field to update (or a JSON file / stdin payload)');
+                }
+            }
+            const payload = await monitorRequest(`/monitor/${encodeURIComponent(monitorId)}`, options, { method: 'PATCH', body });
+            emit(payload, options);
+        }
+        catch (err) {
+            fail(err);
+        }
+    });
+    // delete
+    commonOptions(monitor
+        .command('delete')
+        .description('Delete a monitor')
+        .argument('<monitorId>', 'Monitor ID')).action(async (monitorId, options) => {
+        try {
+            const payload = await monitorRequest(`/monitor/${encodeURIComponent(monitorId)}`, options, { method: 'DELETE' });
+            emit(payload, options);
+        }
+        catch (err) {
+            fail(err);
+        }
+    });
+    // run
+    commonOptions(monitor
+        .command('run')
+        .description('Trigger a check immediately')
+        .argument('<monitorId>', 'Monitor ID')).action(async (monitorId, options) => {
+        try {
+            const payload = await monitorRequest(`/monitor/${encodeURIComponent(monitorId)}/run`, options, { method: 'POST' });
+            emit(payload, options);
+        }
+        catch (err) {
+            fail(err);
+        }
+    });
+    // checks (list)
+    commonOptions(monitor
+        .command('checks')
+        .description('List checks for a monitor')
+        .argument('<monitorId>', 'Monitor ID')
+        .option('--limit <n>', 'Maximum results', parseInt)
+        .option('--offset <n>', 'Result offset', parseInt)).action(async (monitorId, options) => {
+        try {
+            const payload = await monitorRequest(`/monitor/${encodeURIComponent(monitorId)}/checks`, options, { query: { limit: options.limit, offset: options.offset } });
+            emit(payload, options);
+        }
+        catch (err) {
+            fail(err);
+        }
+    });
+    // check (get one)
+    commonOptions(monitor
+        .command('check')
+        .description('Get a specific check, with page-level results')
+        .argument('<monitorId>', 'Monitor ID')
+        .argument('<checkId>', 'Check ID')
+        .option('--limit <n>', 'Max page results', parseInt)
+        .option('--skip <n>', 'Skip page results', parseInt)
+        .option('--page-status <state>', 'Filter page results: same, new, changed, removed, error')).action(async (monitorId, checkId, options) => {
+        try {
+            const payload = await monitorRequest(`/monitor/${encodeURIComponent(monitorId)}/checks/${encodeURIComponent(checkId)}`, options, {
+                query: {
+                    limit: options.limit,
+                    skip: options.skip,
+                    status: options.pageStatus,
+                },
+            });
+            emit(payload, options);
+        }
+        catch (err) {
+            fail(err);
+        }
+    });
+    monitor.addHelpText('after', `
+Examples:
+  $ firecrawl monitor create --name "Blog" \\
+      --schedule "every 30 minutes" \\
+      --scrape-urls https://example.com/blog \\
+      --email alerts@example.com
+  $ firecrawl monitor create monitor.json
+  $ cat monitor.json | firecrawl monitor create
+  $ firecrawl monitor list --limit 20
+  $ firecrawl monitor get mon_abc123
+  $ firecrawl monitor update mon_abc123 --state paused
+  $ firecrawl monitor run mon_abc123
+  $ firecrawl monitor checks mon_abc123 --limit 10
+  $ firecrawl monitor check mon_abc123 chk_xyz --page-status changed
+`);
+    return monitor;
+}
+//# sourceMappingURL=monitor.js.map

package/dist/commands/monitor.js.map

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

package/dist/commands/setup.d.ts

@@ -2,7 +2,7 @@
  * Setup command implementation
  * Installs firecrawl skill files and MCP server into AI coding agents
  */
-export type SetupSubcommand = 'skills' | 'mcp';
+export type SetupSubcommand = 'skills' | 'workflows' | 'mcp';
 export interface SetupOptions {
     global?: boolean;
     agent?: string;

package/dist/commands/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,eAAe,EAC3B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAiBf"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,WAAW,GAAG,KAAK,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,eAAe,EAC3B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/dist/commands/setup.js

@@ -15,7 +15,10 @@ const skills_native_1 = require("./skills-native");
 async function handleSetupCommand(subcommand, options = {}) {
     switch (subcommand) {
         case 'skills':
-            await installSkills(options);
+            await installSkills(options, skills_install_1.SKILL_REPOS);
+            break;
+        case 'workflows':
+            await installSkills(options, skills_install_1.WORKFLOW_SKILL_REPOS);
             break;
         case 'mcp':
             await installMcp(options);
@@ -23,13 +26,14 @@ async function handleSetupCommand(subcommand, options = {}) {
         default:
             console.error(`Unknown setup subcommand: ${subcommand}`);
             console.log('\nAvailable subcommands:');
-            console.log('  skills    Install firecrawl skill into AI coding agents');
-            console.log('  mcp       Install firecrawl MCP server into editors (Cursor, Claude Code, VS Code, etc.)');
+            console.log('  skills     Install core/build Firecrawl skills into AI coding agents');
+            console.log('  workflows  Install Firecrawl workflow skills into AI coding agents');
+            console.log('  mcp        Install firecrawl MCP server into editors (Cursor, Claude Code, VS Code, etc.)');
             process.exit(1);
     }
 }
-async function installSkills(options) {
-    for (const repo of skills_install_1.SKILL_REPOS) {
+async function installSkills(options, repos) {
+    for (const repo of repos) {
         if ((0, skills_native_1.hasNpx)()) {
             const args = (0, skills_install_1.buildSkillsInstallArgs)({
                 repo,

package/dist/commands/setup.js.map

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

package/dist/commands/skills-install.d.ts

@@ -4,9 +4,17 @@
  * - firecrawl/cli: core CLI skills bundled with this repo
  * - firecrawl/skills: additional "build" skills for working with Firecrawl
  *
- * Both are installed during `firecrawl init` and `firecrawl setup skills`.
+ * Workflow skills live in a separate installable repo:
+ *
+ * - firecrawl/firecrawl-workflows: outcome-focused Firecrawl workflow skills
+ *
+ * `firecrawl init` installs both groups by default. `firecrawl setup skills`
+ * installs core/build skills, and `firecrawl setup workflows` installs workflow
+ * skills.
  */
 export declare const SKILL_REPOS: readonly ["firecrawl/cli", "firecrawl/skills"];
+export declare const WORKFLOW_SKILL_REPOS: readonly ["firecrawl/firecrawl-workflows"];
+export declare const ALL_SKILL_REPOS: readonly ["firecrawl/cli", "firecrawl/skills", "firecrawl/firecrawl-workflows"];
 export interface SkillsInstallCommandOptions {
     agent?: string;
     all?: boolean;

package/dist/commands/skills-install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills-install.d.ts","sourceRoot":"","sources":["../../src/commands/skills-install.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,gDAAiD,CAAC;AAE1E,MAAM,WAAW,2BAA2B;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,2BAAgC,GACxC,MAAM,EAAE,CA2BV;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAAC,UAAU,CAQ/C"}
+{"version":3,"file":"skills-install.d.ts","sourceRoot":"","sources":["../../src/commands/skills-install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,gDAAiD,CAAC;AAE1E,eAAO,MAAM,oBAAoB,4CAA6C,CAAC;AAE/E,eAAO,MAAM,eAAe,iFAGlB,CAAC;AAEX,MAAM,WAAW,2BAA2B;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,2BAAgC,GACxC,MAAM,EAAE,CA2BV;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAAC,UAAU,CAQ/C"}

package/dist/commands/skills-install.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SKILL_REPOS = void 0;
+exports.ALL_SKILL_REPOS = exports.WORKFLOW_SKILL_REPOS = exports.SKILL_REPOS = void 0;
 exports.buildSkillsInstallArgs = buildSkillsInstallArgs;
 exports.cleanNpmEnv = cleanNpmEnv;
 /**
@@ -9,9 +9,20 @@ exports.cleanNpmEnv = cleanNpmEnv;
  * - firecrawl/cli: core CLI skills bundled with this repo
  * - firecrawl/skills: additional "build" skills for working with Firecrawl
  *
- * Both are installed during `firecrawl init` and `firecrawl setup skills`.
+ * Workflow skills live in a separate installable repo:
+ *
+ * - firecrawl/firecrawl-workflows: outcome-focused Firecrawl workflow skills
+ *
+ * `firecrawl init` installs both groups by default. `firecrawl setup skills`
+ * installs core/build skills, and `firecrawl setup workflows` installs workflow
+ * skills.
  */
 exports.SKILL_REPOS = ['firecrawl/cli', 'firecrawl/skills'];
+exports.WORKFLOW_SKILL_REPOS = ['firecrawl/firecrawl-workflows'];
+exports.ALL_SKILL_REPOS = [
+    ...exports.SKILL_REPOS,
+    ...exports.WORKFLOW_SKILL_REPOS,
+];
 function buildSkillsInstallArgs(options = {}) {
     const args = ['npx'];
     if (options.includeNpxYes) {

package/dist/commands/skills-install.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills-install.js","sourceRoot":"","sources":["../../src/commands/skills-install.ts"],"names":[],"mappings":";;;AAoBA,wDA6BC;AAaD,kCAQC;AAtED;;;;;;;GAOG;AACU,QAAA,WAAW,GAAG,CAAC,eAAe,EAAE,kBAAkB,CAAU,CAAC;AAY1E,SAAgB,sBAAsB,CACpC,UAAuC,EAAE;IAEzC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAErB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,eAAe,EAAE,cAAc,CAAC,CAAC;IAE5E,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IACzE,IAAI,kBAAkB,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,WAAW;IACzB,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;YAC1E,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"skills-install.js","sourceRoot":"","sources":["../../src/commands/skills-install.ts"],"names":[],"mappings":";;;AAiCA,wDA6BC;AAaD,kCAQC;AAnFD;;;;;;;;;;;;;GAaG;AACU,QAAA,WAAW,GAAG,CAAC,eAAe,EAAE,kBAAkB,CAAU,CAAC;AAE7D,QAAA,oBAAoB,GAAG,CAAC,+BAA+B,CAAU,CAAC;AAElE,QAAA,eAAe,GAAG;IAC7B,GAAG,mBAAW;IACd,GAAG,4BAAoB;CACf,CAAC;AAYX,SAAgB,sBAAsB,CACpC,UAAuC,EAAE;IAEzC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAErB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,eAAe,EAAE,cAAc,CAAC,CAAC;IAE5E,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IACzE,IAAI,kBAAkB,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,WAAW;IACzB,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;YAC1E,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/index.js

@@ -50,6 +50,7 @@ const credit_usage_1 = require("./commands/credit-usage");
 const crawl_1 = require("./commands/crawl");
 const map_1 = require("./commands/map");
 const parse_1 = require("./commands/parse");
+const monitor_1 = require("./commands/monitor");
 const search_1 = require("./commands/search");
 const search_feedback_1 = require("./commands/search-feedback");
 const agent_1 = require("./commands/agent");
@@ -67,7 +68,6 @@ const options_1 = require("./utils/options");
 const job_1 = require("./utils/job");
 const auth_1 = require("./utils/auth");
 const package_json_1 = __importDefault(require("../package.json"));
-const experimental_1 = require("./commands/experimental");
 const create_1 = require("./commands/create");
 // Initialize global configuration from environment variables
 (0, config_1.initializeConfig)();
@@ -84,6 +84,7 @@ const AUTH_REQUIRED_COMMANDS = [
     'browser',
     'interact',
     'credit-usage',
+    'monitor',
 ];
 const commandSet = new Set([]);
 function collectTopLevelCommands() {
@@ -1193,6 +1194,7 @@ Examples:
 program.addCommand(createCrawlCommand());
 program.addCommand(createMapCommand());
 program.addCommand(createParseCommand());
+program.addCommand((0, monitor_1.createMonitorCommand)());
 program.addCommand(createSearchCommand());
 program.addCommand(createSearchFeedbackCommand());
 program.addCommand(createAgentCommand());
@@ -1203,17 +1205,14 @@ program.addCommand(createBrowserCommand(), { hidden: true });
 // Undocumented until `firecrawl-agent-cli` is published to npm; flip to
 // visible by removing `{ hidden: true }`.
 program.addCommand((0, create_1.createCreateCommand)(), { hidden: true });
-// Experimental: download, AI workflow commands
+// Experimental: download command
 const experimental = new commander_1.Command('experimental')
-    .description('Experimental commands (download, AI workflows)')
+    .description('Experimental commands (download)')
     .alias('x')
     .addHelpText('after', `
 Shorthand: "firecrawl x" is an alias for "firecrawl experimental".
 `);
 experimental.addCommand(createDownloadCommand());
-experimental.addCommand((0, experimental_1.createClaudeCommand)());
-experimental.addCommand((0, experimental_1.createCodexCommand)());
-experimental.addCommand((0, experimental_1.createOpenCodeCommand)());
 program.addCommand(experimental);
 program
     .command('config')
@@ -1290,8 +1289,8 @@ program
 });
 program
     .command('setup')
-    .description('Set up individual firecrawl integrations (skills, mcp)')
-    .argument('<subcommand>', 'What to set up: "skills" or "mcp"')
+    .description('Set up individual firecrawl integrations (skills, workflows, mcp)')
+    .argument('<subcommand>', 'What to set up: "skills", "workflows", or "mcp"')
     .option('-g, --global', 'Install globally (user-level)')
     .option('-a, --agent <agent>', 'Install to a specific agent')
     .action(async (subcommand, options) => {