@usesigil/kit 0.1.0

package/dist/advanced-analytics.js

@@ -0,0 +1,341 @@
+/**
+ * Advanced analytics — institutional-grade metrics for compliance and risk.
+ *
+ * All functions operate on decoded event arrays (pure, no RPC).
+ * The dashboard fetches events via Helius or parsed TX logs.
+ *
+ * Functions:
+ * - getSlippageEfficiency() — authorized vs actual spend comparison
+ * - getCapVelocity() — risk-classified cap approach rate
+ * - getSessionDeviationRate() — compliance deviation tracking
+ * - getIdleCapitalDuration() — dormancy detection
+ * - getPermissionEscalationLatency() — suspicious grant-to-use timing
+ * - getInstructionCoverageRatio() — session sandwich completeness
+ */
+import { EPOCH_DURATION } from "./types.js";
+// ─── getSlippageEfficiency ───────────────────────────────────────────────────
+/**
+ * Measure execution quality by comparing authorized amount to actual spend.
+ * Pairs ActionAuthorized → SessionFinalized events by agent.
+ */
+export function getSlippageEfficiency(events) {
+    const agentTrades = new Map();
+    for (let i = 0; i < events.length - 1; i++) {
+        if (events[i].name !== "ActionAuthorized" || !events[i].fields)
+            continue;
+        const auth = events[i].fields;
+        for (let j = i + 1; j < Math.min(i + 5, events.length); j++) {
+            if (events[j].name !== "SessionFinalized" || !events[j].fields)
+                continue;
+            const fin = events[j].fields;
+            if (auth.agent === fin.agent) {
+                const agent = auth.agent;
+                const authorized = auth.usdAmount;
+                const rawActual = fin.actualSpendUsd;
+                const actual = typeof rawActual === "bigint" ? rawActual : 0n;
+                if (!agentTrades.has(agent))
+                    agentTrades.set(agent, []);
+                agentTrades.get(agent).push({ authorized, actual });
+                break;
+            }
+        }
+    }
+    const byAgent = [];
+    let totalSlippageBps = 0;
+    let totalTrades = 0;
+    for (const [agent, trades] of agentTrades) {
+        let worstBps = 0;
+        let totalBps = 0;
+        let totalWaste = 0n;
+        for (const trade of trades) {
+            if (trade.authorized === 0n)
+                continue;
+            const diff = trade.actual > trade.authorized
+                ? trade.actual - trade.authorized
+                : 0n;
+            const bps = Number((diff * 10000n) / trade.authorized);
+            totalBps += bps;
+            totalWaste += diff;
+            if (bps > worstBps)
+                worstBps = bps;
+        }
+        byAgent.push({
+            agent: agent,
+            avgSlippageBps: trades.length > 0 ? totalBps / trades.length : 0,
+            worstSlippageBps: worstBps,
+            tradeCount: trades.length,
+            estimatedWasteUsd: totalWaste,
+        });
+        totalSlippageBps += totalBps;
+        totalTrades += trades.length;
+    }
+    return {
+        byAgent,
+        vaultAvgSlippageBps: totalTrades > 0 ? totalSlippageBps / totalTrades : 0,
+    };
+}
+// ─── getCapVelocity ──────────────────────────────────────────────────────────
+/**
+ * Cap velocity with risk classification (low/moderate/high/critical).
+ */
+export function getCapVelocity(tracker, nowUnix, globalBudget) {
+    const epochDuration = BigInt(EPOCH_DURATION);
+    const currentEpoch = nowUnix / epochDuration;
+    let recentSum = 0n;
+    let recentCount = 0;
+    if (tracker) {
+        for (const bucket of tracker.buckets) {
+            if (bucket.epochId >= currentEpoch - 3n &&
+                bucket.epochId <= currentEpoch &&
+                bucket.usdAmount > 0n) {
+                recentSum += bucket.usdAmount;
+                recentCount++;
+            }
+        }
+    }
+    const currentRate = recentCount > 0 ? (recentSum * 6n) / BigInt(recentCount) : 0n;
+    const avgRate = globalBudget.spent24h / 24n;
+    const acceleration = avgRate > 0n ? Number(currentRate) / Number(avgRate) : 0;
+    let projectedCapHitTime = null;
+    if (currentRate > 0n && globalBudget.remaining > 0n) {
+        const hoursRemaining = Number(globalBudget.remaining) / Number(currentRate);
+        projectedCapHitTime = Number(nowUnix) + hoursRemaining * 3600;
+    }
+    const util = globalBudget.cap > 0n
+        ? Number((globalBudget.spent24h * 100n) / globalBudget.cap)
+        : 0;
+    let riskLevel;
+    if (util >= 95 ||
+        (projectedCapHitTime !== null &&
+            projectedCapHitTime - Number(nowUnix) < 3600)) {
+        riskLevel = "critical";
+    }
+    else if (util >= 80 && acceleration > 1.5) {
+        riskLevel = "high";
+    }
+    else if (util >= 50 || acceleration > 1.5) {
+        riskLevel = "moderate";
+    }
+    else {
+        riskLevel = "low";
+    }
+    return { currentRate, avgRate, acceleration, projectedCapHitTime, riskLevel };
+}
+// ─── getSessionDeviationRate ─────────────────────────────────────────────────
+/**
+ * Measure how often actual spend deviates >2% from authorized amount.
+ * SOC 2 auditors require this metric.
+ */
+export function getSessionDeviationRate(events) {
+    const pairs = [];
+    for (let i = 0; i < events.length - 1; i++) {
+        if (events[i].name !== "ActionAuthorized" || !events[i].fields)
+            continue;
+        const auth = events[i].fields;
+        for (let j = i + 1; j < Math.min(i + 5, events.length); j++) {
+            if (events[j].name !== "SessionFinalized" || !events[j].fields)
+                continue;
+            const fin = events[j].fields;
+            const finActual = typeof fin.actualSpendUsd === "bigint" ? fin.actualSpendUsd : 0n;
+            const authAmount = typeof auth.usdAmount === "bigint" ? auth.usdAmount : 0n;
+            if (auth.agent === fin.agent && finActual > 0n) {
+                pairs.push({
+                    agent: auth.agent,
+                    authorized: authAmount,
+                    actual: finActual,
+                });
+                break;
+            }
+        }
+    }
+    const deviations = [];
+    let maxBps = 0;
+    for (const pair of pairs) {
+        if (pair.authorized === 0n)
+            continue;
+        if (pair.actual > pair.authorized) {
+            const bps = Number(((pair.actual - pair.authorized) * 10000n) / pair.authorized);
+            if (bps > 200) {
+                deviations.push({
+                    agent: pair.agent,
+                    authorizedAmount: pair.authorized,
+                    actualSpend: pair.actual,
+                    deviationBps: bps,
+                });
+                if (bps > maxBps)
+                    maxBps = bps;
+            }
+        }
+    }
+    return {
+        totalSessions: pairs.length,
+        deviatedSessions: deviations.length,
+        deviationRate: pairs.length > 0 ? (deviations.length / pairs.length) * 100 : 0,
+        maxDeviationBps: maxBps,
+        deviations,
+    };
+}
+// ─── getIdleCapitalDuration ──────────────────────────────────────────────────
+/**
+ * Measure how long vault funds sit idle between agent actions.
+ */
+export function getIdleCapitalDuration(events, nowUnix) {
+    const tradeTimestamps = [];
+    for (const e of events) {
+        if ((e.name === "SessionFinalized" || e.name === "ActionAuthorized") &&
+            e.fields?.timestamp != null) {
+            tradeTimestamps.push(Number(e.fields.timestamp));
+        }
+    }
+    if (tradeTimestamps.length === 0) {
+        return {
+            avgIdleHours: 0,
+            maxIdleHours: 0,
+            lastActivityTimestamp: 0,
+            idleSinceHours: 0,
+        };
+    }
+    tradeTimestamps.sort((a, b) => a - b);
+    const gaps = [];
+    for (let i = 1; i < tradeTimestamps.length; i++) {
+        gaps.push(tradeTimestamps[i] - tradeTimestamps[i - 1]);
+    }
+    const avgGapSeconds = gaps.length > 0 ? gaps.reduce((a, b) => a + b, 0) / gaps.length : 0;
+    const maxGapSeconds = gaps.length > 0 ? Math.max(...gaps) : 0;
+    const lastTimestamp = tradeTimestamps[tradeTimestamps.length - 1];
+    return {
+        avgIdleHours: Math.round((avgGapSeconds / 3600) * 10) / 10,
+        maxIdleHours: Math.round((maxGapSeconds / 3600) * 10) / 10,
+        lastActivityTimestamp: lastTimestamp,
+        idleSinceHours: Math.round(((nowUnix - lastTimestamp) / 3600) * 10) / 10,
+    };
+}
+// ─── getPermissionEscalationLatency ──────────────────────────────────────────
+/**
+ * Time between permission grants and first use. <60s = suspicious.
+ */
+export function getPermissionEscalationLatency(events) {
+    const escalations = [];
+    for (let i = 0; i < events.length; i++) {
+        if (events[i].name !== "AgentPermissionsUpdated" || !events[i].fields)
+            continue;
+        const permEvent = events[i].fields;
+        const agent = permEvent.agent;
+        const grantTimestamp = Number(permEvent.timestamp ?? 0);
+        let firstUseTimestamp = null;
+        for (let j = i + 1; j < events.length; j++) {
+            if (events[j].name === "ActionAuthorized" &&
+                events[j].fields?.agent === agent) {
+                firstUseTimestamp = Number(events[j].fields.timestamp);
+                break;
+            }
+        }
+        const latencySeconds = firstUseTimestamp !== null ? firstUseTimestamp - grantTimestamp : null;
+        escalations.push({
+            agent: agent,
+            grantTimestamp,
+            firstUseTimestamp,
+            latencySeconds,
+            suspicious: latencySeconds !== null && latencySeconds < 60,
+        });
+    }
+    return { escalations };
+}
+// ─── getInstructionCoverageRatio ─────────────────────────────────────────────
+/**
+ * Measure instruction sandwich coverage — what % of authorized sessions
+ * were properly finalized. Non-zero orphan rate = potential attack surface.
+ */
+export function getInstructionCoverageRatio(events) {
+    const authorized = new Map();
+    const finalized = new Map();
+    for (const e of events) {
+        if (e.name === "ActionAuthorized" && e.fields?.agent) {
+            const agent = e.fields.agent;
+            authorized.set(agent, (authorized.get(agent) ?? 0) + 1);
+        }
+        if (e.name === "SessionFinalized" && e.fields?.agent) {
+            const agent = e.fields.agent;
+            finalized.set(agent, (finalized.get(agent) ?? 0) + 1);
+        }
+    }
+    let totalComposed = 0;
+    let orphanedValidates = 0;
+    for (const [agent, authCount] of authorized) {
+        const finCount = finalized.get(agent) ?? 0;
+        const paired = Math.min(authCount, finCount);
+        totalComposed += paired;
+        orphanedValidates += authCount - paired;
+    }
+    const total = totalComposed + orphanedValidates;
+    const coverageRate = total > 0 ? (totalComposed / total) * 100 : 100;
+    return { totalComposed, orphanedValidates, coverageRate };
+}
+const ACTION_NAMES = [
+    "Swap", "OpenPosition", "ClosePosition", "IncreasePosition", "DecreasePosition",
+    "Deposit", "Withdraw", "Transfer", "AddCollateral", "RemoveCollateral",
+    "PlaceTriggerOrder", "EditTriggerOrder", "CancelTriggerOrder",
+    "PlaceLimitOrder", "EditLimitOrder", "CancelLimitOrder",
+    "SwapAndOpenPosition", "CloseAndSwapPosition",
+    "CreateEscrow", "SettleEscrow", "RefundEscrow",
+];
+/**
+ * Ratio of granted permission bits actually exercised by each agent.
+ * Shows which ActionTypes agents use vs what they're granted — security surface analysis.
+ */
+export function getPermissionUtilizationRate(state, events) {
+    // Count which ActionTypes each agent has used
+    const agentActionUsage = new Map();
+    for (const e of events) {
+        if (e.name === "ActionAuthorized" && e.fields?.agent && e.fields?.actionType) {
+            const agent = e.fields.agent;
+            const actionObj = e.fields.actionType;
+            const actionName = typeof actionObj === "object" && "__kind" in actionObj
+                ? actionObj.__kind
+                : ACTION_NAMES[Number(actionObj)] ?? "Unknown";
+            if (!agentActionUsage.has(agent))
+                agentActionUsage.set(agent, new Set());
+            agentActionUsage.get(agent).add(actionName);
+        }
+    }
+    const globalActionCounts = new Map();
+    const byAgent = [];
+    for (const agentEntry of state.vault.agents) {
+        const agent = agentEntry.pubkey;
+        const granted = [];
+        for (let bit = 0; bit < 21; bit++) {
+            if ((agentEntry.permissions & (1n << BigInt(bit))) !== 0n) {
+                granted.push(ACTION_NAMES[bit]);
+            }
+        }
+        const exercised = agentActionUsage.get(agent) ?? new Set();
+        const exercisedArr = [...exercised].filter((a) => granted.includes(a));
+        const unused = granted.filter((a) => !exercised.has(a));
+        for (const a of exercisedArr) {
+            globalActionCounts.set(a, (globalActionCounts.get(a) ?? 0) + 1);
+        }
+        byAgent.push({
+            agent,
+            grantedPermissions: granted,
+            exercisedPermissions: exercisedArr,
+            utilizationRate: granted.length > 0 ? (exercisedArr.length / granted.length) * 100 : 0,
+            unusedPermissions: unused,
+        });
+    }
+    let mostUsed = null;
+    let leastUsed = null;
+    let maxCount = 0;
+    let minCount = Infinity;
+    for (const [action, count] of globalActionCounts) {
+        if (count > maxCount) {
+            maxCount = count;
+            mostUsed = action;
+        }
+        if (count < minCount) {
+            minCount = count;
+            leastUsed = action;
+        }
+    }
+    return { byAgent, mostUsedActionType: mostUsed, leastUsedActionType: leastUsed };
+}
+//# sourceMappingURL=advanced-analytics.js.map

