@x402sentinel/x402 0.1.0

package/dist/dashboard.cjs

@@ -0,0 +1,178 @@
+'use strict';
+
+var chunk7H4FRU7K_cjs = require('./chunk-7H4FRU7K.cjs');
+
+// src/dashboard/queries.ts
+async function spendByAgent(storage, agentId, range) {
+  const { start, end } = chunk7H4FRU7K_cjs.resolveTimeRange(range);
+  const records = await storage.query({ agentId, startTime: start, endTime: end });
+  return aggregateSpend(records);
+}
+async function spendByTeam(storage, team, range) {
+  const { start, end } = chunk7H4FRU7K_cjs.resolveTimeRange(range);
+  const records = await storage.query({ team, startTime: start, endTime: end });
+  return aggregateSpend(records);
+}
+async function spendByEndpoint(storage, pattern, range) {
+  const { start, end } = chunk7H4FRU7K_cjs.resolveTimeRange(range);
+  const records = await storage.query({ endpoint: pattern, startTime: start, endTime: end });
+  return aggregateSpend(records);
+}
+async function topSpenders(storage, limit, range) {
+  const { start, end } = chunk7H4FRU7K_cjs.resolveTimeRange(range);
+  const records = await storage.query({ startTime: start, endTime: end });
+  const byAgent = /* @__PURE__ */ new Map();
+  for (const r of records) {
+    const entry = byAgent.get(r.agent_id) ?? { raw: 0n, count: 0 };
+    entry.raw += chunk7H4FRU7K_cjs.parseUSDC(r.amount);
+    entry.count++;
+    byAgent.set(r.agent_id, entry);
+  }
+  return [...byAgent.entries()].map(([agentId, data]) => ({
+    agentId,
+    spend: chunk7H4FRU7K_cjs.formatUSDCHuman(data.raw),
+    count: data.count
+  })).sort((a, b) => {
+    const aRaw = chunk7H4FRU7K_cjs.parseUSDC(a.spend);
+    const bRaw = chunk7H4FRU7K_cjs.parseUSDC(b.spend);
+    return aRaw > bRaw ? -1 : aRaw < bRaw ? 1 : 0;
+  }).slice(0, limit);
+}
+async function violations(storage, range) {
+  const { start, end } = chunk7H4FRU7K_cjs.resolveTimeRange(range);
+  return storage.query({ status: ["blocked"], startTime: start, endTime: end });
+}
+async function anomalies(storage, range) {
+  const { start, end } = chunk7H4FRU7K_cjs.resolveTimeRange(range);
+  return storage.query({ status: ["flagged"], startTime: start, endTime: end });
+}
+function aggregateSpend(records) {
+  let totalRaw = 0n;
+  for (const r of records) {
+    totalRaw += chunk7H4FRU7K_cjs.parseUSDC(r.amount);
+  }
+  return {
+    spend: chunk7H4FRU7K_cjs.formatUSDCHuman(totalRaw),
+    count: records.length,
+    records
+  };
+}
+
+// src/dashboard/index.ts
+var SentinelDashboard = class {
+  storage;
+  /** @internal Reserved for future remote API integration */
+  apiKey;
+  /** @internal Reserved for future remote API integration */
+  baseUrl;
+  constructor(config) {
+    this.storage = config.storage;
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl ?? "https://api.valeo.money/v1";
+  }
+  /** Query spend data with flexible filters */
+  async getSpend(query) {
+    const records = await this.getFilteredRecords(query);
+    let totalRaw = 0n;
+    const byAgent = {};
+    const byEndpoint = {};
+    for (const r of records) {
+      const raw = chunk7H4FRU7K_cjs.parseUSDC(r.amount);
+      totalRaw += raw;
+      const agentEntry = byAgent[r.agent_id] ?? { spend: "0.00", count: 0 };
+      agentEntry.spend = chunk7H4FRU7K_cjs.formatUSDCHuman(chunk7H4FRU7K_cjs.parseUSDC(agentEntry.spend) + raw);
+      agentEntry.count++;
+      byAgent[r.agent_id] = agentEntry;
+      const epEntry = byEndpoint[r.endpoint] ?? { spend: "0.00", count: 0 };
+      epEntry.spend = chunk7H4FRU7K_cjs.formatUSDCHuman(chunk7H4FRU7K_cjs.parseUSDC(epEntry.spend) + raw);
+      epEntry.count++;
+      byEndpoint[r.endpoint] = epEntry;
+    }
+    return {
+      totalSpend: chunk7H4FRU7K_cjs.formatUSDCHuman(totalRaw),
+      count: records.length,
+      byAgent,
+      byEndpoint
+    };
+  }
+  /** Get summary info for all known agents */
+  async getAgents() {
+    const allRecords = await this.storage.query({});
+    const agentMap = /* @__PURE__ */ new Map();
+    for (const r of allRecords) {
+      const entry = agentMap.get(r.agent_id) ?? {
+        team: r.team,
+        raw: 0n,
+        count: 0,
+        lastActive: 0
+      };
+      entry.raw += chunk7H4FRU7K_cjs.parseUSDC(r.amount);
+      entry.count++;
+      if (r.created_at > entry.lastActive) entry.lastActive = r.created_at;
+      agentMap.set(r.agent_id, entry);
+    }
+    return [...agentMap.entries()].map(([agentId, data]) => ({
+      agentId,
+      team: data.team,
+      totalSpend: chunk7H4FRU7K_cjs.formatUSDCHuman(data.raw),
+      transactionCount: data.count,
+      lastActive: data.lastActive
+    }));
+  }
+  /** Get all violations and anomalies as alerts */
+  async getAlerts() {
+    const allRecords = await this.storage.query({});
+    const alerts = [];
+    for (const r of allRecords) {
+      if (r.policy_evaluation === "blocked") {
+        alerts.push({
+          type: "violation",
+          record: r,
+          message: `Budget violation by ${r.agent_id} on ${r.endpoint}: $${r.amount}`
+        });
+      } else if (r.policy_evaluation === "flagged") {
+        alerts.push({
+          type: "anomaly",
+          record: r,
+          message: `Anomaly detected for ${r.agent_id} on ${r.endpoint}: $${r.amount}`
+        });
+      }
+    }
+    return alerts;
+  }
+  /** Stub: Sync local records to remote API (future api.valeo.money) */
+  async sync() {
+    console.warn("[sentinel] Dashboard sync is not yet implemented \u2014 records remain local only");
+    return { synced: 0 };
+  }
+  /** Stub: Export audit data as PDF via remote API */
+  async exportPDF(_query) {
+    throw new Error("PDF export requires the Valeo hosted dashboard (api.valeo.money) \u2014 coming soon");
+  }
+  async getFilteredRecords(query) {
+    if (query.agentId) {
+      const result2 = await spendByAgent(this.storage, query.agentId, query.range);
+      return result2.records;
+    }
+    if (query.team) {
+      const result2 = await spendByTeam(this.storage, query.team, query.range);
+      return result2.records;
+    }
+    if (query.endpoint) {
+      const result2 = await spendByEndpoint(this.storage, query.endpoint, query.range);
+      return result2.records;
+    }
+    const result = await spendByEndpoint(this.storage, "", query.range);
+    return result.records;
+  }
+};
+
+exports.SentinelDashboard = SentinelDashboard;
+exports.anomalies = anomalies;
+exports.spendByAgent = spendByAgent;
+exports.spendByEndpoint = spendByEndpoint;
+exports.spendByTeam = spendByTeam;
+exports.topSpenders = topSpenders;
+exports.violations = violations;
+//# sourceMappingURL=dashboard.cjs.map
+//# sourceMappingURL=dashboard.cjs.map

