@brightdata/cli 0.1.6 → 0.1.7

package/README.md

@@ -24,6 +24,7 @@
 |---|---|
 | `brightdata scrape` | Scrape any URL — bypasses CAPTCHAs, JS rendering, anti-bot protections |
 | `brightdata search` | Google / Bing / Yandex search with structured JSON output |
+| `brightdata discover` | AI-powered web discovery - find and rank results by intent with optional full-page content |
 | `brightdata pipelines` | Extract structured data from 40+ platforms (Amazon, LinkedIn, TikTok…) |
 | `brightdata browser` | Control a real browser via Bright Data's Scraping Browser — navigate, snapshot, click, type, and more |
 | `brightdata zones` | List and inspect your Bright Data proxy zones |
@@ -44,6 +45,7 @@
   - [init](#init)
   - [scrape](#scrape)
   - [search](#search)
+  - [discover](#discover)
   - [pipelines](#pipelines)
   - [browser](#browser)
   - [status](#status)
@@ -246,6 +248,60 @@ brightdata search "bright data pricing" --engine bing
 
 ---
 
+### `discover`
+
+AI-powered web discovery. Submit a query with optional intent, and Bright Data finds, ranks, and optionally extracts full-page content for each result.
+
+```bash
+brightdata discover <query> [options]
+```
+
+| Flag | Description |
+|---|---|
+| `--intent <text>` | AI intent to evaluate and rank result relevance |
+| `--country <code>` | ISO country code (default: `US`) |
+| `--city <name>` | City for localized results (e.g. `"New York"`) |
+| `--language <code>` | Language code (default: `en`) |
+| `--num-results <n>` | Number of results to return |
+| `--filter-keywords <words>` | Comma-separated keywords that must appear in results |
+| `--include-content` | Include full page content in each result |
+| `--no-remove-duplicates` | Keep duplicate results |
+| `--start-date <date>` | Only content updated from date (`YYYY-MM-DD`) |
+| `--end-date <date>` | Only content updated until date (`YYYY-MM-DD`) |
+| `--timeout <seconds>` | Polling timeout (default: `600`) |
+| `-o, --output <path>` | Write output to file |
+| `--json` / `--pretty` | JSON output (raw / indented) |
+| `-k, --api-key <key>` | Override API key |
+
+**Examples**
+
+```bash
+# Basic discovery — table output
+brightdata discover "AI trends"
+
+# With AI intent for relevance ranking
+brightdata discover "AI trends" \
+  --intent "Prioritize institutional reports for VC research"
+
+# Include full page content as markdown
+brightdata discover "AI trends" --include-content --num-results 5
+
+# Geo-targeted with date range
+brightdata discover "best restaurants" --country US --city "New York" \
+  --start-date 2025-01-01 --end-date 2025-12-31
+
+# Filter results by keywords
+brightdata discover "generative AI SaaS" --filter-keywords "revenue,SaaS"
+
+# JSON output to file
+brightdata discover "AI trends" --num-results 10 --pretty -o results.json
+
+# Pipe-friendly — redirected stdout outputs JSON automatically
+brightdata discover "AI trends" --include-content --num-results 3 > results.json
+```
+
+---
+
 ### `pipelines`
 
 Extract structured data from 40+ platforms using Bright Data's Web Scraper API. Triggers an async collection job, polls until ready, and returns results.

package/dist/__tests__/commands/discover.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=discover.test.d.ts.map

package/dist/__tests__/commands/discover.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/commands/discover.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/commands/discover.test.js

@@ -0,0 +1,220 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const mocks = vitest_1.vi.hoisted(() => ({
+    post: vitest_1.vi.fn(),
+    get: vitest_1.vi.fn(),
+    ensure_authenticated: vitest_1.vi.fn(),
+    stop: vitest_1.vi.fn(),
+    start: vitest_1.vi.fn(),
+    print: vitest_1.vi.fn(),
+    print_table: vitest_1.vi.fn(),
+    fail: vitest_1.vi.fn((msg) => { throw new Error(`fail:${msg}`); }),
+    dim: vitest_1.vi.fn((msg) => msg),
+    parse_timeout: vitest_1.vi.fn(),
+    poll_until: vitest_1.vi.fn(),
+}));
+vitest_1.vi.mock('../../utils/client', () => ({
+    post: mocks.post,
+    get: mocks.get,
+}));
+vitest_1.vi.mock('../../utils/auth', () => ({
+    ensure_authenticated: mocks.ensure_authenticated,
+}));
+vitest_1.vi.mock('../../utils/spinner', () => ({
+    start: mocks.start,
+}));
+vitest_1.vi.mock('../../utils/output', () => ({
+    print: mocks.print,
+    print_table: mocks.print_table,
+    fail: mocks.fail,
+    dim: mocks.dim,
+}));
+vitest_1.vi.mock('../../utils/polling', () => ({
+    parse_timeout: mocks.parse_timeout,
+    poll_until: mocks.poll_until,
+}));
+const discover_1 = require("../../commands/discover");
+(0, vitest_1.describe)('commands/discover', () => {
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.clearAllMocks();
+        mocks.ensure_authenticated.mockReturnValue('api_key');
+        mocks.parse_timeout.mockReturnValue(600);
+        mocks.start.mockReturnValue({ stop: mocks.stop });
+    });
+    (0, vitest_1.describe)('build_request', () => {
+        (0, vitest_1.it)('builds minimal request with only query', () => {
+            const req = (0, discover_1.build_request)('AI trends', {});
+            (0, vitest_1.expect)(req).toEqual({ query: 'AI trends' });
+        });
+        (0, vitest_1.it)('includes all optional params', () => {
+            const req = (0, discover_1.build_request)('AI trends', {
+                intent: 'find research papers',
+                city: 'New York',
+                country: 'US',
+                language: 'en',
+                numResults: '10',
+                filterKeywords: 'AI, machine learning',
+                includeContent: true,
+                startDate: '2025-01-01',
+                endDate: '2025-12-31',
+            });
+            (0, vitest_1.expect)(req).toEqual({
+                query: 'AI trends',
+                intent: 'find research papers',
+                city: 'New York',
+                country: 'US',
+                language: 'en',
+                num_results: 10,
+                filter_keywords: ['AI', 'machine learning'],
+                include_content: true,
+                start_date: '2025-01-01',
+                end_date: '2025-12-31',
+            });
+        });
+        (0, vitest_1.it)('parses comma-separated filter keywords with whitespace', () => {
+            const req = (0, discover_1.build_request)('q', { filterKeywords: ' a , b , c ' });
+            (0, vitest_1.expect)(req.filter_keywords).toEqual(['a', 'b', 'c']);
+        });
+        (0, vitest_1.it)('does not set format by default (API returns JSON)', () => {
+            const req = (0, discover_1.build_request)('test', {});
+            (0, vitest_1.expect)(req.format).toBeUndefined();
+        });
+        (0, vitest_1.it)('does not set format when include-content is used', () => {
+            const req = (0, discover_1.build_request)('test', { includeContent: true });
+            (0, vitest_1.expect)(req.format).toBeUndefined();
+            (0, vitest_1.expect)(req.include_content).toBe(true);
+        });
+    });
+    (0, vitest_1.describe)('extract_status', () => {
+        (0, vitest_1.it)('returns status from valid response', () => {
+            (0, vitest_1.expect)((0, discover_1.extract_status)({ status: 'processing' })).toBe('processing');
+            (0, vitest_1.expect)((0, discover_1.extract_status)({ status: 'done' })).toBe('done');
+        });
+        (0, vitest_1.it)('returns undefined for invalid input', () => {
+            (0, vitest_1.expect)((0, discover_1.extract_status)(null)).toBeUndefined();
+            (0, vitest_1.expect)((0, discover_1.extract_status)(undefined)).toBeUndefined();
+        });
+    });
+    (0, vitest_1.describe)('format_markdown', () => {
+        (0, vitest_1.it)('formats results as markdown', () => {
+            const md = (0, discover_1.format_markdown)([
+                {
+                    link: 'https://example.com',
+                    title: 'Example',
+                    description: 'A description',
+                    relevance_score: 0.95,
+                },
+            ], 'test query');
+            (0, vitest_1.expect)(md).toContain('# Discover results for "test query"');
+            (0, vitest_1.expect)(md).toContain('**1. [Example](https://example.com)** (95.0%)');
+            (0, vitest_1.expect)(md).toContain('A description');
+        });
+        (0, vitest_1.it)('includes content when present', () => {
+            const md = (0, discover_1.format_markdown)([
+                {
+                    link: 'https://example.com',
+                    title: 'Example',
+                    description: 'Desc',
+                    relevance_score: 0.5,
+                    content: '# Page content here',
+                },
+            ], 'q');
+            (0, vitest_1.expect)(md).toContain('# Page content here');
+        });
+    });
+    (0, vitest_1.describe)('print_discover_table', () => {
+        (0, vitest_1.it)('calls print_table with formatted rows', () => {
+            const results = [
+                {
+                    link: 'https://example.com',
+                    title: 'Example Title',
+                    description: 'Desc',
+                    relevance_score: 0.98184747,
+                },
+            ];
+            (0, discover_1.print_discover_table)(results);
+            (0, vitest_1.expect)(mocks.print_table).toHaveBeenCalledWith([{
+                    '#': '1',
+                    title: 'Example Title',
+                    score: '98.2%',
+                    url: 'https://example.com',
+                }], ['#', 'title', 'score', 'url']);
+        });
+        (0, vitest_1.it)('prints dim message when no results', () => {
+            const log = vitest_1.vi.spyOn(console, 'log').mockImplementation(() => { });
+            (0, discover_1.print_discover_table)([]);
+            (0, vitest_1.expect)(log).toHaveBeenCalled();
+            (0, vitest_1.expect)(mocks.print_table).not.toHaveBeenCalled();
+            log.mockRestore();
+        });
+    });
+    (0, vitest_1.describe)('handle_discover', () => {
+        (0, vitest_1.it)('triggers and polls then prints table', async () => {
+            mocks.post.mockResolvedValue({ status: 'ok', task_id: 'abc123' });
+            mocks.poll_until.mockResolvedValue({
+                result: {
+                    status: 'done',
+                    duration_seconds: 5,
+                    results: [
+                        {
+                            link: 'https://example.com',
+                            title: 'Result',
+                            description: 'Desc',
+                            relevance_score: 0.9,
+                        },
+                    ],
+                },
+                attempts: 3,
+            });
+            await (0, discover_1.handle_discover)('AI trends', {});
+            (0, vitest_1.expect)(mocks.post).toHaveBeenCalledWith('api_key', '/discover', { query: 'AI trends' }, { timing: undefined });
+            (0, vitest_1.expect)(mocks.poll_until).toHaveBeenCalledTimes(1);
+            (0, vitest_1.expect)(mocks.print_table).toHaveBeenCalledTimes(1);
+        });
+        (0, vitest_1.it)('prints json when --json is set', async () => {
+            const response = {
+                status: 'done',
+                duration_seconds: 2,
+                results: [{
+                        link: 'https://example.com',
+                        title: 'R',
+                        description: 'D',
+                        relevance_score: 0.8,
+                    }],
+            };
+            mocks.post.mockResolvedValue({ status: 'ok', task_id: 't1' });
+            mocks.poll_until.mockResolvedValue({ result: response, attempts: 1 });
+            await (0, discover_1.handle_discover)('q', { json: true });
+            (0, vitest_1.expect)(mocks.print).toHaveBeenCalledWith(response, { json: true, pretty: undefined, output: undefined });
+            (0, vitest_1.expect)(mocks.print_table).not.toHaveBeenCalled();
+        });
+        (0, vitest_1.it)('prints raw JSON when --output is set', async () => {
+            const response = {
+                status: 'done',
+                results: [{
+                        link: 'https://example.com',
+                        title: 'R',
+                        description: 'D',
+                        relevance_score: 0.7,
+                    }],
+            };
+            mocks.post.mockResolvedValue({ status: 'ok', task_id: 't2' });
+            mocks.poll_until.mockResolvedValue({ result: response, attempts: 1 });
+            await (0, discover_1.handle_discover)('q', { output: 'out.json' });
+            (0, vitest_1.expect)(mocks.print).toHaveBeenCalledWith(response, { json: undefined, pretty: undefined, output: 'out.json' });
+        });
+        (0, vitest_1.it)('fails when trigger returns no task_id', async () => {
+            mocks.post.mockResolvedValue({ status: 'ok' });
+            const exit = vitest_1.vi.spyOn(process, 'exit')
+                .mockImplementation(() => undefined);
+            const error = vitest_1.vi.spyOn(console, 'error')
+                .mockImplementation(() => { });
+            await (0, discover_1.handle_discover)('q', {});
+            (0, vitest_1.expect)(mocks.fail).toHaveBeenCalled();
+            exit.mockRestore();
+            error.mockRestore();
+        });
+    });
+});
+//# sourceMappingURL=discover.test.js.map

package/dist/__tests__/commands/discover.test.js.map

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

package/dist/commands/discover.d.ts

@@ -0,0 +1,10 @@
+import { Command } from 'commander';
+import type { Discover_request, Discover_result, Discover_poll_response, Discover_opts } from '../types/discover';
+declare const build_request: (query: string, opts: Discover_opts) => Discover_request;
+declare const format_markdown: (results: Discover_result[], query: string) => string;
+declare const print_discover_table: (results: Discover_result[]) => void;
+declare const extract_status: (result: Discover_poll_response) => string | undefined;
+declare const handle_discover: (query: string, opts: Discover_opts) => Promise<void>;
+declare const discover_command: Command;
+export { discover_command, handle_discover, build_request, extract_status, format_markdown, print_discover_table };
+//# sourceMappingURL=discover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/commands/discover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAMlC,OAAO,KAAK,EACR,gBAAgB,EAEhB,eAAe,EACf,sBAAsB,EACtB,aAAa,EAChB,MAAM,mBAAmB,CAAC;AAK3B,QAAA,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,MAAM,aAAa,KAAG,gBAyB3D,CAAC;AAEF,QAAA,MAAM,eAAe,GACjB,SAAS,eAAe,EAAE,EAC1B,OAAO,MAAM,KACd,MAqBF,CAAC;AAEF,QAAA,MAAM,oBAAoB,GAAI,SAAS,eAAe,EAAE,SAavD,CAAC;AAEF,QAAA,MAAM,cAAc,GAAI,QAAQ,sBAAsB,KAAG,MAAM,GAAC,SAI/D,CAAC;AAEF,QAAA,MAAM,eAAe,GAAS,OAAO,MAAM,EAAE,MAAM,aAAa,kBAoE/D,CAAC;AAEF,QAAA,MAAM,gBAAgB,SAuBM,CAAC;AAE7B,OAAO,EAAC,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EACpE,eAAe,EAAE,oBAAoB,EAAC,CAAC"}

package/dist/commands/discover.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.print_discover_table = exports.format_markdown = exports.extract_status = exports.build_request = exports.handle_discover = exports.discover_command = void 0;
+const commander_1 = require("commander");
+const client_1 = require("../utils/client");
+const auth_1 = require("../utils/auth");
+const spinner_1 = require("../utils/spinner");
+const polling_1 = require("../utils/polling");
+const output_1 = require("../utils/output");
+const ENDPOINT = '/discover';
+const RUNNING_STATUSES = ['processing'];
+const build_request = (query, opts) => {
+    const req = { query };
+    if (opts.intent)
+        req.intent = opts.intent;
+    if (opts.city)
+        req.city = opts.city;
+    if (opts.country)
+        req.country = opts.country;
+    if (opts.language)
+        req.language = opts.language;
+    if (opts.numResults)
+        req.num_results = +opts.numResults;
+    if (opts.filterKeywords)
+        req.filter_keywords = opts.filterKeywords.split(',').map(k => k.trim());
+    if (opts.includeContent) {
+        req.include_content = true;
+    }
+    if (opts.removeDuplicates === false)
+        req.remove_duplicates = false;
+    if (opts.startDate)
+        req.start_date = opts.startDate;
+    if (opts.endDate)
+        req.end_date = opts.endDate;
+    return req;
+};
+exports.build_request = build_request;
+const format_markdown = (results, query) => {
+    const lines = [];
+    lines.push(`# Discover results for "${query}"`);
+    lines.push(`_${results.length} results_`);
+    lines.push('');
+    for (let i = 0; i < results.length; i++) {
+        const r = results[i];
+        const score = (r.relevance_score * 100).toFixed(1);
+        lines.push(`**${i + 1}. [${r.title}](${r.link})** (${score}%)`);
+        if (r.description)
+            lines.push(r.description);
+        lines.push(`<${r.link}>`);
+        if (r.content) {
+            lines.push('');
+            lines.push(r.content);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+};
+exports.format_markdown = format_markdown;
+const print_discover_table = (results) => {
+    if (!results.length) {
+        console.log((0, output_1.dim)('No results found.'));
+        return;
+    }
+    const rows = results.map((r, i) => ({
+        '#': String(i + 1),
+        title: (r.title ?? '').slice(0, 50),
+        score: (r.relevance_score * 100).toFixed(1) + '%',
+        url: (r.link ?? '').slice(0, 60),
+    }));
+    (0, output_1.print_table)(rows, ['#', 'title', 'score', 'url']);
+};
+exports.print_discover_table = print_discover_table;
+const extract_status = (result) => {
+    if (!result || typeof result != 'object')
+        return undefined;
+    return result.status;
+};
+exports.extract_status = extract_status;
+const handle_discover = async (query, opts) => {
+    const api_key = (0, auth_1.ensure_authenticated)(opts.apiKey);
+    let timeout = 600;
+    try {
+        timeout = (0, polling_1.parse_timeout)(opts.timeout);
+    }
+    catch (e) {
+        (0, output_1.fail)(e.message);
+        return;
+    }
+    const body = build_request(query, opts);
+    const spinner = (0, spinner_1.start)(`Discovering results for "${query}"...`);
+    try {
+        const trigger = await (0, client_1.post)(api_key, ENDPOINT, body, { timing: opts.timing });
+        const task_id = trigger.task_id;
+        if (!task_id) {
+            spinner.stop();
+            (0, output_1.fail)('Failed to trigger discover (missing task_id).');
+            return;
+        }
+        spinner.stop();
+        console.error((0, output_1.dim)(`Task submitted: ${task_id}`));
+        const poll_spinner = (0, spinner_1.start)('Waiting for results...');
+        const poll_result = await (0, polling_1.poll_until)({
+            timeout_seconds: timeout,
+            fetch_once: () => (0, client_1.get)(api_key, `${ENDPOINT}?task_id=${task_id}`, { timing: opts.timing }),
+            get_status: extract_status,
+            running_statuses: RUNNING_STATUSES,
+            timeout_label: 'discover results',
+            on_running: ({ attempt, timeout_seconds, status }) => {
+                console.error((0, output_1.dim)(`Status: ${status} — polling `
+                    + `(attempt ${attempt}/${timeout_seconds})`));
+            },
+        });
+        poll_spinner.stop();
+        const response = poll_result.result;
+        const results = response.results ?? [];
+        if (response.duration_seconds != null) {
+            console.error((0, output_1.dim)(`Done in ${response.duration_seconds}s `
+                + `(${poll_result.attempts} poll attempts)`));
+        }
+        const print_opts = { json: opts.json, pretty: opts.pretty,
+            output: opts.output };
+        if (opts.json || opts.pretty || opts.output || !output_1.is_tty) {
+            (0, output_1.print)(response, print_opts);
+            return;
+        }
+        print_discover_table(results);
+    }
+    catch (e) {
+        spinner.stop();
+        console.error(e.message);
+        process.exit(1);
+    }
+};
+exports.handle_discover = handle_discover;
+const discover_command = new commander_1.Command('discover')
+    .description('Search and rank web results using AI-driven intent')
+    .argument('<query>', 'Search query')
+    .option('--intent <text>', 'AI intent to evaluate and rank result relevance')
+    .option('--country <code>', 'ISO country code for localized results (default: US)')
+    .option('--city <name>', 'City for localized results (e.g. "New York")')
+    .option('--language <code>', 'Language code (default: en)')
+    .option('--num-results <n>', 'Number of results to return')
+    .option('--filter-keywords <words>', 'Comma-separated keywords that must appear in results')
+    .option('--include-content', 'Include page content in markdown format')
+    .option('--no-remove-duplicates', 'Keep duplicate results')
+    .option('--start-date <date>', 'Only content updated from date (YYYY-MM-DD)')
+    .option('--end-date <date>', 'Only content updated until date (YYYY-MM-DD)')
+    .option('--timeout <seconds>', 'Polling timeout in seconds (default: 600)')
+    .option('-o, --output <path>', 'Write output to file')
+    .option('--json', 'Force JSON output')
+    .option('--pretty', 'Pretty-print JSON output')
+    .option('--timing', 'Show request timing')
+    .option('-k, --api-key <key>', 'Override API key')
+    .action(handle_discover);
+exports.discover_command = discover_command;
+//# sourceMappingURL=discover.js.map

package/dist/commands/discover.js.map

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

package/dist/index.js

@@ -20,6 +20,7 @@ const skill_1 = require("./commands/skill");
 const budget_1 = require("./commands/budget");
 const browser_1 = require("./commands/browser");
 const add_mcp_1 = require("./commands/add-mcp");
+const discover_1 = require("./commands/discover");
 const package_json_1 = __importDefault(require("../package.json"));
 const build_program = () => {
     const program = new commander_1.Command();
@@ -46,6 +47,7 @@ const build_program = () => {
     program.addCommand(skill_1.skill_command);
     program.addCommand(budget_1.budget_command);
     program.addCommand(browser_1.browser_command);
+    program.addCommand(discover_1.discover_command);
     program.addCommand(add_command);
     return program;
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AACA,yCAAkC;AAClC,qDAA8D;AAC9D,4CAA+C;AAC/C,8CAAiD;AACjD,8CAAiD;AACjD,8CAAiD;AACjD,gDAAqD;AACrD,8CAAiD;AACjD,4CAA+C;AAC/C,8CAAiD;AACjD,0CAA6C;AAC7C,gDAAmD;AACnD,4CAA+C;AAC/C,8CAAiD;AACjD,gDAAmD;AACnD,gDAAmD;AACnD,mEAA0C;AAE1C,MAAM,aAAa,GAAG,GAAE,EAAE;IACtB,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAC9B,MAAM,WAAW,GAAG,IAAI,mBAAO,CAAC,KAAK,CAAC;SACjC,WAAW,CAAC,yDAAyD,CAAC;SACtE,UAAU,CAAC,yBAAe,CAAC,CAAC;IAEjC,OAAO;SACF,IAAI,CAAC,YAAY,CAAC;SAClB,WAAW,CACR,0DAA0D;UACzD,oEAAoE,CACxE;SACA,OAAO,CAAC,sBAAW,CAAC,OAAO,EAAE,eAAe,CAAC;SAC7C,MAAM,CAAC,qBAAqB,EAAE,4CAA4C,CAAC;SAC3E,MAAM,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;IAE/C,OAAO,CAAC,UAAU,CAAC,qBAAa,CAAC,CAAC;IAClC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,2BAAiB,CAAC,CAAC;IACtC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,qBAAa,CAAC,CAAC;IAClC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,mBAAY,CAAC,CAAC;IACjC,OAAO,CAAC,UAAU,CAAC,yBAAe,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,CAAC,qBAAa,CAAC,CAAC;IAClC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,yBAAe,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAEhC,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,IAAI,GAAG,KAAK,IAAE,EAAE;IAClB,IAAI,MAAM,IAAA,qCAAwB,GAAE;QAChC,OAAO;IACX,aAAa,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAA,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AACA,yCAAkC;AAClC,qDAA8D;AAC9D,4CAA+C;AAC/C,8CAAiD;AACjD,8CAAiD;AACjD,8CAAiD;AACjD,gDAAqD;AACrD,8CAAiD;AACjD,4CAA+C;AAC/C,8CAAiD;AACjD,0CAA6C;AAC7C,gDAAmD;AACnD,4CAA+C;AAC/C,8CAAiD;AACjD,gDAAmD;AACnD,gDAAmD;AACnD,kDAAqD;AACrD,mEAA0C;AAE1C,MAAM,aAAa,GAAG,GAAE,EAAE;IACtB,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAC9B,MAAM,WAAW,GAAG,IAAI,mBAAO,CAAC,KAAK,CAAC;SACjC,WAAW,CAAC,yDAAyD,CAAC;SACtE,UAAU,CAAC,yBAAe,CAAC,CAAC;IAEjC,OAAO;SACF,IAAI,CAAC,YAAY,CAAC;SAClB,WAAW,CACR,0DAA0D;UACzD,oEAAoE,CACxE;SACA,OAAO,CAAC,sBAAW,CAAC,OAAO,EAAE,eAAe,CAAC;SAC7C,MAAM,CAAC,qBAAqB,EAAE,4CAA4C,CAAC;SAC3E,MAAM,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;IAE/C,OAAO,CAAC,UAAU,CAAC,qBAAa,CAAC,CAAC;IAClC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,2BAAiB,CAAC,CAAC;IACtC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,qBAAa,CAAC,CAAC;IAClC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,mBAAY,CAAC,CAAC;IACjC,OAAO,CAAC,UAAU,CAAC,yBAAe,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,CAAC,qBAAa,CAAC,CAAC;IAClC,OAAO,CAAC,UAAU,CAAC,uBAAc,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,yBAAe,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,CAAC,2BAAgB,CAAC,CAAC;IACrC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAEhC,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,IAAI,GAAG,KAAK,IAAE,EAAE;IAClB,IAAI,MAAM,IAAA,qCAAwB,GAAE;QAChC,OAAO;IACX,aAAa,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAA,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/types/discover.d.ts

@@ -0,0 +1,50 @@
+type Discover_request = {
+    query: string;
+    intent?: string;
+    city?: string;
+    country?: string;
+    filter_keywords?: string[];
+    format?: 'json' | 'md';
+    include_content?: boolean;
+    language?: string;
+    num_results?: number;
+    remove_duplicates?: boolean;
+    start_date?: string;
+    end_date?: string;
+};
+type Discover_trigger_response = {
+    status: string;
+    task_id: string;
+};
+type Discover_result = {
+    link: string;
+    title: string;
+    description: string;
+    relevance_score: number;
+    content?: string | null;
+};
+type Discover_poll_response = {
+    status: string;
+    duration_seconds?: number;
+    results?: Discover_result[];
+};
+type Discover_opts = {
+    intent?: string;
+    city?: string;
+    country?: string;
+    language?: string;
+    numResults?: string;
+    filterKeywords?: string;
+    includeContent?: boolean;
+    removeDuplicates?: boolean;
+    startDate?: string;
+    endDate?: string;
+    timeout?: string;
+    output?: string;
+    json?: boolean;
+    pretty?: boolean;
+    timing?: boolean;
+    apiKey?: string;
+};
+export type { Discover_request, Discover_trigger_response, Discover_result, Discover_poll_response, Discover_opts, };
+//# sourceMappingURL=discover.d.ts.map

package/dist/types/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/types/discover.ts"],"names":[],"mappings":"AAAA,KAAK,gBAAgB,GAAG;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAC,IAAI,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,KAAK,yBAAyB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,eAAe,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAC,IAAI,CAAC;CACzB,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;CAC/B,CAAC;AAEF,KAAK,aAAa,GAAG;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,YAAY,EACR,gBAAgB,EAChB,yBAAyB,EACzB,eAAe,EACf,sBAAsB,EACtB,aAAa,GAChB,CAAC"}

package/dist/types/discover.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=discover.js.map

package/dist/types/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../src/types/discover.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@brightdata/cli",
-    "version": "0.1.6",
+    "version": "0.1.7",
     "description": "Command-line interface for Bright Data. Scrape, search, extract structured data, and automate browsers directly from your terminal.",
     "main": "dist/index.js",
     "bin": {