package/dist/advanced-analytics.js.map

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

package/dist/agent-analytics.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Agent analytics — profiles, leaderboards, and concentration metrics.
+ *
+ * All functions are pure (no RPC) — they derive metrics from already-resolved
+ * vault state. The dashboard Agents tab and Agent Detail page use these.
+ */
+import type { Address } from "@solana/kit";
+import type { DecodedSigilEvent } from "./events.js";
+import type { ResolvedVaultState, EffectiveBudget } from "./state-resolver.js";
+export interface AgentProfile {
+    address: Address;
+    permissions: bigint;
+    permissionStrings: string[];
+    permissionCount: number;
+    spendingLimitUsd: bigint;
+    paused: boolean;
+    budget: EffectiveBudget;
+    lifetimeSpend: bigint;
+    /** Lifetime transaction count from overlay (0 if no overlay or slot not found) */
+    lifetimeTxCount: bigint;
+    /** Average transaction size: lifetimeSpend / lifetimeTxCount (0n if no transactions) */
+    avgTransactionSize: bigint;
+    /** 0-100 percentage of per-agent cap used */
+    capUtilization: number;
+    /** Whether agent is over 80% of its cap */
+    isApproachingCap: boolean;
+    /** Whether agent has FULL_PERMISSIONS (all 21 bits) */
+    hasFullPermissions: boolean;
+}
+export interface AgentRanking {
+    address: Address;
+    /** 1-based rank (1 = highest spender) */
+    rank: number;
+    spend24h: bigint;
+    lifetimeSpend: bigint;
+    capUtilization: number;
+    paused: boolean;
+    permissionCount: number;
+}
+export interface AgentComparisonData {
+    agents: AgentRanking[];
+    totalAgentSpend24h: bigint;
+    /** Herfindahl-Hirschman Index (0-1). 1.0 = single agent dominates. */
+    spendConcentration: number;
+    mostActiveAgent: Address | null;
+    leastActiveAgent: Address | null;
+}
+/**
+ * Build a complete profile for a single agent within a vault.
+ * Returns null if the agent is not registered.
+ */
+export declare function getAgentProfile(state: ResolvedVaultState, agentAddress: Address): AgentProfile | null;
+/**
+ * Rank all agents in a vault by 24h spending (descending).
+ * Returns agents with 1-based rank numbers.
+ */
+export declare function getAgentLeaderboard(state: ResolvedVaultState): AgentRanking[];
+/**
+ * Cross-agent comparison with Herfindahl concentration analysis.
+ */
+export declare function getAgentComparison(state: ResolvedVaultState): AgentComparisonData;
+export interface AgentErrorBreakdown {
+    agent: Address;
+    totalSessions: number;
+    failedSessions: number;
+    expiredSessions: number;
+    successfulSessions: number;
+    /** 0-100 percentage */
+    successRate: number;
+}
+/**
+ * Categorize an agent's sessions by outcome (success/fail/expired).
+ * Used for the Agent Detail page success rate metric.
+ */
+export declare function getAgentErrorBreakdown(events: DecodedSigilEvent[], agentAddress: Address): AgentErrorBreakdown;
+//# sourceMappingURL=agent-analytics.d.ts.map

