zilmate 1.3.5 → 1.6.0

package/dist/tools/osint.tool.d.ts

@@ -0,0 +1,445 @@
+export declare const usernameTools: {
+    /**
+     * Sherlock: sherlock [--timeout N] [--print-found] [--csv] [--xlsx]
+     *   --folderoutput <dir>   for multiple usernames
+     *   --output <file>        for a single username
+     *   Docs: https://sherlockproject.xyz/usage
+     */
+    runSherlock: import("ai").Tool<{
+        username: string;
+        timeout: number;
+        csv: boolean;
+        xlsx: boolean;
+        printFoundOnly: boolean;
+    }, {
+        username: string;
+        found: string[];
+        foundCount: number;
+        outputFile: string;
+        raw: string;
+    }>;
+    /**
+     * Maigret: maigret <username> [--top-sites N] [-a] [--pdf] [--html] [--csv] [--json]
+     *   --no-extracting        skip metadata extraction
+     *   --permute              generate username variants
+     *   Docs: https://github.com/soxoj/maigret
+     */
+    runMaigret: import("ai").Tool<{
+        username: string;
+        allSites: boolean;
+        permute: boolean;
+        format: "csv" | "json" | "pdf" | "html" | "txt";
+        tags?: string | undefined;
+    }, {
+        username: string;
+        outputDir: string;
+        format: "csv" | "json" | "pdf" | "html" | "txt";
+        raw: string;
+    }>;
+    /**
+     * Blackbird (p1ngul1n0): python3 blackbird.py -u <username> -e <email> [--pdf] [--csv]
+     *   Docs: https://github.com/p1ngul1n0/blackbird
+     *   Note: installed as `blackbird` CLI via pip install blackbird-osint
+     */
+    runBlackbird: import("ai").Tool<{
+        pdf: boolean;
+        csv: boolean;
+        username?: string | undefined;
+        email?: string | undefined;
+    }, {
+        username: string | undefined;
+        email: string | undefined;
+        outputFile: string;
+        raw: string;
+    }>;
+    /**
+     * Naminter: naminter <username>
+     *   Uses TLS browser impersonation — bypasses Cloudflare bot detection
+     *   Docs: https://github.com/soxoj/naminter
+     */
+    runNaminter: import("ai").Tool<{
+        username: string;
+    }, {
+        username: string;
+        outputFile: string;
+        raw: string;
+    }>;
+    /**
+     * Linkook: linkook --url <profile_url> [--depth N]
+     *   Recursively scrapes linked profiles to find alternate usernames
+     *   Docs: https://github.com/soxoj/linkook
+     */
+    runLinkook: import("ai").Tool<{
+        profileUrl: string;
+        depth: number;
+    }, {
+        profileUrl: string;
+        depth: number;
+        outputFile: string;
+        raw: string;
+    }>;
+};
+export declare const emailTools: {
+    /**
+     * Holehe: holehe [--only-used] [--no-color] <email>
+     *   Output markers: [+] = found, [-] = not found, [x] = rate limit, [!] = error
+     *   Docs: https://github.com/megadose/holehe
+     */
+    runHolehe: import("ai").Tool<{
+        email: string;
+    }, {
+        email: string;
+        found: string[];
+        foundCount: number;
+        rateLimited: string[];
+        outputFile: string;
+        raw: string;
+    }>;
+    /**
+     * Epieos: epieos <email> [--api-key KEY]
+     *   Reverse email → Google ID, profile pic, Calendar events, Maps reviews
+     *   Docs: https://epieos.com
+     */
+    runEpieos: import("ai").Tool<{
+        email: string;
+        apiKey?: string | undefined;
+    }, {
+        email: string;
+        outputFile: string;
+        raw: string;
+    }>;
+};
+export declare const phoneTools: {
+    /**
+     * PhoneInfoga: phoneinfoga scan -n <number> [--disable scanner1,scanner2]
+     *   Scanners: local, numverify (needs NUMVERIFY_API_KEY), googlesearch, ovh
+     *   Exact flag: -n or --number  (not --number as a positional)
+     *   Docs: https://sundowndev.github.io/phoneinfoga/getting-started/usage/
+     */
+    runPhoneInfoga: import("ai").Tool<{
+        phoneNumber: string;
+        disableScanners?: ("numverify" | "googlesearch" | "ovh")[] | undefined;
+    }, {
+        phoneNumber: string;
+        outputFile: string;
+        raw: string;
+    }>;
+};
+export declare const domainTools: {
+    /**
+     * theHarvester: theHarvester -d <domain> -b <sources> -l <limit> [-f <output>] [-v] [-c] [-n]
+     *   Sources: google, bing, yahoo, duckduckgo, crtsh, dnsdumpster, hackertarget,
+     *            hunter, securityTrails, shodan, virustotal, certspotter, github-code, linkedin, all
+     *   -v  verify hosts via DNS
+     *   -c  DNS brute force
+     *   -n  DNS reverse query on ranges
+     *   Docs: https://github.com/laramies/theHarvester
+     */
+    runTheHarvester: import("ai").Tool<{
+        domain: string;
+        sources: ("google" | "baidu" | "bing" | "certspotter" | "crtsh" | "dnsdumpster" | "duckduckgo" | "github-code" | "hackertarget" | "hunter" | "linkedin" | "otx" | "securityTrails" | "shodan" | "urlscan" | "virustotal" | "yahoo" | "all")[];
+        limit: number;
+        verifyDns: boolean;
+        bruteForceDns: boolean;
+    }, {
+        domain: string;
+        emails: string[];
+        hosts: string[];
+        emailCount: number;
+        hostCount: number;
+        outputFiles: {
+            xml: string;
+            json: string;
+        };
+        raw: string;
+    }>;
+    /**
+     * SpiderFoot: python3 -m spiderfoot -s <target> -o json -R <output>
+     *   Or spiderfoot CLI if installed globally
+     *   Docs: https://github.com/smicallef/spiderfoot
+     */
+    runSpiderFoot: import("ai").Tool<{
+        target: string;
+        maxRuntime: number;
+        modules?: string[] | undefined;
+    }, {
+        target: string;
+        outputFile: string;
+        raw: string;
+    }>;
+};
+export declare const forensicsTools: {
+    /**
+     * ExifTool: exiftool [-json] [-csv] [-GPS*] <file>
+     *   -json         structured JSON output (one object per file)
+     *   -GPS*         extract only GPS fields
+     *   -fast         skip tail-of-file scan (faster on large files)
+     *   Docs: https://exiftool.org
+     */
+    runExifTool: import("ai").Tool<{
+        filePath: string;
+        gpsOnly: boolean;
+    }, {
+        filePath: string;
+        metadata: Record<string, unknown> | null;
+        outputFile: string;
+    }>;
+    /**
+     * Shodan CLI: shodan host <ip> | shodan domain <domain> | shodan search <query>
+     *   Requires SHODAN_API_KEY env var (free tier works for basic host lookups)
+     *   Docs: https://cli.shodan.io
+     */
+    runShodan: import("ai").Tool<{
+        target: string;
+        type: "search" | "host" | "domain";
+        query?: string | undefined;
+    }, {
+        target: string;
+        type: "search" | "host" | "domain";
+        outputFile: string;
+        raw: string;
+    }>;
+};
+export declare const orchestrationTools: {
+    /**
+     * Master investigation entry point — chains the right tools based on what identifiers are known.
+     *
+     * Chain logic by depth:
+     *   quick    → Sherlock, Holehe, PhoneInfoga, theHarvester (fastest single-source per input type)
+     *   standard → all quick + Blackbird, ExifTool
+     *   deep     → all standard + Maigret, Linkook, SpiderFoot (thorough, slow)
+     */
+    osintInvestigation: import("ai").Tool<{
+        depth: "quick" | "standard" | "deep";
+        username?: string | undefined;
+        email?: string | undefined;
+        phone?: string | undefined;
+        domain?: string | undefined;
+        filePath?: string | undefined;
+        profileUrl?: string | undefined;
+    }, {
+        identifiers: string[];
+        depth: "quick" | "standard" | "deep";
+        toolsRun: string[];
+        outputFile: string;
+        results: Record<string, unknown>;
+    }>;
+};
+export declare const osintTools: {
+    /**
+     * Master investigation entry point — chains the right tools based on what identifiers are known.
+     *
+     * Chain logic by depth:
+     *   quick    → Sherlock, Holehe, PhoneInfoga, theHarvester (fastest single-source per input type)
+     *   standard → all quick + Blackbird, ExifTool
+     *   deep     → all standard + Maigret, Linkook, SpiderFoot (thorough, slow)
+     */
+    osintInvestigation: import("ai").Tool<{
+        depth: "quick" | "standard" | "deep";
+        username?: string | undefined;
+        email?: string | undefined;
+        phone?: string | undefined;
+        domain?: string | undefined;
+        filePath?: string | undefined;
+        profileUrl?: string | undefined;
+    }, {
+        identifiers: string[];
+        depth: "quick" | "standard" | "deep";
+        toolsRun: string[];
+        outputFile: string;
+        results: Record<string, unknown>;
+    }>;
+    /**
+     * ExifTool: exiftool [-json] [-csv] [-GPS*] <file>
+     *   -json         structured JSON output (one object per file)
+     *   -GPS*         extract only GPS fields
+     *   -fast         skip tail-of-file scan (faster on large files)
+     *   Docs: https://exiftool.org
+     */
+    runExifTool: import("ai").Tool<{
+        filePath: string;
+        gpsOnly: boolean;
+    }, {
+        filePath: string;
+        metadata: Record<string, unknown> | null;
+        outputFile: string;
+    }>;
+    /**
+     * Shodan CLI: shodan host <ip> | shodan domain <domain> | shodan search <query>
+     *   Requires SHODAN_API_KEY env var (free tier works for basic host lookups)
+     *   Docs: https://cli.shodan.io
+     */
+    runShodan: import("ai").Tool<{
+        target: string;
+        type: "search" | "host" | "domain";
+        query?: string | undefined;
+    }, {
+        target: string;
+        type: "search" | "host" | "domain";
+        outputFile: string;
+        raw: string;
+    }>;
+    /**
+     * theHarvester: theHarvester -d <domain> -b <sources> -l <limit> [-f <output>] [-v] [-c] [-n]
+     *   Sources: google, bing, yahoo, duckduckgo, crtsh, dnsdumpster, hackertarget,
+     *            hunter, securityTrails, shodan, virustotal, certspotter, github-code, linkedin, all
+     *   -v  verify hosts via DNS
+     *   -c  DNS brute force
+     *   -n  DNS reverse query on ranges
+     *   Docs: https://github.com/laramies/theHarvester
+     */
+    runTheHarvester: import("ai").Tool<{
+        domain: string;
+        sources: ("google" | "baidu" | "bing" | "certspotter" | "crtsh" | "dnsdumpster" | "duckduckgo" | "github-code" | "hackertarget" | "hunter" | "linkedin" | "otx" | "securityTrails" | "shodan" | "urlscan" | "virustotal" | "yahoo" | "all")[];
+        limit: number;
+        verifyDns: boolean;
+        bruteForceDns: boolean;
+    }, {
+        domain: string;
+        emails: string[];
+        hosts: string[];
+        emailCount: number;
+        hostCount: number;
+        outputFiles: {
+            xml: string;
+            json: string;
+        };
+        raw: string;
+    }>;
+    /**
+     * SpiderFoot: python3 -m spiderfoot -s <target> -o json -R <output>
+     *   Or spiderfoot CLI if installed globally
+     *   Docs: https://github.com/smicallef/spiderfoot
+     */
+    runSpiderFoot: import("ai").Tool<{
+        target: string;
+        maxRuntime: number;
+        modules?: string[] | undefined;
+    }, {
+        target: string;
+        outputFile: string;
+        raw: string;
+    }>;
+    /**
+     * PhoneInfoga: phoneinfoga scan -n <number> [--disable scanner1,scanner2]
+     *   Scanners: local, numverify (needs NUMVERIFY_API_KEY), googlesearch, ovh
+     *   Exact flag: -n or --number  (not --number as a positional)
+     *   Docs: https://sundowndev.github.io/phoneinfoga/getting-started/usage/
+     */
+    runPhoneInfoga: import("ai").Tool<{
+        phoneNumber: string;
+        disableScanners?: ("numverify" | "googlesearch" | "ovh")[] | undefined;
+    }, {
+        phoneNumber: string;
+        outputFile: string;
+        raw: string;
+    }>;
+    /**
+     * Holehe: holehe [--only-used] [--no-color] <email>
+     *   Output markers: [+] = found, [-] = not found, [x] = rate limit, [!] = error
+     *   Docs: https://github.com/megadose/holehe
+     */
+    runHolehe: import("ai").Tool<{
+        email: string;
+    }, {
+        email: string;
+        found: string[];
+        foundCount: number;
+        rateLimited: string[];
+        outputFile: string;
+        raw: string;
+    }>;
+    /**
+     * Epieos: epieos <email> [--api-key KEY]
+     *   Reverse email → Google ID, profile pic, Calendar events, Maps reviews
+     *   Docs: https://epieos.com
+     */
+    runEpieos: import("ai").Tool<{
+        email: string;
+        apiKey?: string | undefined;
+    }, {
+        email: string;
+        outputFile: string;
+        raw: string;
+    }>;
+    /**
+     * Sherlock: sherlock [--timeout N] [--print-found] [--csv] [--xlsx]
+     *   --folderoutput <dir>   for multiple usernames
+     *   --output <file>        for a single username
+     *   Docs: https://sherlockproject.xyz/usage
+     */
+    runSherlock: import("ai").Tool<{
+        username: string;
+        timeout: number;
+        csv: boolean;
+        xlsx: boolean;
+        printFoundOnly: boolean;
+    }, {
+        username: string;
+        found: string[];
+        foundCount: number;
+        outputFile: string;
+        raw: string;
+    }>;
+    /**
+     * Maigret: maigret <username> [--top-sites N] [-a] [--pdf] [--html] [--csv] [--json]
+     *   --no-extracting        skip metadata extraction
+     *   --permute              generate username variants
+     *   Docs: https://github.com/soxoj/maigret
+     */
+    runMaigret: import("ai").Tool<{
+        username: string;
+        allSites: boolean;
+        permute: boolean;
+        format: "csv" | "json" | "pdf" | "html" | "txt";
+        tags?: string | undefined;
+    }, {
+        username: string;
+        outputDir: string;
+        format: "csv" | "json" | "pdf" | "html" | "txt";
+        raw: string;
+    }>;
+    /**
+     * Blackbird (p1ngul1n0): python3 blackbird.py -u <username> -e <email> [--pdf] [--csv]
+     *   Docs: https://github.com/p1ngul1n0/blackbird
+     *   Note: installed as `blackbird` CLI via pip install blackbird-osint
+     */
+    runBlackbird: import("ai").Tool<{
+        pdf: boolean;
+        csv: boolean;
+        username?: string | undefined;
+        email?: string | undefined;
+    }, {
+        username: string | undefined;
+        email: string | undefined;
+        outputFile: string;
+        raw: string;
+    }>;
+    /**
+     * Naminter: naminter <username>
+     *   Uses TLS browser impersonation — bypasses Cloudflare bot detection
+     *   Docs: https://github.com/soxoj/naminter
+     */
+    runNaminter: import("ai").Tool<{
+        username: string;
+    }, {
+        username: string;
+        outputFile: string;
+        raw: string;
+    }>;
+    /**
+     * Linkook: linkook --url <profile_url> [--depth N]
+     *   Recursively scrapes linked profiles to find alternate usernames
+     *   Docs: https://github.com/soxoj/linkook
+     */
+    runLinkook: import("ai").Tool<{
+        profileUrl: string;
+        depth: number;
+    }, {
+        profileUrl: string;
+        depth: number;
+        outputFile: string;
+        raw: string;
+    }>;
+};
+//# sourceMappingURL=osint.tool.d.ts.map

