openplanter 0.1.2 → 0.2.0

package/dist/investigation-tools/sec-tools.d.ts

@@ -0,0 +1,75 @@
+/**
+ * sec-tools.ts — SEC EDGAR tools for insider trades and company filings.
+ *
+ * Tools: sec_form4_parser, sec_edgar_filer, sec_whistleblower_awards
+ */
+import { type Provenance } from "./shared-crypto.js";
+export interface Form4Transaction {
+    filerName: string;
+    filerCik: string;
+    issuerName: string;
+    issuerTicker: string;
+    transactionDate: string;
+    transactionCode: string;
+    sharesTraded: number;
+    pricePerShare: number;
+    totalValue: number;
+    sharesOwnedAfter: number;
+    directOrIndirect: string;
+    filingDate: string;
+    accessionNumber: string;
+    url: string;
+}
+export interface Form4Result {
+    transactions: Form4Transaction[];
+    total: number;
+    provenance: Provenance;
+}
+export interface EdgarFiling {
+    accessionNumber: string;
+    formType: string;
+    filingDate: string;
+    acceptanceDate: string;
+    company: string;
+    cik: string;
+    description: string;
+    url: string;
+    size: number;
+}
+export interface EdgarResult {
+    filings: EdgarFiling[];
+    total: number;
+    provenance: Provenance;
+}
+export interface WhistleblowerAward {
+    date: string;
+    amount: number;
+    description: string;
+    caseType: string;
+}
+export interface WhistleblowerResult {
+    awards: WhistleblowerAward[];
+    totalAmount: number;
+    provenance: Provenance;
+}
+export declare function parseForm4(opts: {
+    ticker?: string;
+    cik?: string;
+    filerName?: string;
+    daysBack?: number;
+    limit?: number;
+    test?: boolean;
+}): Promise<Form4Result>;
+export declare function searchEdgarFilings(opts: {
+    query: string;
+    formType?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    limit?: number;
+    test?: boolean;
+}): Promise<EdgarResult>;
+export declare function fetchWhistleblowerAwards(opts: {
+    year?: number;
+    test?: boolean;
+}): Promise<WhistleblowerResult>;
+//# sourceMappingURL=sec-tools.d.ts.map

package/dist/investigation-tools/sec-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sec-tools.d.ts","sourceRoot":"","sources":["../../src/investigation-tools/sec-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;CACxB;AAiED,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,WAAW,CAAC,CAiEvB;AAID,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,WAAW,CAAC,CA+BvB;AAID,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAkC/B"}

package/dist/investigation-tools/sec-tools.js

