@agentlensai/server 0.9.0 → 0.11.0

package/dist/cloud/storage/adapter.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Storage Adapter Interface (S-4.1)
+ *
+ * Abstracts over SQLite (self-hosted) and PostgreSQL (cloud) backends.
+ * All query functions go through this adapter. Feature parity is guaranteed
+ * by running the same test suite against both implementations.
+ *
+ * The adapter is tenant-aware: orgId is required on all operations.
+ * For SQLite self-hosted, orgId maps to tenantId. For Postgres, RLS
+ * enforces isolation via SET LOCAL app.current_org.
+ */
+import type { AgentLensEvent, EventQuery, EventQueryResult, Session, SessionQuery, Agent, HealthSnapshot } from '@agentlensai/core';
+import type { AnalyticsResult, StorageStats } from '@agentlensai/core';
+export interface PaginatedResult<T> {
+    items: T[];
+    total: number;
+    hasMore: boolean;
+}
+export interface AnalyticsQuery {
+    from: string;
+    to: string;
+    agentId?: string;
+    granularity: 'hour' | 'day' | 'week';
+}
+export interface CostAnalyticsResult {
+    buckets: Array<{
+        timestamp: string;
+        totalCostUsd: number;
+        eventCount: number;
+        model?: string;
+    }>;
+    totalCostUsd: number;
+    totalEvents: number;
+}
+export interface HealthAnalyticsResult {
+    snapshots: HealthSnapshot[];
+}
+export interface TokenUsageResult {
+    buckets: Array<{
+        timestamp: string;
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+        llmCallCount: number;
+    }>;
+    totals: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+        llmCallCount: number;
+    };
+}
+export interface SearchQuery {
+    query: string;
+    scope?: 'events' | 'sessions' | 'all';
+    from?: string;
+    to?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface SearchResult {
+    items: Array<{
+        type: 'event' | 'session';
+        id: string;
+        score: number;
+        headline: string;
+        timestamp: string;
+        sessionId?: string;
+    }>;
+    total: number;
+    hasMore: boolean;
+}
+export interface StorageAdapter {
+    /** Query events with filters, scoped to org */
+    queryEvents(orgId: string, query: EventQuery): Promise<EventQueryResult>;
+    /** Get all events for a session, ordered by timestamp */
+    getEventsBySession(orgId: string, sessionId: string): Promise<AgentLensEvent[]>;
+    /** List sessions with filters and pagination */
+    getSessions(orgId: string, query: SessionQuery): Promise<PaginatedResult<Session>>;
+    /** Get a single session by ID */
+    getSession(orgId: string, sessionId: string): Promise<Session | null>;
+    /** List all agents for an org */
+    getAgents(orgId: string): Promise<Agent[]>;
+    /** Get storage statistics for an org */
+    getStats(orgId: string): Promise<StorageStats>;
+    /** Cost analytics with time-bucketed aggregation */
+    getCostAnalytics(orgId: string, query: AnalyticsQuery): Promise<CostAnalyticsResult>;
+    /** Health score analytics over time */
+    getHealthAnalytics(orgId: string, query: AnalyticsQuery): Promise<HealthAnalyticsResult>;
+    /** Token usage analytics with time-bucketed aggregation */
+    getTokenUsage(orgId: string, query: AnalyticsQuery): Promise<TokenUsageResult>;
+    /** General analytics (buckets + totals) */
+    getAnalytics(orgId: string, query: AnalyticsQuery): Promise<AnalyticsResult>;
+    /** Full-text search across events and sessions */
+    search(orgId: string, query: SearchQuery): Promise<SearchResult>;
+}
+export type StorageBackend = 'sqlite' | 'postgres';
+/**
+ * Determine the active storage backend from environment.
+ */
+export declare function getStorageBackend(): StorageBackend;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/cloud/storage/adapter.d.ts.map

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

package/dist/cloud/storage/adapter.js

@@ -0,0 +1,21 @@
+/**
+ * Storage Adapter Interface (S-4.1)
+ *
+ * Abstracts over SQLite (self-hosted) and PostgreSQL (cloud) backends.
+ * All query functions go through this adapter. Feature parity is guaranteed
+ * by running the same test suite against both implementations.
+ *
+ * The adapter is tenant-aware: orgId is required on all operations.
+ * For SQLite self-hosted, orgId maps to tenantId. For Postgres, RLS
+ * enforces isolation via SET LOCAL app.current_org.
+ */
+/**
+ * Determine the active storage backend from environment.
+ */
+export function getStorageBackend() {
+    const backend = process.env['STORAGE_BACKEND'] ?? process.env['DB_DIALECT'] ?? 'sqlite';
+    if (backend === 'postgresql' || backend === 'postgres')
+        return 'postgres';
+    return 'sqlite';
+}
+//# sourceMappingURL=adapter.js.map

package/dist/cloud/storage/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/cloud/storage/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA+HH;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,QAAQ,CAAC;IACxF,IAAI,OAAO,KAAK,YAAY,IAAI,OAAO,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAC1E,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/cloud/storage/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Storage Adapter — Public API
+ */
+export type { StorageAdapter, PaginatedResult, StorageBackend, AnalyticsQuery, CostAnalyticsResult, HealthAnalyticsResult, TokenUsageResult, SearchQuery, SearchResult, } from './adapter.js';
+export { getStorageBackend } from './adapter.js';
+export { SqliteStorageAdapter } from './sqlite-adapter.js';
+export { PostgresStorageAdapter } from './postgres-adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cloud/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cloud/storage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACX,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/cloud/storage/index.js

@@ -0,0 +1,7 @@
+/**
+ * Storage Adapter — Public API
+ */
+export { getStorageBackend } from './adapter.js';
+export { SqliteStorageAdapter } from './sqlite-adapter.js';
+export { PostgresStorageAdapter } from './postgres-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/cloud/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cloud/storage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/cloud/storage/postgres-adapter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * PostgreSQL Storage Adapter (S-4.2, S-4.3, S-4.4)
+ *
+ * Implements StorageAdapter for the cloud Postgres backend.
+ * Uses the tenant pool from B2A for automatic org scoping via
+ * SET LOCAL app.current_org within transactions.
+ *
+ * All queries use org_id composite indexes. RLS provides automatic
+ * tenant scoping as defense-in-depth (queries also filter by org_id
+ * explicitly for index usage).
+ *
+ * S-4.3: Analytics queries use date_trunc + window functions for Postgres.
+ * S-4.4: Full-text search uses tsvector/to_tsquery with GIN indexes.
+ */
+import type { AgentLensEvent, EventQuery, EventQueryResult, Session, SessionQuery, Agent } from '@agentlensai/core';
+import type { AnalyticsResult, StorageStats } from '@agentlensai/core';
+import type { StorageAdapter, PaginatedResult, AnalyticsQuery, CostAnalyticsResult, HealthAnalyticsResult, TokenUsageResult, SearchQuery, SearchResult } from './adapter.js';
+import type { Pool } from '../tenant-pool.js';
+export declare class PostgresStorageAdapter implements StorageAdapter {
+    private readonly pool;
+    constructor(pool: Pool);
+    queryEvents(orgId: string, query: EventQuery): Promise<EventQueryResult>;
+    getEventsBySession(orgId: string, sessionId: string): Promise<AgentLensEvent[]>;
+    getSessions(orgId: string, query: SessionQuery): Promise<PaginatedResult<Session>>;
+    getSession(orgId: string, sessionId: string): Promise<Session | null>;
+    getAgents(orgId: string): Promise<Agent[]>;
+    getStats(orgId: string): Promise<StorageStats>;
+    getCostAnalytics(orgId: string, query: AnalyticsQuery): Promise<CostAnalyticsResult>;
+    getHealthAnalytics(orgId: string, query: AnalyticsQuery): Promise<HealthAnalyticsResult>;
+    getTokenUsage(orgId: string, query: AnalyticsQuery): Promise<TokenUsageResult>;
+    getAnalytics(orgId: string, query: AnalyticsQuery): Promise<AnalyticsResult>;
+    search(orgId: string, query: SearchQuery): Promise<SearchResult>;
+}
+//# sourceMappingURL=postgres-adapter.d.ts.map

package/dist/cloud/storage/postgres-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-adapter.d.ts","sourceRoot":"","sources":["../../../src/cloud/storage/postgres-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,KAAK,EAEN,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACb,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAsK9C,qBAAa,sBAAuB,YAAW,cAAc;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,IAAI;IAEjC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwBxE,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAU/E,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAuBlF,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAWrE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAU1C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAoC9C,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAuCpF,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA6CxF,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkD9E,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAyE5E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CAiKvE"}