package/dist/tools/osint.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"osint.tool.d.ts","sourceRoot":"","sources":["../../src/tools/osint.tool.ts"],"names":[],"mappings":"AA2DA,eAAO,MAAM,aAAa;IACxB;;;;;OAKG;;;;;;;;;;;;;;IAwCH;;;;;OAKG;;;;;;;;;;;;;IAyCH;;;;OAIG;;;;;;;;;;;;IAsCH;;;;OAIG;;;;;;;;IAsBH;;;;OAIG;;;;;;;;;;CAwBJ,CAAC;AAIF,eAAO,MAAM,UAAU;IACrB;;;;OAIG;;;;;;;;;;;IAiCH;;;;OAIG;;;;;;;;;CAwBJ,CAAC;AAIF,eAAO,MAAM,UAAU;IACrB;;;;;OAKG;;;;;;;;;CAmCJ,CAAC;AAIF,eAAO,MAAM,WAAW;IACtB;;;;;;;;OAQG;;;;;;;;;;;;;;;;;;;IAqEH;;;;OAIG;;;;;;;;;;CAiCJ,CAAC;AAIF,eAAO,MAAM,cAAc;IACzB;;;;;;OAMG;;;;;;;;;IAqCH;;;;OAIG;;;;;;;;;;;CA2CJ,CAAC;AAIF,eAAO,MAAM,kBAAkB;IAC7B;;;;;;;OAOG;;;;;;;;;;;;;;;;CA0GJ,CAAC;AAIF,eAAO,MAAM,UAAU;IArHrB;;;;;;;OAOG;;;;;;;;;;;;;;;;IAtGH;;;;;;OAMG;;;;;;;;;IAqCH;;;;OAIG;;;;;;;;;;;IAtKH;;;;;;;;OAQG;;;;;;;;;;;;;;;;;;;IAqEH;;;;OAIG;;;;;;;;;;IA9HH;;;;;OAKG;;;;;;;;;IA3EH;;;;OAIG;;;;;;;;;;;IAiCH;;;;OAIG;;;;;;;;;IAzOH;;;;;OAKG;;;;;;;;;;;;;;IAwCH;;;;;OAKG;;;;;;;;;;;;;IAyCH;;;;OAIG;;;;;;;;;;;;IAsCH;;;;OAIG;;;;;;;;IAsBH;;;;OAIG;;;;;;;;;;CAkeJ,CAAC"}