clodds 1.1.0

package/dist/ledger/storage.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Trade Ledger - Database Storage
+ *
+ * Persistence layer for decision records.
+ */
+import type { DecisionRecord, DecisionOutcomeData, ListDecisionsOptions, LedgerStats, ConfidenceCalibration, StatsOptions } from './types';
+export interface LedgerDb {
+    run(sql: string, params?: unknown[]): void;
+    get<T>(sql: string, params?: unknown[]): T | undefined;
+    all<T>(sql: string, params?: unknown[]): T[];
+}
+export declare const LEDGER_SCHEMA = "\n  CREATE TABLE IF NOT EXISTS trade_ledger (\n    id TEXT PRIMARY KEY,\n    user_id TEXT NOT NULL,\n    session_id TEXT,\n    timestamp INTEGER NOT NULL,\n    category TEXT NOT NULL,\n    action TEXT NOT NULL,\n    platform TEXT,\n    market_id TEXT,\n    inputs TEXT,\n    analysis TEXT,\n    constraints TEXT,\n    confidence INTEGER,\n    decision TEXT NOT NULL,\n    reason TEXT,\n    outcome TEXT,\n    pnl REAL,\n    accurate INTEGER,\n    hash TEXT,\n    anchor_tx TEXT\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_ledger_user_timestamp ON trade_ledger(user_id, timestamp DESC);\n  CREATE INDEX IF NOT EXISTS idx_ledger_category ON trade_ledger(category);\n  CREATE INDEX IF NOT EXISTS idx_ledger_decision ON trade_ledger(decision);\n\n  CREATE TABLE IF NOT EXISTS ledger_constraints (\n    id TEXT PRIMARY KEY,\n    ledger_id TEXT NOT NULL,\n    type TEXT NOT NULL,\n    rule TEXT NOT NULL,\n    threshold REAL,\n    actual REAL,\n    passed INTEGER NOT NULL,\n    violation TEXT,\n    metadata TEXT,\n    FOREIGN KEY (ledger_id) REFERENCES trade_ledger(id) ON DELETE CASCADE\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_constraints_ledger ON ledger_constraints(ledger_id);\n";
+export declare class LedgerStorage {
+    private db;
+    constructor(db: LedgerDb);
+    /**
+     * Initialize schema
+     */
+    init(): void;
+    /**
+     * Capture a new decision
+     */
+    capture(record: Omit<DecisionRecord, 'id' | 'timestamp' | 'hash'>, options?: {
+        hashIntegrity?: boolean;
+    }): string;
+    /**
+     * Update with outcome after execution
+     */
+    updateOutcome(id: string, outcome: DecisionOutcomeData): void;
+    /**
+     * Get a single decision by ID
+     */
+    get(id: string): DecisionRecord | null;
+    /**
+     * List decisions for a user
+     */
+    list(userId: string, options?: ListDecisionsOptions): DecisionRecord[];
+    /**
+     * Get statistics for a user
+     */
+    stats(userId: string, options?: StatsOptions): LedgerStats;
+    /**
+     * Get confidence calibration data
+     */
+    calibration(userId: string): ConfidenceCalibration;
+    /**
+     * Prune old records
+     */
+    prune(retentionDays: number): number;
+    /**
+     * Export decisions to JSON or CSV
+     */
+    export(userId: string, format: 'json' | 'csv'): string;
+    private rowToRecord;
+    private periodToTimestamp;
+    private calculateCalibration;
+}

package/dist/ledger/storage.js

