firecrawl-cli 1.15.0 → 1.15.2

package/dist/commands/create.d.ts

@@ -1,14 +1,13 @@
 /**
  * `firecrawl create` command — scaffolds Firecrawl starter projects.
  *
- * Hidden from --help until `firecrawl-agent-cli` is published to npm.
+ * Hidden from --help until the flow is battle-tested in the wild. The
+ * scaffolder is vendored under `src/utils/agent-scaffold/` (mirrored from
+ * `firecrawl/web-agent`). At runtime it clones the public agent repo
+ * to get templates — no separate npm package for the agent CLI.
+ *
  * Once visible, the command tree will grow to include additional kinds
  * (scrape, browser, ai, app). For now, `agent` is the only kind.
- *
- * Implementation is a thin delegator: `firecrawl create agent ...` execs
- * `npx -y firecrawl-agent-cli create ...` and passes all flags through.
- * This avoids vendoring the scaffold code in the root CLI; the agent repo
- * remains the single source of truth for templates and the manifest.
  */
 import { Command } from 'commander';
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2HpC;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAQ7C"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0EpC;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAQ7C"}

package/dist/commands/create.js

@@ -2,48 +2,57 @@
 /**
  * `firecrawl create` command — scaffolds Firecrawl starter projects.
  *
- * Hidden from --help until `firecrawl-agent-cli` is published to npm.
+ * Hidden from --help until the flow is battle-tested in the wild. The
+ * scaffolder is vendored under `src/utils/agent-scaffold/` (mirrored from
+ * `firecrawl/web-agent`). At runtime it clones the public agent repo
+ * to get templates — no separate npm package for the agent CLI.
+ *
  * Once visible, the command tree will grow to include additional kinds
  * (scrape, browser, ai, app). For now, `agent` is the only kind.
- *
- * Implementation is a thin delegator: `firecrawl create agent ...` execs
- * `npx -y firecrawl-agent-cli create ...` and passes all flags through.
- * This avoids vendoring the scaffold code in the root CLI; the agent repo
- * remains the single source of truth for templates and the manifest.
  */
+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.createCreateCommand = createCreateCommand;
 const commander_1 = require("commander");