@@ -0,0 +1,192 @@
+/**
+ * sec-tools.ts — SEC EDGAR tools for insider trades and company filings.
+ *
+ * Tools: sec_form4_parser, sec_edgar_filer, sec_whistleblower_awards
+ */
+import { fetchJson, fetchHtml } from "./shared.js";
+import { makeProvenance } from "./shared-crypto.js";
+// ── Constants ────────────────────────────────────────────────────
+const EDGAR_BASE = "https://efts.sec.gov/LATEST";
+const EDGAR_FULL_TEXT = "https://efts.sec.gov/LATEST/search-index";
+const EDGAR_FILINGS = "https://www.sec.gov/cgi-bin/browse-edgar";
+const SEC_USER_AGENT = "OpenPlanter/0.1 (research@openplanter.dev)";
+const FORM4_CODES = {
+    P: "Purchase", S: "Sale", A: "Grant/Award", D: "Disposition",
+    F: "Tax Withholding", M: "Exercise/Conversion", C: "Conversion",
+    G: "Gift", J: "Other", I: "Discretionary", X: "Exercise",
+};
+const MOCK_FORM4 = {
+    transactions: [
+        {
+            filerName: "John C. Smith", filerCik: "0001234567",
+            issuerName: "TechCorp Inc", issuerTicker: "TCOR",
+            transactionDate: "2026-02-15", transactionCode: "S",
+            sharesTraded: 50000, pricePerShare: 45.20, totalValue: 2_260_000,
+            sharesOwnedAfter: 150000, directOrIndirect: "D",
+            filingDate: "2026-02-17", accessionNumber: "0001234567-26-000042",
+            url: "https://www.sec.gov/Archives/edgar/data/0001234567/000123456726000042/form4.xml",
+        },
+        {
+            filerName: "Jane A. Director", filerCik: "0009876543",
+            issuerName: "TechCorp Inc", issuerTicker: "TCOR",
+            transactionDate: "2026-02-14", transactionCode: "P",
+            sharesTraded: 25000, pricePerShare: 43.80, totalValue: 1_095_000,
+            sharesOwnedAfter: 275000, directOrIndirect: "D",
+            filingDate: "2026-02-16", accessionNumber: "0009876543-26-000015",
+            url: "https://www.sec.gov/Archives/edgar/data/0009876543/000987654326000015/form4.xml",
+        },
+    ],
+    total: 2,
+    provenance: makeProvenance("sec_edgar", "test://mock", ["test_mode"]),
+};
+const MOCK_FILINGS = {
+    filings: [
+        {
+            accessionNumber: "0001234567-26-000100", formType: "10-K",
+            filingDate: "2026-02-10", acceptanceDate: "2026-02-10T16:30:00Z",
+            company: "TechCorp Inc", cik: "0001234567",
+            description: "Annual report for fiscal year 2025",
+            url: "https://www.sec.gov/Archives/edgar/data/0001234567/000123456726000100/tcor-20251231.htm",
+            size: 4_200_000,
+        },
+    ],
+    total: 1,
+    provenance: makeProvenance("sec_edgar", "test://mock", ["test_mode"]),
+};
+const MOCK_WHISTLEBLOWER = {
+    awards: [
+        { date: "2026-01-15", amount: 28_000_000, description: "Award for securities fraud tip", caseType: "Securities Fraud" },
+    ],
+    totalAmount: 28_000_000,
+    provenance: makeProvenance("sec_whistleblower", "test://mock", ["test_mode"]),
+};
+// ── sec_form4_parser ─────────────────────────────────────────────
+export async function parseForm4(opts) {
+    if (opts.test)
+        return MOCK_FORM4;
+    const params = new URLSearchParams();
+    params.set("forms", "4");
+    params.set("dateRange", "custom");
+    const endDate = new Date();
+    const startDate = new Date();
+    startDate.setDate(startDate.getDate() - (opts.daysBack ?? 30));
+    params.set("startdt", startDate.toISOString().slice(0, 10));
+    params.set("enddt", endDate.toISOString().slice(0, 10));
+    if (opts.ticker)
+        params.set("q", opts.ticker);
+    if (opts.cik)
+        params.set("q", opts.cik);
+    const url = `${EDGAR_BASE}/search-index?${params}`;
+    const headers = { "User-Agent": SEC_USER_AGENT, Accept: "application/json" };
+    const resp = await fetch(url, { headers });
+    if (!resp.ok) {
+        const fullTextUrl = `https://efts.sec.gov/LATEST/search-index?q=%22${opts.ticker ?? opts.cik ?? ""}%22&forms=4&dateRange=custom&startdt=${startDate.toISOString().slice(0, 10)}&enddt=${endDate.toISOString().slice(0, 10)}`;
+        const resp2 = await fetch(fullTextUrl, { headers });
+        if (!resp2.ok)
+            throw new Error(`SEC EDGAR search failed: HTTP ${resp2.status}`);
+    }
+    const eftsUrl = `https://efts.sec.gov/LATEST/search-index?q=%22${encodeURIComponent(opts.ticker ?? opts.cik ?? "")}%22&forms=4`;
+    let data;
+    try {
+        data = await fetchJson(eftsUrl, { delay: 0.5 });
+    }
+    catch {
+        data = {};
+    }
+    const hits = (data.hits ?? { hits: [] });
+    const filingEntries = Array.isArray(hits.hits) ? hits.hits : [];
+    const transactions = [];
+    for (const entry of filingEntries.slice(0, opts.limit ?? 50)) {
+        const source = (entry._source ?? {});
+        const names = String(source.display_names ?? source.entity_name ?? "");
+        const ticker = String(source.display_tickers ?? opts.ticker ?? "");
+        transactions.push({
+            filerName: names,
+            filerCik: String(source.entity_id ?? ""),
+            issuerName: String(source.display_names ?? ""),
+            issuerTicker: ticker.replace(/[[\]"]/g, "").trim(),
+            transactionDate: String(source.file_date ?? source.period_of_report ?? ""),
+            transactionCode: "S",
+            sharesTraded: 0,
+            pricePerShare: 0,
+            totalValue: 0,
+            sharesOwnedAfter: 0,
+            directOrIndirect: "D",
+            filingDate: String(source.file_date ?? ""),
+            accessionNumber: String(source.file_num ?? entry._id ?? ""),
+            url: `https://www.sec.gov/cgi-bin/viewer?action=view&cik=${source.entity_id}&type=4`,
+        });
+    }
+    return {
+        transactions,
+        total: transactions.length,
+        provenance: makeProvenance("sec_edgar", eftsUrl),
+    };
+}
+// ── sec_edgar_filer ──────────────────────────────────────────────
+export async function searchEdgarFilings(opts) {
+    if (opts.test)
+        return MOCK_FILINGS;
+    const params = new URLSearchParams();
+    params.set("q", opts.query);
+    if (opts.formType)
+        params.set("forms", opts.formType);
+    if (opts.dateFrom)
+        params.set("startdt", opts.dateFrom);
+    if (opts.dateTo)
+        params.set("enddt", opts.dateTo);
+    const url = `${EDGAR_BASE}/search-index?${params}`;
+    const data = await fetchJson(url, { delay: 0.5 });
+    const hits = (data.hits ?? { hits: [] });
+    const entries = Array.isArray(hits.hits) ? hits.hits : [];
+    const filings = entries.slice(0, opts.limit ?? 50).map((entry) => {
+        const s = (entry._source ?? {});
+        return {
+            accessionNumber: String(entry._id ?? ""),
+            formType: String(s.form_type ?? s.file_type ?? ""),
+            filingDate: String(s.file_date ?? ""),
+            acceptanceDate: String(s.file_date ?? ""),
+            company: String(s.display_names ?? s.entity_name ?? ""),
+            cik: String(s.entity_id ?? ""),
+            description: String(s.file_description ?? ""),
+            url: `https://www.sec.gov/cgi-bin/viewer?action=view&cik=${s.entity_id}`,
+            size: 0,
+        };
+    });
+    return { filings, total: filings.length, provenance: makeProvenance("sec_edgar", url) };
+}
+// ── sec_whistleblower_awards ─────────────────────────────────────
+export async function fetchWhistleblowerAwards(opts) {
+    if (opts.test)
+        return MOCK_WHISTLEBLOWER;
+    const year = opts.year ?? new Date().getFullYear();
+    const url = `https://www.sec.gov/whistleblower/pressreleases`;
+    try {
+        const $ = await fetchHtml(url, { delay: 1.0 });
+        const awards = [];
+        $("table tbody tr, .press-release-content li").each((_, el) => {
+            const text = $(el).text().trim();
+            const amountMatch = text.match(/\$([0-9,.]+)\s*(million|billion)?/i);
+            const dateMatch = text.match(/(\w+ \d{1,2},? \d{4})/);
+            if (amountMatch) {
+                let amount = parseFloat(amountMatch[1].replace(/,/g, ""));
+                if (amountMatch[2]?.toLowerCase() === "million")
+                    amount *= 1_000_000;
+                if (amountMatch[2]?.toLowerCase() === "billion")
+                    amount *= 1_000_000_000;
+                awards.push({
+                    date: dateMatch ? dateMatch[1] : "",
+                    amount,
+                    description: text.slice(0, 200),
+                    caseType: text.includes("fraud") ? "Fraud" : "Other",
+                });
+            }
+        });
+        const totalAmount = awards.reduce((sum, a) => sum + a.amount, 0);
+        return { awards, totalAmount, provenance: makeProvenance("sec_whistleblower", url) };
+    }
+    catch {
+        return { awards: [], totalAmount: 0, provenance: makeProvenance("sec_whistleblower", url, ["fetch_failed"]) };
+    }
+}
+//# sourceMappingURL=sec-tools.js.map

package/dist/investigation-tools/sec-tools.js.map

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

package/dist/investigation-tools/shared-crypto.d.ts

@@ -0,0 +1,50 @@
+/**
+ * shared-crypto.ts — Shared utilities for blockchain, prediction market, and crypto investigation tools.
+ */
+export interface Provenance {
+    source: string;
+    url?: string;
+    fetchedAt: string;
+    transforms?: string[];
+}
+export declare function makeProvenance(source: string, url?: string, transforms?: string[]): Provenance;
+export interface ConfidenceScore {
+    score: number;
+    factors: string[];
+}
+export declare function computeConfidence(factors: Array<[string, number]>): ConfidenceScore;
+export interface PaginatedResult<T> {
+    items: T[];
+    totalFetched: number;
+    hasMore: boolean;
+    nextCursor?: string;
+}
+export declare function fetchPaginated<T>(buildUrl: (cursor?: string) => string, extractItems: (data: unknown) => T[], extractCursor: (data: unknown) => string | undefined, opts?: {
+    maxPages?: number;
+    delay?: number;
+}): Promise<PaginatedResult<T>>;
+export declare function isValidEvmAddress(address: string): boolean;
+export declare function shortenAddress(address: string): string;
+export declare function normalizeAddress(address: string): string;
+export declare function weiToEth(wei: string | bigint): number;
+export declare function usdcToUsd(amount: string | bigint, decimals?: number): number;
+export declare function batchFetch<T>(urls: string[], parser: (resp: Response) => Promise<T>, opts?: {
+    concurrency?: number;
+    delay?: number;
+}): Promise<Array<{
+    url: string;
+    result: T | null;
+    error?: string;
+}>>;
+export declare function scrapeHtml(url: string, opts?: {
+    delay?: number;
+    userAgent?: string;
+}): Promise<import("cheerio").CheerioAPI>;
+export declare function zScore(values: number[], index: number, window: number): number | null;
+export declare function rollingMean(values: number[], index: number, window: number): number | null;
+export declare function percentChange(from: number, to: number): number;
+export declare function mockResponse<T>(data: T, source: string): {
+    data: T;
+    provenance: Provenance;
+};
+//# sourceMappingURL=shared-crypto.d.ts.map

package/dist/investigation-tools/shared-crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-crypto.d.ts","sourceRoot":"","sources":["../../src/investigation-tools/shared-crypto.ts"],"names":[],"mappings":"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"}

package/dist/investigation-tools/shared-crypto.js

@@ -0,0 +1,122 @@
+/**
+ * shared-crypto.ts — Shared utilities for blockchain, prediction market, and crypto investigation tools.
+ */
+import { fetchJson, fetchWithDelay, isoNow } from "./shared.js";
+import { load as cheerioLoad } from "cheerio";
+export function makeProvenance(source, url, transforms) {
+    return { source, url, fetchedAt: isoNow(), transforms };
+}
+export function computeConfidence(factors) {
+    if (factors.length === 0)
+        return { score: 0, factors: [] };
+    const total = factors.reduce((sum, [, v]) => sum + v, 0);
+    const score = Math.min(100, Math.max(0, Math.round(total / factors.length)));
+    return { score, factors: factors.map(([f]) => f) };
+}
+export async function fetchPaginated(buildUrl, extractItems, extractCursor, opts = {}) {
+    const maxPages = opts.maxPages ?? 10;
+    const delay = opts.delay ?? 1.0;
+    const items = [];
+    let cursor;
+    let hasMore = false;
+    for (let page = 0; page < maxPages; page++) {
+        const url = buildUrl(cursor);
+        const data = await fetchJson(url, { delay });
+        const pageItems = extractItems(data);
+        items.push(...pageItems);
+        cursor = extractCursor(data);
+        if (!cursor || pageItems.length === 0)
+            break;
+        if (page === maxPages - 1)
+            hasMore = true;
+    }
+    return { items, totalFetched: items.length, hasMore, nextCursor: cursor };
+}
+// ── Ethereum / Polygon Address Utilities ────────────────────────
+export function isValidEvmAddress(address) {
+    return /^0x[0-9a-fA-F]{40}$/.test(address);
+}
+export function shortenAddress(address) {
+    if (address.length < 12)
+        return address;
+    return `${address.slice(0, 6)}...${address.slice(-4)}`;
+}
+export function normalizeAddress(address) {
+    return address.toLowerCase().trim();
+}
+export function weiToEth(wei) {
+    const val = typeof wei === "string" ? BigInt(wei) : wei;
+    return Number(val) / 1e18;
+}
+export function usdcToUsd(amount, decimals = 6) {
+    const val = typeof amount === "string" ? BigInt(amount) : amount;
+    return Number(val) / 10 ** decimals;
+}
+// ── Rate-Limited Batch Fetch ────────────────────────────────────
+export async function batchFetch(urls, parser, opts = {}) {
+    const concurrency = opts.concurrency ?? 3;
+    const delay = opts.delay ?? 0.5;
+    const results = [];
+    const queue = [...urls];
+    while (queue.length > 0) {
+        const batch = queue.splice(0, concurrency);
+        const promises = batch.map(async (url) => {
+            try {
+                const resp = await fetchWithDelay(url, { delay });
+                if (!resp.ok)
+                    return { url, result: null, error: `HTTP ${resp.status}` };
+                const data = await parser(resp);
+                return { url, result: data };
+            }
+            catch (err) {
+                return { url, result: null, error: String(err) };
+            }
+        });
+        const batchResults = await Promise.all(promises);
+        results.push(...batchResults);
+    }
+    return results;
+}
+// ── HTML Scrape Helper ──────────────────────────────────────────
+export async function scrapeHtml(url, opts = {}) {
+    const resp = await fetchWithDelay(url, opts);
+    if (!resp.ok)
+        throw new Error(`HTTP ${resp.status} fetching ${url}`);
+    const html = await resp.text();
+    return cheerioLoad(html);
+}
+// ── Time Series Utilities ───────────────────────────────────────
+export function zScore(values, index, window) {
+    const start = Math.max(0, index - window);
+    const slice = values.slice(start, index);
+    if (slice.length < 2)
+        return null;
+    const mean = slice.reduce((a, b) => a + b, 0) / slice.length;
+    const variance = slice.reduce((a, v) => a + (v - mean) ** 2, 0) / (slice.length - 1);
+    const std = Math.sqrt(variance);
+    if (std === 0)
+        return 0;
+    return (values[index] - mean) / std;
+}
+export function rollingMean(values, index, window) {
+    const start = Math.max(0, index - window + 1);
+    if (index - start + 1 < window)
+        return null;
+    let sum = 0;
+    for (let i = start; i <= index; i++)
+        sum += values[i];
+    return sum / window;
+}
+export function percentChange(from, to) {
+    if (from === 0)
+        return 0;
+    return ((to - from) / Math.abs(from)) * 100;
+}
+// ── Test Mode Mock Data Helpers ─────────────────────────────────
+export function mockResponse(data, source) {
+    return {
+        data,
+        provenance: makeProvenance(source, "test://mock", ["test_mode"]),
+    };
+}
+//# sourceMappingURL=shared-crypto.js.map

package/dist/investigation-tools/shared-crypto.js.map

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

package/dist/investigation-tools/social-intelligence.d.ts

@@ -0,0 +1,91 @@
+/**
+ * social-intelligence.ts — Social media intelligence and sentiment tools.
+ *
+ * Tools: twitter_market_mentions, reddit_wsb_scanner, discord_channel_scraper,
+ *        telegram_channel_monitor, news_sentiment_fetcher, substack_scraper
+ */
+import { type Provenance } from "./shared-crypto.js";
+export interface SocialPost {
+    platform: string;
+    author: string;
+    content: string;
+    timestamp: string;
+    url: string;
+    sentiment: number;
+    sentimentLabel: string;
+    isRumor: boolean;
+    engagement: {
+        likes: number;
+        reposts: number;
+        replies: number;
+    };
+    tickers: string[];
+    keywords: string[];
+}
+export interface SocialResult {
+    posts: SocialPost[];
+    total: number;
+    avgSentiment: number;
+    rumorCount: number;
+    provenance: Provenance;
+}
+export interface NewsArticle {
+    title: string;
+    source: string;
+    url: string;
+    publishedAt: string;
+    summary: string;
+    sentiment: number;
+    sentimentLabel: string;
+    relevanceScore: number;
+    tickers: string[];
+}
+export interface NewsResult {
+    articles: NewsArticle[];
+    total: number;
+    avgSentiment: number;
+    provenance: Provenance;
+}
+export declare function searchTwitterMentions(opts: {
+    query: string;
+    ticker?: string;
+    daysBack?: number;
+    limit?: number;
+    test?: boolean;
+}): Promise<SocialResult>;
+export declare function scanRedditWsb(opts: {
+    ticker?: string;
+    subreddit?: string;
+    sort?: string;
+    limit?: number;
+    test?: boolean;
+}): Promise<SocialResult>;
+export declare function scrapeDiscord(opts: {
+    serverId?: string;
+    channelId?: string;
+    webhookUrl?: string;
+    keyword?: string;
+    limit?: number;
+    test?: boolean;
+}): Promise<SocialResult>;
+export declare function monitorTelegram(opts: {
+    channelName: string;
+    keyword?: string;
+    limit?: number;
+    test?: boolean;
+}): Promise<SocialResult>;
+export declare function fetchNewsSentiment(opts: {
+    query: string;
+    ticker?: string;
+    daysBack?: number;
+    sources?: string[];
+    limit?: number;
+    test?: boolean;
+}): Promise<NewsResult>;
+export declare function scrapeSubstack(opts: {
+    publication: string;
+    keyword?: string;
+    limit?: number;
+    test?: boolean;
+}): Promise<NewsResult>;
+//# sourceMappingURL=social-intelligence.d.ts.map

package/dist/investigation-tools/social-intelligence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"social-intelligence.d.ts","sourceRoot":"","sources":["../../src/investigation-tools/social-intelligence.ts"],"names":[],"mappings":"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"}