@@ -0,0 +1,368 @@
+"use strict";
+/**
+ * Trade Ledger - Database Storage
+ *
+ * Persistence layer for decision records.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LedgerStorage = exports.LEDGER_SCHEMA = void 0;
+const crypto_1 = require("crypto");
+const hash_1 = require("./hash");
+// =============================================================================
+// SCHEMA
+// =============================================================================
+exports.LEDGER_SCHEMA = `
+  CREATE TABLE IF NOT EXISTS trade_ledger (
+    id TEXT PRIMARY KEY,
+    user_id TEXT NOT NULL,
+    session_id TEXT,
+    timestamp INTEGER NOT NULL,
+    category TEXT NOT NULL,
+    action TEXT NOT NULL,
+    platform TEXT,
+    market_id TEXT,
+    inputs TEXT,
+    analysis TEXT,
+    constraints TEXT,
+    confidence INTEGER,
+    decision TEXT NOT NULL,
+    reason TEXT,
+    outcome TEXT,
+    pnl REAL,
+    accurate INTEGER,
+    hash TEXT,
+    anchor_tx TEXT
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_ledger_user_timestamp ON trade_ledger(user_id, timestamp DESC);
+  CREATE INDEX IF NOT EXISTS idx_ledger_category ON trade_ledger(category);
+  CREATE INDEX IF NOT EXISTS idx_ledger_decision ON trade_ledger(decision);
+
+  CREATE TABLE IF NOT EXISTS ledger_constraints (
+    id TEXT PRIMARY KEY,
+    ledger_id TEXT NOT NULL,
+    type TEXT NOT NULL,
+    rule TEXT NOT NULL,
+    threshold REAL,
+    actual REAL,
+    passed INTEGER NOT NULL,
+    violation TEXT,
+    metadata TEXT,
+    FOREIGN KEY (ledger_id) REFERENCES trade_ledger(id) ON DELETE CASCADE
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_constraints_ledger ON ledger_constraints(ledger_id);
+`;
+// =============================================================================
+// STORAGE CLASS
+// =============================================================================
+class LedgerStorage {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Initialize schema
+     */
+    init() {
+        const statements = exports.LEDGER_SCHEMA.split(';').filter((s) => s.trim());
+        for (const stmt of statements) {
+            this.db.run(stmt);
+        }
+    }
+    /**
+     * Capture a new decision
+     */
+    capture(record, options) {
+        const id = (0, crypto_1.randomUUID)();
+        const timestamp = Date.now();
+        const hash = options?.hashIntegrity ? (0, hash_1.hashDecision)({ ...record, timestamp }) : undefined;
+        this.db.run(`INSERT INTO trade_ledger
+       (id, user_id, session_id, timestamp, category, action, platform, market_id,
+        inputs, analysis, constraints, confidence, decision, reason, hash)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            id,
+            record.userId,
+            record.sessionId || null,
+            timestamp,
+            record.category,
+            record.action,
+            record.platform || null,
+            record.marketId || null,
+            JSON.stringify(record.inputs),
+            record.analysis ? JSON.stringify(record.analysis) : null,
+            JSON.stringify(record.constraints),
+            record.confidence ?? null,
+            record.decision,
+            record.reason,
+            hash || null,
+        ]);
+        // Insert constraint details
+        for (const constraint of record.constraints) {
+            this.db.run(`INSERT INTO ledger_constraints
+         (id, ledger_id, type, rule, threshold, actual, passed, violation, metadata)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+                (0, crypto_1.randomUUID)(),
+                id,
+                constraint.type,
+                constraint.rule,
+                constraint.threshold ?? null,
+                constraint.actual ?? null,
+                constraint.passed ? 1 : 0,
+                constraint.violation || null,
+                constraint.metadata ? JSON.stringify(constraint.metadata) : null,
+            ]);
+        }
+        return id;
+    }
+    /**
+     * Update with outcome after execution
+     */
+    updateOutcome(id, outcome) {
+        const pnl = outcome.pnl ?? null;
+        const accurate = outcome.success !== undefined ? (outcome.success ? 1 : 0) : null;
+        this.db.run(`UPDATE trade_ledger SET outcome = ?, pnl = ?, accurate = ? WHERE id = ?`, [JSON.stringify(outcome), pnl, accurate, id]);
+    }
+    /**
+     * Get a single decision by ID
+     */
+    get(id) {
+        const row = this.db.get(`SELECT * FROM trade_ledger WHERE id = ?`, [id]);
+        if (!row)
+            return null;
+        return this.rowToRecord(row);
+    }
+    /**
+     * List decisions for a user
+     */
+    list(userId, options = {}) {
+        const { limit = 50, offset = 0, category, decision, platform, startTime, endTime } = options;
+        let sql = `SELECT * FROM trade_ledger WHERE user_id = ?`;
+        const params = [userId];
+        if (category) {
+            sql += ` AND category = ?`;
+            params.push(category);
+        }
+        if (decision) {
+            sql += ` AND decision = ?`;
+            params.push(decision);
+        }
+        if (platform) {
+            sql += ` AND platform = ?`;
+            params.push(platform);
+        }
+        if (startTime) {
+            sql += ` AND timestamp >= ?`;
+            params.push(startTime);
+        }
+        if (endTime) {
+            sql += ` AND timestamp <= ?`;
+            params.push(endTime);
+        }
+        sql += ` ORDER BY timestamp DESC LIMIT ? OFFSET ?`;
+        params.push(limit, offset);
+        const rows = this.db.all(sql, params);
+        return rows.map((row) => this.rowToRecord(row));
+    }
+    /**
+     * Get statistics for a user
+     */
+    stats(userId, options = {}) {
+        const { period = '7d', category } = options;
+        const startTime = this.periodToTimestamp(period);
+        let whereClause = `user_id = ? AND timestamp >= ?`;
+        const params = [userId, startTime];
+        if (category) {
+            whereClause += ` AND category = ?`;
+            params.push(category);
+        }
+        // Total count
+        const total = this.db.get(`SELECT COUNT(*) as count FROM trade_ledger WHERE ${whereClause}`, params)
+            ?.count || 0;
+        // Breakdown by decision
+        const breakdownRows = this.db.all(`SELECT decision, COUNT(*) as count FROM trade_ledger WHERE ${whereClause} GROUP BY decision`, params);
+        const breakdown = {
+            approved: 0,
+            rejected: 0,
+            skipped: 0,
+            blocked: 0,
+            executed: 0,
+            failed: 0,
+        };
+        for (const row of breakdownRows) {
+            if (row.decision in breakdown) {
+                breakdown[row.decision] = row.count;
+            }
+        }
+        // By category
+        const categoryRows = this.db.all(`SELECT category, COUNT(*) as count FROM trade_ledger WHERE ${whereClause} GROUP BY category`, params);
+        const byCategory = {
+            trade: 0,
+            copy: 0,
+            arbitrage: 0,
+            opportunity: 0,
+            risk: 0,
+            tool: 0,
+        };
+        for (const row of categoryRows) {
+            if (row.category in byCategory) {
+                byCategory[row.category] = row.count;
+            }
+        }
+        // Top block reasons
+        const blockReasons = this.db.all(`SELECT reason, COUNT(*) as count FROM trade_ledger
+       WHERE ${whereClause} AND decision IN ('rejected', 'blocked', 'skipped')
+       GROUP BY reason ORDER BY count DESC LIMIT 10`, params);
+        // Calibration
+        const calibration = this.calculateCalibration(userId, startTime);
+        // Average confidence
+        const avgConf = this.db.get(`SELECT AVG(confidence) as avg FROM trade_ledger WHERE ${whereClause} AND confidence IS NOT NULL`, params);
+        // P&L total
+        const pnlResult = this.db.get(`SELECT SUM(pnl) as total,
+              SUM(CASE WHEN pnl > 0 THEN 1 ELSE 0 END) as wins,
+              COUNT(*) as total_with_pnl
+       FROM trade_ledger WHERE ${whereClause} AND pnl IS NOT NULL`, params);
+        return {
+            period,
+            totalDecisions: total,
+            breakdown,
+            byCategory,
+            topBlockReasons: blockReasons.map((r) => ({ reason: r.reason, count: r.count })),
+            calibration,
+            avgConfidence: avgConf?.avg,
+            pnlTotal: pnlResult?.total,
+            winRate: pnlResult?.total_with_pnl ? (pnlResult.wins / pnlResult.total_with_pnl) * 100 : undefined,
+        };
+    }
+    /**
+     * Get confidence calibration data
+     */
+    calibration(userId) {
+        return this.calculateCalibration(userId, 0);
+    }
+    /**
+     * Prune old records
+     */
+    prune(retentionDays) {
+        const cutoff = Date.now() - retentionDays * 24 * 60 * 60 * 1000;
+        // Delete constraints first (foreign key)
+        this.db.run(`DELETE FROM ledger_constraints WHERE ledger_id IN
+       (SELECT id FROM trade_ledger WHERE timestamp < ?)`, [cutoff]);
+        const result = this.db.get(`SELECT changes() as changes FROM trade_ledger WHERE 0=1`);
+        this.db.run(`DELETE FROM trade_ledger WHERE timestamp < ?`, [cutoff]);
+        // Get actual count deleted
+        return result?.changes || 0;
+    }
+    /**
+     * Export decisions to JSON or CSV
+     */
+    export(userId, format) {
+        const records = this.list(userId, { limit: 10000 });
+        if (format === 'json') {
+            return JSON.stringify(records, null, 2);
+        }
+        // CSV format
+        const headers = [
+            'id',
+            'timestamp',
+            'category',
+            'action',
+            'platform',
+            'decision',
+            'reason',
+            'confidence',
+            'pnl',
+            'accurate',
+        ];
+        const rows = records.map((r) => [
+            r.id,
+            new Date(r.timestamp).toISOString(),
+            r.category,
+            r.action,
+            r.platform || '',
+            r.decision,
+            `"${(r.reason || '').replace(/"/g, '""')}"`,
+            r.confidence ?? '',
+            r.pnl ?? '',
+            r.accurate ?? '',
+        ]);
+        return [headers.join(','), ...rows.map((r) => r.join(','))].join('\n');
+    }
+    // =============================================================================
+    // PRIVATE HELPERS
+    // =============================================================================
+    rowToRecord(row) {
+        return {
+            id: row.id,
+            userId: row.user_id,
+            sessionId: row.session_id || undefined,
+            timestamp: row.timestamp,
+            category: row.category,
+            action: row.action,
+            platform: row.platform || undefined,
+            marketId: row.market_id || undefined,
+            inputs: JSON.parse(row.inputs),
+            analysis: row.analysis ? JSON.parse(row.analysis) : undefined,
+            constraints: JSON.parse(row.constraints),
+            confidence: row.confidence ?? undefined,
+            decision: row.decision,
+            reason: row.reason,
+            outcome: row.outcome ? JSON.parse(row.outcome) : undefined,
+            pnl: row.pnl ?? undefined,
+            accurate: row.accurate !== null ? row.accurate === 1 : undefined,
+            hash: row.hash || undefined,
+            anchorTx: row.anchor_tx || undefined,
+        };
+    }
+    periodToTimestamp(period) {
+        const now = Date.now();
+        switch (period) {
+            case '24h':
+                return now - 24 * 60 * 60 * 1000;
+            case '7d':
+                return now - 7 * 24 * 60 * 60 * 1000;
+            case '30d':
+                return now - 30 * 24 * 60 * 60 * 1000;
+            case '90d':
+                return now - 90 * 24 * 60 * 60 * 1000;
+            case 'all':
+            default:
+                return 0;
+        }
+    }
+    calculateCalibration(userId, startTime) {
+        const buckets = [
+            { range: '0-19', min: 0, max: 19, count: 0, accurate: 0, accuracyRate: 0 },
+            { range: '20-39', min: 20, max: 39, count: 0, accurate: 0, accuracyRate: 0 },
+            { range: '40-59', min: 40, max: 59, count: 0, accurate: 0, accuracyRate: 0 },
+            { range: '60-79', min: 60, max: 79, count: 0, accurate: 0, accuracyRate: 0 },
+            { range: '80-100', min: 80, max: 100, count: 0, accurate: 0, accuracyRate: 0 },
+        ];
+        const rows = this.db.all(`SELECT confidence, accurate FROM trade_ledger
+       WHERE user_id = ? AND timestamp >= ? AND confidence IS NOT NULL AND accurate IS NOT NULL`, [userId, startTime]);
+        let totalWithOutcome = 0;
+        let totalAccurate = 0;
+        for (const row of rows) {
+            const bucket = buckets.find((b) => row.confidence >= b.min && row.confidence <= b.max);
+            if (bucket) {
+                bucket.count++;
+                if (row.accurate === 1) {
+                    bucket.accurate++;
+                    totalAccurate++;
+                }
+                totalWithOutcome++;
+            }
+        }
+        // Calculate accuracy rates
+        for (const bucket of buckets) {
+            bucket.accuracyRate = bucket.count > 0 ? (bucket.accurate / bucket.count) * 100 : 0;
+        }
+        return {
+            buckets,
+            overallAccuracy: totalWithOutcome > 0 ? (totalAccurate / totalWithOutcome) * 100 : 0,
+            totalWithOutcome,
+        };
+    }
+}
+exports.LedgerStorage = LedgerStorage;
+//# sourceMappingURL=storage.js.map