package/dist/dashboard.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dashboard/queries.ts","../src/dashboard/index.ts"],"names":["resolveTimeRange","parseUSDC","formatUSDCHuman","result"],"mappings":"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","file":"dashboard.cjs","sourcesContent":["import type { AuditRecord } from \"../types/audit\";\nimport type { StorageBackend } from \"../audit/storage/interface\";\nimport { resolveTimeRange } from \"../utils/time\";\nimport { parseUSDC, formatUSDCHuman } from \"../utils/money\";\n\nexport type TimeRange =\n  | \"last_hour\"\n  | \"last_day\"\n  | \"last_week\"\n  | \"last_month\"\n  | { start: number; end: number };\n\nexport interface SpendResult {\n  spend: string;\n  count: number;\n  records: AuditRecord[];\n}\n\n/** Query spend for a specific agent within a time range */\nexport async function spendByAgent(\n  storage: StorageBackend,\n  agentId: string,\n  range: TimeRange,\n): Promise<SpendResult> {\n  const { start, end } = resolveTimeRange(range);\n  const records = await storage.query({ agentId, startTime: start, endTime: end });\n  return aggregateSpend(records);\n}\n\n/** Query spend for a team within a time range */\nexport async function spendByTeam(\n  storage: StorageBackend,\n  team: string,\n  range: TimeRange,\n): Promise<SpendResult> {\n  const { start, end } = resolveTimeRange(range);\n  const records = await storage.query({ team, startTime: start, endTime: end });\n  return aggregateSpend(records);\n}\n\n/** Query spend for an endpoint pattern within a time range */\nexport async function spendByEndpoint(\n  storage: StorageBackend,\n  pattern: string,\n  range: TimeRange,\n): Promise<SpendResult> {\n  const { start, end } = resolveTimeRange(range);\n  const records = await storage.query({ endpoint: pattern, startTime: start, endTime: end });\n  return aggregateSpend(records);\n}\n\n/** Get top spending agents within a time range */\nexport async function topSpenders(\n  storage: StorageBackend,\n  limit: number,\n  range: TimeRange,\n): Promise<Array<{ agentId: string; spend: string; count: number }>> {\n  const { start, end } = resolveTimeRange(range);\n  const records = await storage.query({ startTime: start, endTime: end });\n\n  const byAgent = new Map<string, { raw: bigint; count: number }>();\n  for (const r of records) {\n    const entry = byAgent.get(r.agent_id) ?? { raw: 0n, count: 0 };\n    entry.raw += parseUSDC(r.amount);\n    entry.count++;\n    byAgent.set(r.agent_id, entry);\n  }\n\n  return [...byAgent.entries()]\n    .map(([agentId, data]) => ({\n      agentId,\n      spend: formatUSDCHuman(data.raw),\n      count: data.count,\n    }))\n    .sort((a, b) => {\n      const aRaw = parseUSDC(a.spend);\n      const bRaw = parseUSDC(b.spend);\n      return aRaw > bRaw ? -1 : aRaw < bRaw ? 1 : 0;\n    })\n    .slice(0, limit);\n}\n\n/** Get all blocked (violation) records within a time range */\nexport async function violations(\n  storage: StorageBackend,\n  range: TimeRange,\n): Promise<AuditRecord[]> {\n  const { start, end } = resolveTimeRange(range);\n  return storage.query({ status: [\"blocked\"], startTime: start, endTime: end });\n}\n\n/** Get all flagged (anomaly) records within a time range */\nexport async function anomalies(\n  storage: StorageBackend,\n  range: TimeRange,\n): Promise<AuditRecord[]> {\n  const { start, end } = resolveTimeRange(range);\n  return storage.query({ status: [\"flagged\"], startTime: start, endTime: end });\n}\n\nfunction aggregateSpend(records: AuditRecord[]): SpendResult {\n  let totalRaw = 0n;\n  for (const r of records) {\n    totalRaw += parseUSDC(r.amount);\n  }\n  return {\n    spend: formatUSDCHuman(totalRaw),\n    count: records.length,\n    records,\n  };\n}\n","import type { AuditRecord, AuditQuery } from \"../types/audit\";\nimport type { StorageBackend } from \"../audit/storage/interface\";\nimport { spendByAgent, spendByTeam, spendByEndpoint } from \"./queries\";\nimport type { TimeRange } from \"./queries\";\nimport { parseUSDC, formatUSDCHuman } from \"../utils/money\";\n\n/** Query parameters for dashboard spend queries */\nexport interface SpendQuery {\n  agentId?: string;\n  team?: string;\n  endpoint?: string;\n  range: TimeRange;\n}\n\n/** Aggregated spend report */\nexport interface SpendReport {\n  totalSpend: string;\n  count: number;\n  byAgent: Record<string, { spend: string; count: number }>;\n  byEndpoint: Record<string, { spend: string; count: number }>;\n}\n\n/** Summary for a single agent */\nexport interface AgentSummary {\n  agentId: string;\n  team: string | null;\n  totalSpend: string;\n  transactionCount: number;\n  lastActive: number;\n}\n\n/** Alert from violations or anomaly detection */\nexport interface Alert {\n  type: \"violation\" | \"anomaly\";\n  record: AuditRecord;\n  message: string;\n}\n\nexport interface DashboardConfig {\n  storage: StorageBackend;\n  apiKey?: string;\n  baseUrl?: string;\n}\n\n/**\n * Dashboard client for querying Sentinel audit data.\n * Runs queries locally against the configured StorageBackend.\n * Remote sync/export are stubs for future api.valeo.money integration.\n */\nexport class SentinelDashboard {\n  private readonly storage: StorageBackend;\n  /** @internal Reserved for future remote API integration */\n  readonly apiKey?: string;\n  /** @internal Reserved for future remote API integration */\n  readonly baseUrl: string;\n\n  constructor(config: DashboardConfig) {\n    this.storage = config.storage;\n    this.apiKey = config.apiKey;\n    this.baseUrl = config.baseUrl ?? \"https://api.valeo.money/v1\";\n  }\n\n  /** Query spend data with flexible filters */\n  async getSpend(query: SpendQuery): Promise<SpendReport> {\n    const records = await this.getFilteredRecords(query);\n\n    let totalRaw = 0n;\n    const byAgent: Record<string, { spend: string; count: number }> = {};\n    const byEndpoint: Record<string, { spend: string; count: number }> = {};\n\n    for (const r of records) {\n      const raw = parseUSDC(r.amount);\n      totalRaw += raw;\n\n      const agentEntry = byAgent[r.agent_id] ?? { spend: \"0.00\", count: 0 };\n      agentEntry.spend = formatUSDCHuman(parseUSDC(agentEntry.spend) + raw);\n      agentEntry.count++;\n      byAgent[r.agent_id] = agentEntry;\n\n      const epEntry = byEndpoint[r.endpoint] ?? { spend: \"0.00\", count: 0 };\n      epEntry.spend = formatUSDCHuman(parseUSDC(epEntry.spend) + raw);\n      epEntry.count++;\n      byEndpoint[r.endpoint] = epEntry;\n    }\n\n    return {\n      totalSpend: formatUSDCHuman(totalRaw),\n      count: records.length,\n      byAgent,\n      byEndpoint,\n    };\n  }\n\n  /** Get summary info for all known agents */\n  async getAgents(): Promise<AgentSummary[]> {\n    const allRecords = await this.storage.query({});\n    const agentMap = new Map<\n      string,\n      { team: string | null; raw: bigint; count: number; lastActive: number }\n    >();\n\n    for (const r of allRecords) {\n      const entry = agentMap.get(r.agent_id) ?? {\n        team: r.team,\n        raw: 0n,\n        count: 0,\n        lastActive: 0,\n      };\n      entry.raw += parseUSDC(r.amount);\n      entry.count++;\n      if (r.created_at > entry.lastActive) entry.lastActive = r.created_at;\n      agentMap.set(r.agent_id, entry);\n    }\n\n    return [...agentMap.entries()].map(([agentId, data]) => ({\n      agentId,\n      team: data.team,\n      totalSpend: formatUSDCHuman(data.raw),\n      transactionCount: data.count,\n      lastActive: data.lastActive,\n    }));\n  }\n\n  /** Get all violations and anomalies as alerts */\n  async getAlerts(): Promise<Alert[]> {\n    const allRecords = await this.storage.query({});\n    const alerts: Alert[] = [];\n\n    for (const r of allRecords) {\n      if (r.policy_evaluation === \"blocked\") {\n        alerts.push({\n          type: \"violation\",\n          record: r,\n          message: `Budget violation by ${r.agent_id} on ${r.endpoint}: $${r.amount}`,\n        });\n      } else if (r.policy_evaluation === \"flagged\") {\n        alerts.push({\n          type: \"anomaly\",\n          record: r,\n          message: `Anomaly detected for ${r.agent_id} on ${r.endpoint}: $${r.amount}`,\n        });\n      }\n    }\n\n    return alerts;\n  }\n\n  /** Stub: Sync local records to remote API (future api.valeo.money) */\n  async sync(): Promise<{ synced: number }> {\n    // Future implementation: POST local records to remote API\n    console.warn(\"[sentinel] Dashboard sync is not yet implemented — records remain local only\");\n    return { synced: 0 };\n  }\n\n  /** Stub: Export audit data as PDF via remote API */\n  async exportPDF(_query: AuditQuery): Promise<Buffer> {\n    throw new Error(\"PDF export requires the Valeo hosted dashboard (api.valeo.money) — coming soon\");\n  }\n\n  private async getFilteredRecords(query: SpendQuery): Promise<AuditRecord[]> {\n    if (query.agentId) {\n      const result = await spendByAgent(this.storage, query.agentId, query.range);\n      return result.records;\n    }\n    if (query.team) {\n      const result = await spendByTeam(this.storage, query.team, query.range);\n      return result.records;\n    }\n    if (query.endpoint) {\n      const result = await spendByEndpoint(this.storage, query.endpoint, query.range);\n      return result.records;\n    }\n    // No filter — get all in time range\n    const result = await spendByEndpoint(this.storage, \"\", query.range);\n    return result.records;\n  }\n}\n\nexport {\n  spendByAgent,\n  spendByTeam,\n  spendByEndpoint,\n  topSpenders,\n  violations,\n  anomalies,\n  type TimeRange,\n  type SpendResult,\n} from \"./queries\";\n"]}