-const child_process_1 = require("child_process");
-/** npm package name of the Firecrawl Agent CLI (bin: `firecrawl-agent`). */
-const AGENT_CLI_PACKAGE = 'firecrawl-agent-cli';
-/**
- * Execute `npx -y <AGENT_CLI_PACKAGE> create ...` with inherited stdio so
- * the agent CLI's interactive prompts render in the user's terminal.
- * Resolves with the child exit code; callers forward it to `process.exit`.
- */
-function runAgentCli(args) {
-    const npx = process.platform === 'win32' ? 'npx.cmd' : 'npx';
-    return new Promise((resolve) => {
-        const child = (0, child_process_1.spawn)(npx, ['-y', AGENT_CLI_PACKAGE, 'create', ...args], {
-            stdio: 'inherit',
-            env: process.env,
-        });
-        child.on('exit', (code) => resolve(code ?? 1));
-        child.on('error', (err) => {
-            console.error(`\nFailed to launch ${AGENT_CLI_PACKAGE} via npx:`, err.message);
-            console.error(`\n  Install it directly and retry: npm install -g ${AGENT_CLI_PACKAGE}\n`);
-            resolve(1);
-        });
-    });
-}
 function collect(val, acc) {
     acc.push(val);
     return acc;
 }
 /**
- * Build the `agent` subcommand. Flag surface mirrors `firecrawl-agent create`
- * exactly — anything the downstream CLI accepts is passed through verbatim.
+ * Build the `agent` subcommand. Flag surface mirrors the upstream agent CLI.
+ * The scaffold flow itself lives in `utils/agent-scaffold/create-flow.ts`.
  */
 function createAgentSubcommand() {
     return new commander_1.Command('agent')
@@ -58,44 +67,23 @@ function createAgentSubcommand() {
         .option('--api-key <key>', 'Firecrawl API key')
         .option('--key <provider=key>', 'Provider API key (repeatable, e.g. --key anthropic=sk-...)', collect, [])
         .option('--skip-install', 'Skip npm install')
-        .allowUnknownOption() // Forward future flags without requiring a CLI update
-        .action(async (projectName, options, cmd) => {
-        const args = [];
-        if (projectName)
-            args.push(projectName);
-        // Pass through known options. Commander camelCases hyphenated flags,
-        // so we map back to the CLI-facing kebab-case form.
-        const flagMap = [
-            ['template', '-t'],
-            ['provider', '--provider'],
-            ['model', '--model'],
-            ['subAgentProvider', '--sub-agent-provider'],
-            ['subAgentModel', '--sub-agent-model'],
-            ['from', '--from'],
-            ['apiKey', '--api-key'],
-        ];
-        for (const [optKey, flag] of flagMap) {
-            const val = options[optKey];
-            if (typeof val === 'string' && val.length > 0)
-                args.push(flag, val);
-        }
-        // --key is repeatable
-        const keys = options.key;
-        if (Array.isArray(keys)) {
-            for (const k of keys) {
-                if (typeof k === 'string' && k.length > 0)
-                    args.push('--key', k);
-            }
-        }
-        if (options.skipInstall)
-            args.push('--skip-install');
-        // Forward any unknown/forward-compatible options verbatim.
-        const passthrough = cmd.args.slice(projectName ? 1 : 0);
-        for (const extra of passthrough)
-            args.push(extra);
-        const code = await runAgentCli(args);
-        if (code !== 0)
-            process.exit(code);
+        .action(async (projectName, options) => {
+        // Lazy-load the scaffolder so startup cost (inquirer, git) only hits
+        // users who actually invoke `create`. Keeps the rest of the CLI snappy.
+        const { handleCreate } = await Promise.resolve().then(() => __importStar(require('../utils/agent-scaffold/create-flow')));
+        await handleCreate(projectName, {
+            template: options.template,
+            provider: options.provider,
+            model: options.model,
+            subAgentProvider: options.subAgentProvider,
+            subAgentModel: options.subAgentModel,
+            from: options.from,
+            apiKey: options.apiKey,
+            key: Array.isArray(options.key)
+                ? options.key
+                : undefined,
+            skipInstall: options.skipInstall,
+        });
     });
 }
 /**

package/dist/commands/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAiIH,kDAQC;AAvID,yCAAoC;AACpC,iDAAsC;AAEtC,4EAA4E;AAC5E,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAEhD;;;;GAIG;AACH,SAAS,WAAW,CAAC,IAAc;IACjC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,IAAA,qBAAK,EAAC,GAAG,EAAE,CAAC,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,EAAE;YACrE,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/C,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,OAAO,CAAC,KAAK,CACX,sBAAsB,iBAAiB,WAAW,EAClD,GAAG,CAAC,OAAO,CACZ,CAAC;YACF,OAAO,CAAC,KAAK,CACX,qDAAqD,iBAAiB,IAAI,CAC3E,CAAC;YACF,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAC,GAAW,EAAE,GAAa;IACzC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB;IAC5B,OAAO,IAAI,mBAAO,CAAC,OAAO,CAAC;SACxB,WAAW,CACV,uEAAuE,CACxE;SACA,QAAQ,CAAC,gBAAgB,EAAE,wBAAwB,CAAC;SACpD,MAAM,CACL,qBAAqB,EACrB,2CAA2C,EAC3C,MAAM,CACP;SACA,MAAM,CACL,iBAAiB,EACjB,iFAAiF,CAClF;SACA,MAAM,CAAC,cAAc,EAAE,uBAAuB,CAAC;SAC/C,MAAM,CACL,2BAA2B,EAC3B,qDAAqD,CACtD;SACA,MAAM,CACL,wBAAwB,EACxB,+CAA+C,CAChD;SACA,MAAM,CACL,iBAAiB,EACjB,kEAAkE,CACnE;SACA,MAAM,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;SAC9C,MAAM,CACL,sBAAsB,EACtB,4DAA4D,EAC5D,OAAO,EACP,EAAE,CACH;SACA,MAAM,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;SAC5C,kBAAkB,EAAE,CAAC,sDAAsD;SAC3E,MAAM,CACL,KAAK,EACH,WAA+B,EAC/B,OAAgC,EAChC,GAAY,EACZ,EAAE;QACF,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,WAAW;YAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAExC,qEAAqE;QACrE,oDAAoD;QACpD,MAAM,OAAO,GAA4B;YACvC,CAAC,UAAU,EAAE,IAAI,CAAC;YAClB,CAAC,UAAU,EAAE,YAAY,CAAC;YAC1B,CAAC,OAAO,EAAE,SAAS,CAAC;YACpB,CAAC,kBAAkB,EAAE,sBAAsB,CAAC;YAC5C,CAAC,eAAe,EAAE,mBAAmB,CAAC;YACtC,CAAC,MAAM,EAAE,QAAQ,CAAC;YAClB,CAAC,QAAQ,EAAE,WAAW,CAAC;SACxB,CAAC;QACF,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAC5B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACtE,CAAC;QAED,sBAAsB;QACtB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC;QACzB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBACrB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;oBAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,WAAW;YAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAErD,2DAA2D;QAC3D,MAAM,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,KAAK,MAAM,KAAK,IAAI,WAAW;YAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAElD,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,IAAI,KAAK,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC,CACF,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB;IACjC,MAAM,GAAG,GAAG,IAAI,mBAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAC3C,sCAAsC,CACvC,CAAC;IAEF,GAAG,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAExC,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgFH,kDAQC;AAtFD,yCAAoC;AAGpC,SAAS,OAAO,CAAC,GAAW,EAAE,GAAa;IACzC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB;IAC5B,OAAO,IAAI,mBAAO,CAAC,OAAO,CAAC;SACxB,WAAW,CACV,uEAAuE,CACxE;SACA,QAAQ,CAAC,gBAAgB,EAAE,wBAAwB,CAAC;SACpD,MAAM,CACL,qBAAqB,EACrB,2CAA2C,EAC3C,MAAM,CACP;SACA,MAAM,CACL,iBAAiB,EACjB,iFAAiF,CAClF;SACA,MAAM,CAAC,cAAc,EAAE,uBAAuB,CAAC;SAC/C,MAAM,CACL,2BAA2B,EAC3B,qDAAqD,CACtD;SACA,MAAM,CACL,wBAAwB,EACxB,+CAA+C,CAChD;SACA,MAAM,CACL,iBAAiB,EACjB,kEAAkE,CACnE;SACA,MAAM,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;SAC9C,MAAM,CACL,sBAAsB,EACtB,4DAA4D,EAC5D,OAAO,EACP,EAAE,CACH;SACA,MAAM,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;SAC5C,MAAM,CACL,KAAK,EACH,WAA+B,EAC/B,OAAgD,EAChD,EAAE;QACF,qEAAqE;QACrE,wEAAwE;QACxE,MAAM,EAAE,YAAY,EAAE,GACpB,wDAAa,qCAAqC,GAAC,CAAC;QACtD,MAAM,YAAY,CAAC,WAAW,EAAE;YAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;gBAC7B,CAAC,CAAE,OAAO,CAAC,GAAgB;gBAC3B,CAAC,CAAC,SAAS;YACb,WAAW,EAAE,OAAO,CAAC,WAAkC;SACxD,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB;IACjC,MAAM,GAAG,GAAG,IAAI,mBAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAC3C,sCAAsC,CACvC,CAAC;IAEF,GAAG,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAExC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/utils/agent-scaffold/create-flow.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Vendored from firecrawl/web-agent:.internal/cli/src/commands/init.ts
+ *
+ * This is the interactive-to-non-interactive create flow. The original file
+ * also exposed a `createInitCommand` commander builder — we drop that here
+ * because the root CLI's `src/commands/create.ts` owns the command surface.
+ * `handleCreate` (renamed from `handleInit`) is what we export.
+ *
+ * Keep in sync with upstream when the create flow evolves.
+ */
+export interface CreateOptions {
+    template?: string;
+    provider?: string;
+    model?: string;
+    subAgentProvider?: string;
+    subAgentModel?: string;
+    from?: string;
+    apiKey?: string;
+    key?: string[];
+    skipInstall?: boolean;
+}
+export declare function handleCreate(rawName: string | undefined, options: CreateOptions): Promise<void>;
+//# sourceMappingURL=create-flow.d.ts.map

package/dist/utils/agent-scaffold/create-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-flow.d.ts","sourceRoot":"","sources":["../../../src/utils/agent-scaffold/create-flow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgCH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAkED,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAwZf"}