package/dist/agent-analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-analytics.d.ts","sourceRoot":"","sources":["../src/agent-analytics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAO/E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,eAAe,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,eAAe,EAAE,MAAM,CAAC;IACxB,wFAAwF;IACxF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,uDAAuD;IACvD,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sEAAsE;IACtE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;CAClC;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,kBAAkB,EACzB,YAAY,EAAE,OAAO,GACpB,YAAY,GAAG,IAAI,CAoDrB;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,GACxB,YAAY,EAAE,CAmDhB;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,kBAAkB,GACxB,mBAAmB,CAqBrB;AAgBD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,iBAAiB,EAAE,EAC3B,YAAY,EAAE,OAAO,GACpB,mBAAmB,CA2BrB"}

package/dist/agent-analytics.js

@@ -0,0 +1,179 @@
+/**
+ * Agent analytics — profiles, leaderboards, and concentration metrics.
+ *
+ * All functions are pure (no RPC) — they derive metrics from already-resolved
+ * vault state. The dashboard Agents tab and Agent Detail page use these.
+ */
+import { bytesToAddress } from "./state-resolver.js";
+import { permissionsToStrings, FULL_PERMISSIONS } from "./types.js";
+import { computeHerfindahl } from "./math-utils.js";
+// ─── getAgentProfile ─────────────────────────────────────────────────────────
+/**
+ * Build a complete profile for a single agent within a vault.
+ * Returns null if the agent is not registered.
+ */
+export function getAgentProfile(state, agentAddress) {
+    const { vault, overlay, allAgentBudgets } = state;
+    const agentEntry = vault.agents.find((a) => a.pubkey === agentAddress);
+    if (!agentEntry)
+        return null;
+    const budget = allAgentBudgets.get(agentAddress) ?? {
+        spent24h: 0n,
+        cap: 0n,
+        remaining: 0n,
+    };
+    let lifetimeSpend = 0n;
+    let lifetimeTxCount = 0n;
+    if (overlay) {
+        const slotIdx = overlay.entries.findIndex((e) => {
+            try {
+                return bytesToAddress(e.agent) === agentAddress;
+            }
+            catch {
+                return false;
+            }
+        });
+        if (slotIdx >= 0 && slotIdx < overlay.lifetimeSpend.length) {
+            lifetimeSpend = overlay.lifetimeSpend[slotIdx];
+        }
+        if (slotIdx >= 0 && slotIdx < (overlay.lifetimeTxCount?.length ?? 0)) {
+            lifetimeTxCount = overlay.lifetimeTxCount[slotIdx];
+        }
+    }
+    const capUtilization = budget.cap > 0n
+        ? Number((budget.spent24h * 10000n) / budget.cap) / 100
+        : 0;
+    const permStrings = permissionsToStrings(agentEntry.permissions);
+    return {
+        address: agentAddress,
+        permissions: agentEntry.permissions,
+        permissionStrings: permStrings,
+        permissionCount: permStrings.length,
+        spendingLimitUsd: agentEntry.spendingLimitUsd,
+        paused: agentEntry.paused,
+        budget,
+        lifetimeSpend,
+        lifetimeTxCount,
+        avgTransactionSize: lifetimeTxCount > 0n ? lifetimeSpend / lifetimeTxCount : 0n,
+        capUtilization,
+        isApproachingCap: capUtilization > 80,
+        hasFullPermissions: agentEntry.permissions === FULL_PERMISSIONS,
+    };
+}
+// ─── getAgentLeaderboard ─────────────────────────────────────────────────────
+/**
+ * Rank all agents in a vault by 24h spending (descending).
+ * Returns agents with 1-based rank numbers.
+ */
+export function getAgentLeaderboard(state) {
+    const { vault, overlay, allAgentBudgets } = state;
+    const rankings = vault.agents.map((agentEntry) => {
+        const budget = allAgentBudgets.get(agentEntry.pubkey) ?? {
+            spent24h: 0n,
+            cap: 0n,
+            remaining: 0n,
+        };
+        let lifetimeSpend = 0n;
+        if (overlay) {
+            const slotIdx = overlay.entries.findIndex((e) => {
+                try {
+                    return bytesToAddress(e.agent) === agentEntry.pubkey;
+                }
+                catch {
+                    return false;
+                }
+            });
+            if (slotIdx >= 0 && slotIdx < overlay.lifetimeSpend.length) {
+                lifetimeSpend = overlay.lifetimeSpend[slotIdx];
+            }
+        }
+        const capUtilization = budget.cap > 0n
+            ? Number((budget.spent24h * 10000n) / budget.cap) / 100
+            : 0;
+        return {
+            address: agentEntry.pubkey,
+            rank: 0,
+            spend24h: budget.spent24h,
+            lifetimeSpend,
+            capUtilization,
+            paused: agentEntry.paused,
+            permissionCount: countPermissionBits(agentEntry.permissions),
+        };
+    });
+    rankings.sort((a, b) => {
+        if (b.spend24h > a.spend24h)
+            return 1;
+        if (b.spend24h < a.spend24h)
+            return -1;
+        return 0;
+    });
+    rankings.forEach((r, i) => {
+        r.rank = i + 1;
+    });
+    return rankings;
+}
+// ─── getAgentComparison ──────────────────────────────────────────────────────
+/**
+ * Cross-agent comparison with Herfindahl concentration analysis.
+ */
+export function getAgentComparison(state) {
+    const rankings = getAgentLeaderboard(state);
+    const totalSpend = rankings.reduce((sum, r) => sum + r.spend24h, 0n);
+    const hhi = computeHerfindahl(rankings.map((r) => r.spend24h));
+    const activeAgents = rankings.filter((r) => r.spend24h > 0n);
+    const mostActive = activeAgents.length > 0 ? activeAgents[0].address : null;
+    const leastActive = activeAgents.length > 0
+        ? activeAgents[activeAgents.length - 1].address
+        : null;
+    return {
+        agents: rankings,
+        totalAgentSpend24h: totalSpend,
+        spendConcentration: hhi,
+        mostActiveAgent: mostActive,
+        leastActiveAgent: leastActive,
+    };
+}
+// ─── Internal ────────────────────────────────────────────────────────────────
+function countPermissionBits(perms) {
+    let count = 0;
+    let v = perms;
+    while (v > 0n) {
+        count += Number(v & 1n);
+        v >>= 1n;
+    }
+    return count;
+}
+/**
+ * Categorize an agent's sessions by outcome (success/fail/expired).
+ * Used for the Agent Detail page success rate metric.
+ */
+export function getAgentErrorBreakdown(events, agentAddress) {
+    let total = 0;
+    let failed = 0;
+    let expired = 0;
+    let successful = 0;
+    for (const e of events) {
+        if (e.name !== "SessionFinalized" || !e.fields)
+            continue;
+        if (e.fields.agent !== agentAddress)
+            continue;
+        total++;
+        const success = e.fields.success;
+        const isExpired = e.fields.isExpired;
+        if (isExpired)
+            expired++;
+        else if (!success)
+            failed++;
+        else
+            successful++;
+    }
+    return {
+        agent: agentAddress,
+        totalSessions: total,
+        failedSessions: failed,
+        expiredSessions: expired,
+        successfulSessions: successful,
+        successRate: total > 0 ? Math.round((successful / total) * 100) : 100,
+    };
+}
+//# sourceMappingURL=agent-analytics.js.map

package/dist/agent-analytics.js.map

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