package/dist/dashboard.d.cts

@@ -0,0 +1,95 @@
+import { A as AuditRecord, S as StorageBackend, a as AuditQuery } from './interface-CNi4rtm1.cjs';
+
+type TimeRange = "last_hour" | "last_day" | "last_week" | "last_month" | {
+    start: number;
+    end: number;
+};
+interface SpendResult {
+    spend: string;
+    count: number;
+    records: AuditRecord[];
+}
+/** Query spend for a specific agent within a time range */
+declare function spendByAgent(storage: StorageBackend, agentId: string, range: TimeRange): Promise<SpendResult>;
+/** Query spend for a team within a time range */
+declare function spendByTeam(storage: StorageBackend, team: string, range: TimeRange): Promise<SpendResult>;
+/** Query spend for an endpoint pattern within a time range */
+declare function spendByEndpoint(storage: StorageBackend, pattern: string, range: TimeRange): Promise<SpendResult>;
+/** Get top spending agents within a time range */
+declare function topSpenders(storage: StorageBackend, limit: number, range: TimeRange): Promise<Array<{
+    agentId: string;
+    spend: string;
+    count: number;
+}>>;
+/** Get all blocked (violation) records within a time range */
+declare function violations(storage: StorageBackend, range: TimeRange): Promise<AuditRecord[]>;
+/** Get all flagged (anomaly) records within a time range */
+declare function anomalies(storage: StorageBackend, range: TimeRange): Promise<AuditRecord[]>;
+
+/** Query parameters for dashboard spend queries */
+interface SpendQuery {
+    agentId?: string;
+    team?: string;
+    endpoint?: string;
+    range: TimeRange;
+}
+/** Aggregated spend report */
+interface SpendReport {
+    totalSpend: string;
+    count: number;
+    byAgent: Record<string, {
+        spend: string;
+        count: number;
+    }>;
+    byEndpoint: Record<string, {
+        spend: string;
+        count: number;
+    }>;
+}
+/** Summary for a single agent */
+interface AgentSummary {
+    agentId: string;
+    team: string | null;
+    totalSpend: string;
+    transactionCount: number;
+    lastActive: number;
+}
+/** Alert from violations or anomaly detection */
+interface Alert {
+    type: "violation" | "anomaly";
+    record: AuditRecord;
+    message: string;
+}
+interface DashboardConfig {
+    storage: StorageBackend;
+    apiKey?: string;
+    baseUrl?: string;
+}
+/**
+ * Dashboard client for querying Sentinel audit data.
+ * Runs queries locally against the configured StorageBackend.
+ * Remote sync/export are stubs for future api.valeo.money integration.
+ */
+declare class SentinelDashboard {
+    private readonly storage;
+    /** @internal Reserved for future remote API integration */
+    readonly apiKey?: string;
+    /** @internal Reserved for future remote API integration */
+    readonly baseUrl: string;
+    constructor(config: DashboardConfig);
+    /** Query spend data with flexible filters */
+    getSpend(query: SpendQuery): Promise<SpendReport>;
+    /** Get summary info for all known agents */
+    getAgents(): Promise<AgentSummary[]>;
+    /** Get all violations and anomalies as alerts */
+    getAlerts(): Promise<Alert[]>;
+    /** Stub: Sync local records to remote API (future api.valeo.money) */
+    sync(): Promise<{
+        synced: number;
+    }>;
+    /** Stub: Export audit data as PDF via remote API */
+    exportPDF(_query: AuditQuery): Promise<Buffer>;
+    private getFilteredRecords;
+}
+
+export { type AgentSummary, type Alert, type DashboardConfig, SentinelDashboard, type SpendQuery, type SpendReport, type SpendResult, type TimeRange, anomalies, spendByAgent, spendByEndpoint, spendByTeam, topSpenders, violations };

