@antseed/node 0.1.0

package/dist/metering/usage-aggregator.js

@@ -0,0 +1,170 @@
+/**
+ * Aggregates session metrics into time-period summaries.
+ */
+export class UsageAggregator {
+    /**
+     * Aggregate a list of session metrics into time-period buckets.
+     *
+     * @param sessions - Session metrics to aggregate
+     * @param granularity - Time period granularity
+     * @param topPeerCount - Number of top peers to include (default: 5)
+     * @returns Array of UsageAggregate, one per period that has data
+     */
+    aggregate(sessions, granularity, topPeerCount = 5) {
+        if (sessions.length === 0)
+            return [];
+        // Group sessions by period
+        const buckets = new Map();
+        for (const session of sessions) {
+            const period = this.getPeriod(session.startedAt, granularity);
+            const key = `${period.start}`;
+            const bucket = buckets.get(key);
+            if (bucket) {
+                bucket.push(session);
+            }
+            else {
+                buckets.set(key, [session]);
+            }
+        }
+        // Build aggregates
+        const aggregates = [];
+        for (const [_key, bucketSessions] of buckets) {
+            const period = this.getPeriod(bucketSessions[0].startedAt, granularity);
+            aggregates.push(this.buildAggregate(bucketSessions, period, granularity, topPeerCount));
+        }
+        // Sort by period start
+        aggregates.sort((a, b) => a.periodStart - b.periodStart);
+        return aggregates;
+    }
+    /**
+     * Get the time period that a timestamp falls into.
+     */
+    getPeriod(timestamp, granularity) {
+        const date = new Date(timestamp);
+        switch (granularity) {
+            case 'daily': {
+                const start = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate()));
+                const end = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate() + 1));
+                return { start: start.getTime(), end: end.getTime() };
+            }
+            case 'weekly': {
+                // Monday 00:00 UTC to next Monday 00:00 UTC
+                const dayOfWeek = date.getUTCDay();
+                // getUTCDay() returns 0 for Sunday, 1 for Monday, etc.
+                // We want Monday as the start, so offset: Monday=0, Tue=1, ..., Sun=6
+                const daysFromMonday = dayOfWeek === 0 ? 6 : dayOfWeek - 1;
+                const monday = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate() - daysFromMonday));
+                const nextMonday = new Date(monday.getTime() + 7 * 24 * 60 * 60 * 1000);
+                return { start: monday.getTime(), end: nextMonday.getTime() };
+            }
+            case 'monthly': {
+                const start = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), 1));
+                const end = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth() + 1, 1));
+                return { start: start.getTime(), end: end.getTime() };
+            }
+        }
+    }
+    /**
+     * Get aggregates for a specific date range.
+     *
+     * @param sessions - All available session metrics
+     * @param startDate - Start of range (ms since epoch)
+     * @param endDate - End of range (ms since epoch)
+     * @param granularity - Bucket granularity
+     * @param topPeerCount - Number of top peers to include (default: 5)
+     */
+    aggregateRange(sessions, startDate, endDate, granularity, topPeerCount = 5) {
+        const filtered = sessions.filter((s) => s.startedAt >= startDate && s.startedAt < endDate);
+        return this.aggregate(filtered, granularity, topPeerCount);
+    }
+    /**
+     * Get a single aggregate for all-time usage.
+     */
+    aggregateAll(sessions) {
+        if (sessions.length === 0) {
+            return {
+                periodStart: 0,
+                periodEnd: 0,
+                granularity: 'monthly',
+                totalSessions: 0,
+                totalRequests: 0,
+                totalTokens: 0,
+                totalCostCents: 0,
+                byProvider: {},
+                topPeers: [],
+            };
+        }
+        let minStart = Infinity;
+        let maxEnd = -Infinity;
+        for (const s of sessions) {
+            if (s.startedAt < minStart)
+                minStart = s.startedAt;
+            const end = s.endedAt ?? s.startedAt;
+            if (end > maxEnd)
+                maxEnd = end;
+        }
+        return this.buildAggregate(sessions, { start: minStart, end: maxEnd }, 'monthly', sessions.length // Include all peers in all-time view
+        );
+    }
+    /**
+     * Build a single UsageAggregate from a list of sessions.
+     */
+    buildAggregate(sessions, period, granularity, topPeerCount) {
+        const byProvider = {};
+        const peerMap = new Map();
+        let totalRequests = 0;
+        let totalTokens = 0;
+        let totalCostCents = 0;
+        for (const session of sessions) {
+            totalRequests += session.totalRequests;
+            totalTokens += session.totalTokens;
+            totalCostCents += session.totalCostCents;
+            // Provider breakdown
+            const providerEntry = byProvider[session.provider];
+            if (providerEntry) {
+                providerEntry.requests += session.totalRequests;
+                providerEntry.tokens += session.totalTokens;
+                providerEntry.costCents += session.totalCostCents;
+            }
+            else {
+                byProvider[session.provider] = {
+                    requests: session.totalRequests,
+                    tokens: session.totalTokens,
+                    costCents: session.totalCostCents,
+                };
+            }
+            // Peer breakdown (use sellerPeerId as the peer identifier)
+            const peerId = session.sellerPeerId;
+            const peerEntry = peerMap.get(peerId);
+            if (peerEntry) {
+                peerEntry.requests += session.totalRequests;
+                peerEntry.tokens += session.totalTokens;
+                peerEntry.costCents += session.totalCostCents;
+            }
+            else {
+                peerMap.set(peerId, {
+                    requests: session.totalRequests,
+                    tokens: session.totalTokens,
+                    costCents: session.totalCostCents,
+                });
+            }
+        }
+        // Sort peers by costCents descending, take top N
+        const topPeers = Array.from(peerMap.entries())
+            .map(([peerId, data]) => ({ peerId, ...data }))
+            .sort((a, b) => b.costCents - a.costCents)
+            .slice(0, topPeerCount);
+        return {
+            periodStart: period.start,
+            periodEnd: period.end,
+            granularity,
+            totalSessions: sessions.length,
+            totalRequests,
+            totalTokens,
+            totalCostCents,
+            byProvider,
+            topPeers,
+        };
+    }
+}
+//# sourceMappingURL=usage-aggregator.js.map