package/dist/ledger/storage.js.map

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

package/dist/ledger/types.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Trade Ledger - Type Definitions
+ *
+ * Decision audit trail with confidence calibration for Clodds.
+ */
+export type DecisionCategory = 'trade' | 'copy' | 'arbitrage' | 'opportunity' | 'risk' | 'tool';
+export type DecisionOutcome = 'approved' | 'rejected' | 'skipped' | 'blocked' | 'executed' | 'failed';
+export type ConstraintType = 'max_order_size' | 'max_exposure' | 'max_position' | 'min_edge' | 'min_liquidity' | 'min_win_rate' | 'circuit_breaker' | 'daily_loss' | 'concurrent_positions' | 'feature_filter' | 'identity_check' | 'category_filter' | 'custom';
+export interface ConstraintEvaluation {
+    type: ConstraintType | string;
+    rule: string;
+    threshold?: number;
+    actual?: number;
+    passed: boolean;
+    violation?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface DecisionInputs {
+    platform?: string;
+    market?: string;
+    marketId?: string;
+    side?: 'buy' | 'sell' | 'long' | 'short';
+    size?: number;
+    price?: number;
+    address?: string;
+    toolName?: string;
+    toolParams?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface DecisionAnalysis {
+    observations?: string[];
+    factors?: Record<string, unknown>;
+    alternativesConsidered?: Array<{
+        action: string;
+        reasonRejected?: string;
+    }>;
+    modelUsed?: string;
+    [key: string]: unknown;
+}
+export interface DecisionOutcomeData {
+    success?: boolean;
+    orderId?: string;
+    filledSize?: number;
+    avgPrice?: number;
+    pnl?: number;
+    error?: string;
+    txHash?: string;
+    [key: string]: unknown;
+}
+export interface DecisionRecord {
+    id: string;
+    userId: string;
+    sessionId?: string;
+    timestamp: number;
+    category: DecisionCategory;
+    action: string;
+    platform?: string;
+    marketId?: string;
+    inputs: DecisionInputs;
+    analysis?: DecisionAnalysis;
+    constraints: ConstraintEvaluation[];
+    confidence?: number;
+    decision: DecisionOutcome;
+    reason: string;
+    outcome?: DecisionOutcomeData;
+    pnl?: number;
+    accurate?: boolean;
+    hash?: string;
+    anchorTx?: string;
+}
+export interface ConfidenceBucket {
+    range: string;
+    min: number;
+    max: number;
+    count: number;
+    accurate: number;
+    accuracyRate: number;
+}
+export interface ConfidenceCalibration {
+    buckets: ConfidenceBucket[];
+    overallAccuracy: number;
+    totalWithOutcome: number;
+}
+export interface DecisionBreakdown {
+    approved: number;
+    rejected: number;
+    skipped: number;
+    blocked: number;
+    executed: number;
+    failed: number;
+}
+export interface TopBlockReason {
+    reason: string;
+    count: number;
+}
+export interface LedgerStats {
+    period: string;
+    totalDecisions: number;
+    breakdown: DecisionBreakdown;
+    byCategory: Record<DecisionCategory, number>;
+    topBlockReasons: TopBlockReason[];
+    calibration: ConfidenceCalibration;
+    avgConfidence?: number;
+    pnlTotal?: number;
+    winRate?: number;
+}
+export interface LedgerConfig {
+    enabled: boolean;
+    captureAll: boolean;
+    hashIntegrity: boolean;
+    retentionDays: number;
+    onchainAnchor: boolean;
+    anchorChain?: 'solana' | 'polygon' | 'base';
+}
+export declare const DEFAULT_LEDGER_CONFIG: LedgerConfig;
+export interface ListDecisionsOptions {
+    limit?: number;
+    offset?: number;
+    category?: DecisionCategory;
+    decision?: DecisionOutcome;
+    platform?: string;
+    startTime?: number;
+    endTime?: number;
+}
+export interface StatsOptions {
+    period?: '24h' | '7d' | '30d' | '90d' | 'all';
+    category?: DecisionCategory;
+}
+export interface LedgerService {
+    capture(record: Omit<DecisionRecord, 'id' | 'timestamp' | 'hash'>): Promise<string>;
+    updateOutcome(id: string, outcome: DecisionOutcomeData): Promise<void>;
+    get(id: string): Promise<DecisionRecord | null>;
+    list(userId: string, options?: ListDecisionsOptions): Promise<DecisionRecord[]>;
+    stats(userId: string, options?: StatsOptions): Promise<LedgerStats>;
+    calibration(userId: string): Promise<ConfidenceCalibration>;
+    prune(retentionDays: number): Promise<number>;
+    export(userId: string, format: 'json' | 'csv'): Promise<string>;
+}

package/dist/ledger/types.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Trade Ledger - Type Definitions
+ *
+ * Decision audit trail with confidence calibration for Clodds.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_LEDGER_CONFIG = void 0;
+exports.DEFAULT_LEDGER_CONFIG = {
+    enabled: false,
+    captureAll: false,
+    hashIntegrity: false,
+    retentionDays: 90,
+    onchainAnchor: false,
+};
+//# sourceMappingURL=types.js.map

package/dist/ledger/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ledger/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AA8KU,QAAA,qBAAqB,GAAiB;IACjD,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,KAAK;IACjB,aAAa,EAAE,KAAK;IACpB,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,KAAK;CACrB,CAAC"}

package/dist/link-understanding/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Link Understanding Module - Clawdbot-style URL metadata extraction
+ *
+ * Features:
+ * - Extract OpenGraph metadata
+ * - Twitter Card support
+ * - Favicon extraction
+ * - Content type detection
+ * - Preview generation
+ */
+export interface LinkMetadata {
+    url: string;
+    finalUrl?: string;
+    title?: string;
+    description?: string;
+    image?: string;
+    favicon?: string;
+    siteName?: string;
+    type?: string;
+    author?: string;
+    publishedTime?: string;
+    contentType?: string;
+    charset?: string;
+    twitterCard?: string;
+    twitterSite?: string;
+    twitterCreator?: string;
+    keywords?: string[];
+    locale?: string;
+    videoUrl?: string;
+    audioUrl?: string;
+}
+export interface LinkPreview {
+    url: string;
+    title: string;
+    description?: string;
+    image?: string;
+    siteName?: string;
+    favicon?: string;
+}
+export interface FetchOptions {
+    timeout?: number;
+    maxRedirects?: number;
+    userAgent?: string;
+    followRedirects?: boolean;
+}
+/** Extract metadata from a URL */
+export declare function extractMetadata(url: string, options?: FetchOptions): Promise<LinkMetadata>;
+/** Generate a preview for a URL */
+export declare function generatePreview(url: string, options?: FetchOptions): Promise<LinkPreview>;
+/** Check if a URL is valid and accessible */
+export declare function checkUrl(url: string, options?: FetchOptions): Promise<{
+    valid: boolean;
+    status?: number;
+    error?: string;
+}>;
+/** Extract all URLs from text */
+export declare function extractUrls(text: string): string[];
+/** Check if text contains URLs */
+export declare function hasUrls(text: string): boolean;
+/** Expand shortened URLs */
+export declare function expandUrl(shortUrl: string, options?: FetchOptions): Promise<string>;