package/dist/dashboard.d.ts

@@ -0,0 +1,95 @@
+import { A as AuditRecord, S as StorageBackend, a as AuditQuery } from './interface-CNi4rtm1.js';
+
+type TimeRange = "last_hour" | "last_day" | "last_week" | "last_month" | {
+    start: number;
+    end: number;
+};
+interface SpendResult {
+    spend: string;
+    count: number;
+    records: AuditRecord[];
+}
+/** Query spend for a specific agent within a time range */
+declare function spendByAgent(storage: StorageBackend, agentId: string, range: TimeRange): Promise<SpendResult>;
+/** Query spend for a team within a time range */
+declare function spendByTeam(storage: StorageBackend, team: string, range: TimeRange): Promise<SpendResult>;
+/** Query spend for an endpoint pattern within a time range */
+declare function spendByEndpoint(storage: StorageBackend, pattern: string, range: TimeRange): Promise<SpendResult>;
+/** Get top spending agents within a time range */
+declare function topSpenders(storage: StorageBackend, limit: number, range: TimeRange): Promise<Array<{
+    agentId: string;
+    spend: string;
+    count: number;
+}>>;
+/** Get all blocked (violation) records within a time range */
+declare function violations(storage: StorageBackend, range: TimeRange): Promise<AuditRecord[]>;
+/** Get all flagged (anomaly) records within a time range */
+declare function anomalies(storage: StorageBackend, range: TimeRange): Promise<AuditRecord[]>;
+
+/** Query parameters for dashboard spend queries */
+interface SpendQuery {
+    agentId?: string;
+    team?: string;
+    endpoint?: string;
+    range: TimeRange;
+}
+/** Aggregated spend report */
+interface SpendReport {
+    totalSpend: string;
+    count: number;
+    byAgent: Record<string, {
+        spend: string;
+        count: number;
+    }>;
+    byEndpoint: Record<string, {
+        spend: string;
+        count: number;
+    }>;
+}
+/** Summary for a single agent */
+interface AgentSummary {
+    agentId: string;
+    team: string | null;
+    totalSpend: string;
+    transactionCount: number;
+    lastActive: number;
+}
+/** Alert from violations or anomaly detection */
+interface Alert {
+    type: "violation" | "anomaly";
+    record: AuditRecord;
+    message: string;
+}
+interface DashboardConfig {
+    storage: StorageBackend;
+    apiKey?: string;
+    baseUrl?: string;
+}
+/**
+ * Dashboard client for querying Sentinel audit data.
+ * Runs queries locally against the configured StorageBackend.
+ * Remote sync/export are stubs for future api.valeo.money integration.
+ */
+declare class SentinelDashboard {
+    private readonly storage;
+    /** @internal Reserved for future remote API integration */
+    readonly apiKey?: string;
+    /** @internal Reserved for future remote API integration */
+    readonly baseUrl: string;
+    constructor(config: DashboardConfig);
+    /** Query spend data with flexible filters */
+    getSpend(query: SpendQuery): Promise<SpendReport>;
+    /** Get summary info for all known agents */
+    getAgents(): Promise<AgentSummary[]>;
+    /** Get all violations and anomalies as alerts */
+    getAlerts(): Promise<Alert[]>;
+    /** Stub: Sync local records to remote API (future api.valeo.money) */
+    sync(): Promise<{
+        synced: number;
+    }>;
+    /** Stub: Export audit data as PDF via remote API */
+    exportPDF(_query: AuditQuery): Promise<Buffer>;
+    private getFilteredRecords;
+}
+
+export { type AgentSummary, type Alert, type DashboardConfig, SentinelDashboard, type SpendQuery, type SpendReport, type SpendResult, type TimeRange, anomalies, spendByAgent, spendByEndpoint, spendByTeam, topSpenders, violations };