package/dist/metering/usage-aggregator.js.map

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

package/dist/node.d.ts

@@ -0,0 +1,179 @@
+import { EventEmitter } from "node:events";
+import type { Identity } from "./p2p/identity.js";
+import type { PeerInfo } from "./types/peer.js";
+import type { SerializedHttpRequest, SerializedHttpResponse } from "./types/http.js";
+import type { Provider, TaskRequest, TaskEvent, SkillRequest, SkillResponse } from "./interfaces/seller-provider.js";
+import type { Router } from "./interfaces/buyer-router.js";
+import { type PaymentConfig, type PaymentMethod } from "./payments/index.js";
+import { BuyerPaymentManager, type BuyerPaymentConfig } from "./payments/buyer-payment-manager.js";
+export type { Provider, TaskRequest, TaskEvent, SkillRequest, SkillResponse };
+export type { Router };
+export type { BuyerPaymentConfig };
+export interface NodePaymentsConfig {
+    /** Enable seller-side payment channels and automatic settlement. */
+    enabled?: boolean;
+    /** Payment method used for settlement. Default: "crypto" */
+    paymentMethod?: PaymentMethod;
+    /** Platform fee rate in [0,1]. Default: 0.05 */
+    platformFeeRate?: number;
+    /** Idle time before a session is finalized and settled. Default: 30000ms */
+    settlementIdleMs?: number;
+    /** Default escrow amount in USDC units. Default: "1" */
+    defaultEscrowAmountUSDC?: string;
+    /** Optional seller wallet address for auto-funded escrow deposit. */
+    sellerWalletAddress?: string;
+    /** Settlement backend configuration (crypto). */
+    paymentConfig?: PaymentConfig | null;
+    /** Base JSON-RPC URL (e.g. http://127.0.0.1:8545 for anvil) */
+    rpcUrl?: string;
+    /** Deployed AntseedEscrow contract address */
+    contractAddress?: string;
+    /** USDC token contract address */
+    usdcAddress?: string;
+}
+export interface NodeConfig {
+    role: 'seller' | 'buyer';
+    dataDir?: string;
+    dhtPort?: number;
+    signalingPort?: number;
+    bootstrapNodes?: Array<{
+        host: string;
+        port: number;
+    }>;
+    requestTimeoutMs?: number;
+    /** Allow private/loopback IPs in DHT lookups. Default: false. Set true for local testing. */
+    allowPrivateIPs?: boolean;
+    /** Optional seller-side payment runtime wiring. */
+    payments?: NodePaymentsConfig;
+}
+export interface SellerSessionSnapshot {
+    sessionId: string;
+    buyerPeerId: string;
+    provider: string;
+    startedAt: number;
+    lastActivityAt: number;
+    totalRequests: number;
+    totalTokens: number;
+    avgLatencyMs: number;
+    settling: boolean;
+    lockCommitted: boolean;
+    lockedAmountUSDC: string;
+    runningTotalUSDC: string;
+    ackedRequestCount: number;
+}
+export declare class AntseedNode extends EventEmitter {
+    private _config;
+    private _identity;
+    private _dht;
+    private _connectionManager;
+    private _providers;
+    private _router;
+    private _started;
+    private _announcer;
+    private _peerLookup;
+    private _muxes;
+    private _decoders;
+    private _nat;
+    private _metering;
+    private _receiptGenerator;
+    private _balanceManager;
+    private _escrowClient;
+    private _paymentMuxes;
+    /** Per-buyer session tracking: buyerPeerId → seller session state */
+    private _sessions;
+    private _settlementTimers;
+    /** Buyer-side payment manager (initialized when buyer has payment config). */
+    private _buyerPaymentManager;
+    /** Tracks which seller peers the buyer has already initiated a lock for. */
+    private _buyerLockedPeers;
+    constructor(config: NodeConfig);
+    get peerId(): string | null;
+    get identity(): Identity | null;
+    registerProvider(provider: Provider): void;
+    setRouter(router: Router): void;
+    get router(): Router | null;
+    /** Buyer-side payment manager (null if payments not enabled or not in buyer mode). */
+    get buyerPaymentManager(): BuyerPaymentManager | null;
+    /** Actual DHT port after binding (0 means not started). */
+    get dhtPort(): number;
+    /** Actual signaling/connection port after binding (0 means not started). */
+    get signalingPort(): number;
+    /**
+     * Active seller sessions currently tracked in-memory.
+     * Includes open sessions before they are finalized/settled.
+     */
+    getActiveSellerSessions(): SellerSessionSnapshot[];
+    /** Number of active in-memory seller sessions that are not currently settling. */
+    getActiveSellerSessionCount(): number;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    discoverPeers(model?: string): Promise<PeerInfo[]>;
+    sendRequest(peer: PeerInfo, req: SerializedHttpRequest): Promise<SerializedHttpResponse>;
+    sendTask(peer: PeerInfo, task: TaskRequest): AsyncIterable<TaskEvent>;
+    sendSkill(peer: PeerInfo, skill: SkillRequest): Promise<SkillResponse>;
+    private _createDHTConfig;
+    private _wireConnection;
+    private _startSeller;
+    private _startBuyer;
+    private _handleIncomingConnection;
+    private _executeProviderRequest;
+    private _parseJsonBody;
+    private _extractRequestedModel;
+    private _resolveProviderPricing;
+    private _getOrCreateSellerSession;
+    private _emitSellerSessionUpdated;
+    /** Estimate tokens from byte lengths (rough: ~4 chars per token). */
+    private _estimateTokens;
+    private _recordMetering;
+    private _initializePayments;
+    private _scheduleSettlementTimer;
+    private _finalizeSession;
+    private _finalizeAllSessions;
+    private _getOrCreateConnection;
+    private _getOrCreateMux;
+    /**
+     * Handle SessionLockAuth from buyer (Task 2).
+     * Recovers buyer address, commits lock on-chain, initializes bilateral state.
+     */
+    private _handleSessionLockAuth;
+    /**
+     * Generate and send a bilateral receipt after processing a request (Task 3).
+     */
+    private _sendBilateralReceipt;
+    /**
+     * Handle BuyerAck (Task 4).
+     * Verifies buyer's Ed25519 ack signature and updates session state.
+     */
+    private _handleBuyerAck;
+    /**
+     * Handle SessionEnd from buyer (Task 5).
+     * Submits settlement on-chain and cleans up.
+     */
+    private _handleSessionEnd;
+    /**
+     * Handle TopUpAuth from buyer (Task 6).
+     * Calls extendLock on-chain and updates session.
+     */
+    private _handleTopUpAuth;
+    /**
+     * Create a PaymentMux for a buyer-side outbound connection and register
+     * buyer-side handlers (lock confirm, lock reject, seller receipt, top-up request).
+     */
+    private _getOrCreateBuyerPaymentMux;
+    /**
+     * Initiate a lock with a seller peer. Creates PaymentMux, signs lock auth,
+     * and waits for confirmation before returning.
+     */
+    private _initiateBuyerLock;
+    /**
+     * Poll until the lock for a seller is confirmed or rejected.
+     * Polls every 200ms with a 30-second timeout.
+     */
+    private _waitForLockConfirmation;
+    /**
+     * End all active buyer payment sessions (called during shutdown).
+     */
+    private _endAllBuyerSessions;
+    private _lookupResultToPeerInfo;
+}
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

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