package/dist/dashboard.js

@@ -0,0 +1,170 @@
+import { resolveTimeRange, parseUSDC, formatUSDCHuman } from './chunk-25PZCEL2.js';
+
+// src/dashboard/queries.ts
+async function spendByAgent(storage, agentId, range) {
+  const { start, end } = resolveTimeRange(range);
+  const records = await storage.query({ agentId, startTime: start, endTime: end });
+  return aggregateSpend(records);
+}
+async function spendByTeam(storage, team, range) {
+  const { start, end } = resolveTimeRange(range);
+  const records = await storage.query({ team, startTime: start, endTime: end });
+  return aggregateSpend(records);
+}
+async function spendByEndpoint(storage, pattern, range) {
+  const { start, end } = resolveTimeRange(range);
+  const records = await storage.query({ endpoint: pattern, startTime: start, endTime: end });
+  return aggregateSpend(records);
+}
+async function topSpenders(storage, limit, range) {
+  const { start, end } = resolveTimeRange(range);
+  const records = await storage.query({ startTime: start, endTime: end });
+  const byAgent = /* @__PURE__ */ new Map();
+  for (const r of records) {
+    const entry = byAgent.get(r.agent_id) ?? { raw: 0n, count: 0 };
+    entry.raw += parseUSDC(r.amount);
+    entry.count++;
+    byAgent.set(r.agent_id, entry);
+  }
+  return [...byAgent.entries()].map(([agentId, data]) => ({
+    agentId,
+    spend: formatUSDCHuman(data.raw),
+    count: data.count
+  })).sort((a, b) => {
+    const aRaw = parseUSDC(a.spend);
+    const bRaw = parseUSDC(b.spend);
+    return aRaw > bRaw ? -1 : aRaw < bRaw ? 1 : 0;
+  }).slice(0, limit);
+}
+async function violations(storage, range) {
+  const { start, end } = resolveTimeRange(range);
+  return storage.query({ status: ["blocked"], startTime: start, endTime: end });
+}
+async function anomalies(storage, range) {
+  const { start, end } = resolveTimeRange(range);
+  return storage.query({ status: ["flagged"], startTime: start, endTime: end });
+}
+function aggregateSpend(records) {
+  let totalRaw = 0n;
+  for (const r of records) {
+    totalRaw += parseUSDC(r.amount);
+  }
+  return {
+    spend: formatUSDCHuman(totalRaw),
+    count: records.length,
+    records
+  };
+}
+
+// src/dashboard/index.ts
+var SentinelDashboard = class {
+  storage;
+  /** @internal Reserved for future remote API integration */
+  apiKey;
+  /** @internal Reserved for future remote API integration */
+  baseUrl;
+  constructor(config) {
+    this.storage = config.storage;
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl ?? "https://api.valeo.money/v1";
+  }
+  /** Query spend data with flexible filters */
+  async getSpend(query) {
+    const records = await this.getFilteredRecords(query);
+    let totalRaw = 0n;
+    const byAgent = {};
+    const byEndpoint = {};
+    for (const r of records) {
+      const raw = parseUSDC(r.amount);
+      totalRaw += raw;
+      const agentEntry = byAgent[r.agent_id] ?? { spend: "0.00", count: 0 };
+      agentEntry.spend = formatUSDCHuman(parseUSDC(agentEntry.spend) + raw);
+      agentEntry.count++;
+      byAgent[r.agent_id] = agentEntry;
+      const epEntry = byEndpoint[r.endpoint] ?? { spend: "0.00", count: 0 };
+      epEntry.spend = formatUSDCHuman(parseUSDC(epEntry.spend) + raw);
+      epEntry.count++;
+      byEndpoint[r.endpoint] = epEntry;
+    }
+    return {
+      totalSpend: formatUSDCHuman(totalRaw),
+      count: records.length,
+      byAgent,
+      byEndpoint
+    };
+  }
+  /** Get summary info for all known agents */
+  async getAgents() {
+    const allRecords = await this.storage.query({});
+    const agentMap = /* @__PURE__ */ new Map();
+    for (const r of allRecords) {
+      const entry = agentMap.get(r.agent_id) ?? {
+        team: r.team,
+        raw: 0n,
+        count: 0,
+        lastActive: 0
+      };
+      entry.raw += parseUSDC(r.amount);
+      entry.count++;
+      if (r.created_at > entry.lastActive) entry.lastActive = r.created_at;
+      agentMap.set(r.agent_id, entry);
+    }
+    return [...agentMap.entries()].map(([agentId, data]) => ({
+      agentId,
+      team: data.team,
+      totalSpend: formatUSDCHuman(data.raw),
+      transactionCount: data.count,
+      lastActive: data.lastActive
+    }));
+  }
+  /** Get all violations and anomalies as alerts */
+  async getAlerts() {
+    const allRecords = await this.storage.query({});
+    const alerts = [];
+    for (const r of allRecords) {
+      if (r.policy_evaluation === "blocked") {
+        alerts.push({
+          type: "violation",
+          record: r,
+          message: `Budget violation by ${r.agent_id} on ${r.endpoint}: $${r.amount}`
+        });
+      } else if (r.policy_evaluation === "flagged") {
+        alerts.push({
+          type: "anomaly",
+          record: r,
+          message: `Anomaly detected for ${r.agent_id} on ${r.endpoint}: $${r.amount}`
+        });
+      }
+    }
+    return alerts;
+  }
+  /** Stub: Sync local records to remote API (future api.valeo.money) */
+  async sync() {
+    console.warn("[sentinel] Dashboard sync is not yet implemented \u2014 records remain local only");
+    return { synced: 0 };
+  }
+  /** Stub: Export audit data as PDF via remote API */
+  async exportPDF(_query) {
+    throw new Error("PDF export requires the Valeo hosted dashboard (api.valeo.money) \u2014 coming soon");
+  }
+  async getFilteredRecords(query) {
+    if (query.agentId) {
+      const result2 = await spendByAgent(this.storage, query.agentId, query.range);
+      return result2.records;
+    }
+    if (query.team) {
+      const result2 = await spendByTeam(this.storage, query.team, query.range);
+      return result2.records;
+    }
+    if (query.endpoint) {
+      const result2 = await spendByEndpoint(this.storage, query.endpoint, query.range);
+      return result2.records;
+    }
+    const result = await spendByEndpoint(this.storage, "", query.range);
+    return result.records;
+  }
+};
+
+export { SentinelDashboard, anomalies, spendByAgent, spendByEndpoint, spendByTeam, topSpenders, violations };
+//# sourceMappingURL=dashboard.js.map
+//# sourceMappingURL=dashboard.js.map

package/dist/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dashboard/queries.ts","../src/dashboard/index.ts"],"names":["result"],"mappings":"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","file":"dashboard.js","sourcesContent":["import type { AuditRecord } from \"../types/audit\";\nimport type { StorageBackend } from \"../audit/storage/interface\";\nimport { resolveTimeRange } from \"../utils/time\";\nimport { parseUSDC, formatUSDCHuman } from \"../utils/money\";\n\nexport type TimeRange =\n  | \"last_hour\"\n  | \"last_day\"\n  | \"last_week\"\n  | \"last_month\"\n  | { start: number; end: number };\n\nexport interface SpendResult {\n  spend: string;\n  count: number;\n  records: AuditRecord[];\n}\n\n/** Query spend for a specific agent within a time range */\nexport async function spendByAgent(\n  storage: StorageBackend,\n  agentId: string,\n  range: TimeRange,\n): Promise<SpendResult> {\n  const { start, end } = resolveTimeRange(range);\n  const records = await storage.query({ agentId, startTime: start, endTime: end });\n  return aggregateSpend(records);\n}\n\n/** Query spend for a team within a time range */\nexport async function spendByTeam(\n  storage: StorageBackend,\n  team: string,\n  range: TimeRange,\n): Promise<SpendResult> {\n  const { start, end } = resolveTimeRange(range);\n  const records = await storage.query({ team, startTime: start, endTime: end });\n  return aggregateSpend(records);\n}\n\n/** Query spend for an endpoint pattern within a time range */\nexport async function spendByEndpoint(\n  storage: StorageBackend,\n  pattern: string,\n  range: TimeRange,\n): Promise<SpendResult> {\n  const { start, end } = resolveTimeRange(range);\n  const records = await storage.query({ endpoint: pattern, startTime: start, endTime: end });\n  return aggregateSpend(records);\n}\n\n/** Get top spending agents within a time range */\nexport async function topSpenders(\n  storage: StorageBackend,\n  limit: number,\n  range: TimeRange,\n): Promise<Array<{ agentId: string; spend: string; count: number }>> {\n  const { start, end } = resolveTimeRange(range);\n  const records = await storage.query({ startTime: start, endTime: end });\n\n  const byAgent = new Map<string, { raw: bigint; count: number }>();\n  for (const r of records) {\n    const entry = byAgent.get(r.agent_id) ?? { raw: 0n, count: 0 };\n    entry.raw += parseUSDC(r.amount);\n    entry.count++;\n    byAgent.set(r.agent_id, entry);\n  }\n\n  return [...byAgent.entries()]\n    .map(([agentId, data]) => ({\n      agentId,\n      spend: formatUSDCHuman(data.raw),\n      count: data.count,\n    }))\n    .sort((a, b) => {\n      const aRaw = parseUSDC(a.spend);\n      const bRaw = parseUSDC(b.spend);\n      return aRaw > bRaw ? -1 : aRaw < bRaw ? 1 : 0;\n    })\n    .slice(0, limit);\n}\n\n/** Get all blocked (violation) records within a time range */\nexport async function violations(\n  storage: StorageBackend,\n  range: TimeRange,\n): Promise<AuditRecord[]> {\n  const { start, end } = resolveTimeRange(range);\n  return storage.query({ status: [\"blocked\"], startTime: start, endTime: end });\n}\n\n/** Get all flagged (anomaly) records within a time range */\nexport async function anomalies(\n  storage: StorageBackend,\n  range: TimeRange,\n): Promise<AuditRecord[]> {\n  const { start, end } = resolveTimeRange(range);\n  return storage.query({ status: [\"flagged\"], startTime: start, endTime: end });\n}\n\nfunction aggregateSpend(records: AuditRecord[]): SpendResult {\n  let totalRaw = 0n;\n  for (const r of records) {\n    totalRaw += parseUSDC(r.amount);\n  }\n  return {\n    spend: formatUSDCHuman(totalRaw),\n    count: records.length,\n    records,\n  };\n}\n","import type { AuditRecord, AuditQuery } from \"../types/audit\";\nimport type { StorageBackend } from \"../audit/storage/interface\";\nimport { spendByAgent, spendByTeam, spendByEndpoint } from \"./queries\";\nimport type { TimeRange } from \"./queries\";\nimport { parseUSDC, formatUSDCHuman } from \"../utils/money\";\n\n/** Query parameters for dashboard spend queries */\nexport interface SpendQuery {\n  agentId?: string;\n  team?: string;\n  endpoint?: string;\n  range: TimeRange;\n}\n\n/** Aggregated spend report */\nexport interface SpendReport {\n  totalSpend: string;\n  count: number;\n  byAgent: Record<string, { spend: string; count: number }>;\n  byEndpoint: Record<string, { spend: string; count: number }>;\n}\n\n/** Summary for a single agent */\nexport interface AgentSummary {\n  agentId: string;\n  team: string | null;\n  totalSpend: string;\n  transactionCount: number;\n  lastActive: number;\n}\n\n/** Alert from violations or anomaly detection */\nexport interface Alert {\n  type: \"violation\" | \"anomaly\";\n  record: AuditRecord;\n  message: string;\n}\n\nexport interface DashboardConfig {\n  storage: StorageBackend;\n  apiKey?: string;\n  baseUrl?: string;\n}\n\n/**\n * Dashboard client for querying Sentinel audit data.\n * Runs queries locally against the configured StorageBackend.\n * Remote sync/export are stubs for future api.valeo.money integration.\n */\nexport class SentinelDashboard {\n  private readonly storage: StorageBackend;\n  /** @internal Reserved for future remote API integration */\n  readonly apiKey?: string;\n  /** @internal Reserved for future remote API integration */\n  readonly baseUrl: string;\n\n  constructor(config: DashboardConfig) {\n    this.storage = config.storage;\n    this.apiKey = config.apiKey;\n    this.baseUrl = config.baseUrl ?? \"https://api.valeo.money/v1\";\n  }\n\n  /** Query spend data with flexible filters */\n  async getSpend(query: SpendQuery): Promise<SpendReport> {\n    const records = await this.getFilteredRecords(query);\n\n    let totalRaw = 0n;\n    const byAgent: Record<string, { spend: string; count: number }> = {};\n    const byEndpoint: Record<string, { spend: string; count: number }> = {};\n\n    for (const r of records) {\n      const raw = parseUSDC(r.amount);\n      totalRaw += raw;\n\n      const agentEntry = byAgent[r.agent_id] ?? { spend: \"0.00\", count: 0 };\n      agentEntry.spend = formatUSDCHuman(parseUSDC(agentEntry.spend) + raw);\n      agentEntry.count++;\n      byAgent[r.agent_id] = agentEntry;\n\n      const epEntry = byEndpoint[r.endpoint] ?? { spend: \"0.00\", count: 0 };\n      epEntry.spend = formatUSDCHuman(parseUSDC(epEntry.spend) + raw);\n      epEntry.count++;\n      byEndpoint[r.endpoint] = epEntry;\n    }\n\n    return {\n      totalSpend: formatUSDCHuman(totalRaw),\n      count: records.length,\n      byAgent,\n      byEndpoint,\n    };\n  }\n\n  /** Get summary info for all known agents */\n  async getAgents(): Promise<AgentSummary[]> {\n    const allRecords = await this.storage.query({});\n    const agentMap = new Map<\n      string,\n      { team: string | null; raw: bigint; count: number; lastActive: number }\n    >();\n\n    for (const r of allRecords) {\n      const entry = agentMap.get(r.agent_id) ?? {\n        team: r.team,\n        raw: 0n,\n        count: 0,\n        lastActive: 0,\n      };\n      entry.raw += parseUSDC(r.amount);\n      entry.count++;\n      if (r.created_at > entry.lastActive) entry.lastActive = r.created_at;\n      agentMap.set(r.agent_id, entry);\n    }\n\n    return [...agentMap.entries()].map(([agentId, data]) => ({\n      agentId,\n      team: data.team,\n      totalSpend: formatUSDCHuman(data.raw),\n      transactionCount: data.count,\n      lastActive: data.lastActive,\n    }));\n  }\n\n  /** Get all violations and anomalies as alerts */\n  async getAlerts(): Promise<Alert[]> {\n    const allRecords = await this.storage.query({});\n    const alerts: Alert[] = [];\n\n    for (const r of allRecords) {\n      if (r.policy_evaluation === \"blocked\") {\n        alerts.push({\n          type: \"violation\",\n          record: r,\n          message: `Budget violation by ${r.agent_id} on ${r.endpoint}: $${r.amount}`,\n        });\n      } else if (r.policy_evaluation === \"flagged\") {\n        alerts.push({\n          type: \"anomaly\",\n          record: r,\n          message: `Anomaly detected for ${r.agent_id} on ${r.endpoint}: $${r.amount}`,\n        });\n      }\n    }\n\n    return alerts;\n  }\n\n  /** Stub: Sync local records to remote API (future api.valeo.money) */\n  async sync(): Promise<{ synced: number }> {\n    // Future implementation: POST local records to remote API\n    console.warn(\"[sentinel] Dashboard sync is not yet implemented — records remain local only\");\n    return { synced: 0 };\n  }\n\n  /** Stub: Export audit data as PDF via remote API */\n  async exportPDF(_query: AuditQuery): Promise<Buffer> {\n    throw new Error(\"PDF export requires the Valeo hosted dashboard (api.valeo.money) — coming soon\");\n  }\n\n  private async getFilteredRecords(query: SpendQuery): Promise<AuditRecord[]> {\n    if (query.agentId) {\n      const result = await spendByAgent(this.storage, query.agentId, query.range);\n      return result.records;\n    }\n    if (query.team) {\n      const result = await spendByTeam(this.storage, query.team, query.range);\n      return result.records;\n    }\n    if (query.endpoint) {\n      const result = await spendByEndpoint(this.storage, query.endpoint, query.range);\n      return result.records;\n    }\n    // No filter — get all in time range\n    const result = await spendByEndpoint(this.storage, \"\", query.range);\n    return result.records;\n  }\n}\n\nexport {\n  spendByAgent,\n  spendByTeam,\n  spendByEndpoint,\n  topSpenders,\n  violations,\n  anomalies,\n  type TimeRange,\n  type SpendResult,\n} from \"./queries\";\n"]}