@agentlensai/core 0.2.0

package/dist/schemas.js

@@ -0,0 +1,171 @@
+/**
+ * @agentlens/core — Zod Validation Schemas
+ *
+ * Runtime validation schemas for all API inputs per Architecture §4.2
+ */
+import { z } from 'zod';
+/**
+ * Schema for validating event types
+ */
+export const eventTypeSchema = z.enum([
+    'session_started',
+    'session_ended',
+    'tool_call',
+    'tool_response',
+    'tool_error',
+    'approval_requested',
+    'approval_granted',
+    'approval_denied',
+    'approval_expired',
+    'form_submitted',
+    'form_completed',
+    'form_expired',
+    'cost_tracked',
+    'alert_triggered',
+    'alert_resolved',
+    'custom',
+]);
+/**
+ * Schema for validating severity levels
+ */
+export const severitySchema = z.enum(['debug', 'info', 'warn', 'error', 'critical']);
+// ─── Typed Payload Schemas ──────────────────────────────────────────
+export const toolCallPayloadSchema = z.object({
+    toolName: z.string().min(1),
+    callId: z.string().min(1),
+    arguments: z.record(z.unknown()),
+    serverName: z.string().optional(),
+});
+export const toolResponsePayloadSchema = z.object({
+    callId: z.string().min(1),
+    toolName: z.string().min(1),
+    result: z.unknown(),
+    durationMs: z.number(),
+});
+export const toolErrorPayloadSchema = z.object({
+    callId: z.string().min(1),
+    toolName: z.string().min(1),
+    error: z.string(),
+    errorCode: z.string().optional(),
+    durationMs: z.number(),
+});
+export const sessionStartedPayloadSchema = z.object({
+    agentName: z.string().optional(),
+    agentVersion: z.string().optional(),
+    mcpClientInfo: z.record(z.unknown()).optional(),
+    tags: z.array(z.string()).optional(),
+});
+export const sessionEndedPayloadSchema = z.object({
+    reason: z.enum(['completed', 'error', 'timeout', 'manual']),
+    summary: z.string().optional(),
+    totalToolCalls: z.number().optional(),
+    totalDurationMs: z.number().optional(),
+});
+export const approvalRequestedPayloadSchema = z.object({
+    requestId: z.string().min(1),
+    action: z.string().min(1),
+    params: z.record(z.unknown()),
+    urgency: z.string(),
+});
+export const approvalDecisionPayloadSchema = z.object({
+    requestId: z.string().min(1),
+    action: z.string().min(1),
+    decidedBy: z.string().min(1),
+    reason: z.string().optional(),
+});
+export const formSubmittedPayloadSchema = z.object({
+    submissionId: z.string().min(1),
+    formId: z.string().min(1),
+    formName: z.string().optional(),
+    fieldCount: z.number(),
+});
+export const formCompletedPayloadSchema = z.object({
+    submissionId: z.string().min(1),
+    formId: z.string().min(1),
+    completedBy: z.string().min(1),
+    durationMs: z.number(),
+});
+export const formExpiredPayloadSchema = z.object({
+    submissionId: z.string().min(1),
+    formId: z.string().min(1),
+    expiredAfterMs: z.number(),
+});
+export const costTrackedPayloadSchema = z.object({
+    provider: z.string().min(1),
+    model: z.string().min(1),
+    inputTokens: z.number(),
+    outputTokens: z.number(),
+    totalTokens: z.number(),
+    costUsd: z.number(),
+    trigger: z.string().optional(),
+});
+export const alertTriggeredPayloadSchema = z.object({
+    alertRuleId: z.string().min(1),
+    alertName: z.string().min(1),
+    condition: z.string(),
+    currentValue: z.number(),
+    threshold: z.number(),
+    message: z.string(),
+});
+export const alertResolvedPayloadSchema = z.object({
+    alertRuleId: z.string().min(1),
+    alertName: z.string().min(1),
+    resolvedBy: z.string().optional(),
+});
+export const customPayloadSchema = z.object({
+    type: z.string(),
+    data: z.record(z.unknown()),
+});
+/**
+ * Map of event type to payload schema for type-specific validation.
+ */
+export const payloadSchemasByEventType = {
+    tool_call: toolCallPayloadSchema,
+    tool_response: toolResponsePayloadSchema,
+    tool_error: toolErrorPayloadSchema,
+    session_started: sessionStartedPayloadSchema,
+    session_ended: sessionEndedPayloadSchema,
+    approval_requested: approvalRequestedPayloadSchema,
+    approval_granted: approvalDecisionPayloadSchema,
+    approval_denied: approvalDecisionPayloadSchema,
+    approval_expired: approvalDecisionPayloadSchema,
+    form_submitted: formSubmittedPayloadSchema,
+    form_completed: formCompletedPayloadSchema,
+    form_expired: formExpiredPayloadSchema,
+    cost_tracked: costTrackedPayloadSchema,
+    alert_triggered: alertTriggeredPayloadSchema,
+    alert_resolved: alertResolvedPayloadSchema,
+    custom: customPayloadSchema,
+};
+/**
+ * Schema for validating inbound event ingestion.
+ *
+ * Uses superRefine to validate the payload against the correct
+ * type-specific schema based on eventType.
+ */
+export const ingestEventSchema = z
+    .object({
+    sessionId: z.string().min(1, 'sessionId is required'),
+    agentId: z.string().min(1, 'agentId is required'),
+    eventType: eventTypeSchema,
+    severity: severitySchema.default('info'),
+    payload: z.record(z.unknown()),
+    metadata: z.record(z.unknown()).default({}),
+    /** Optional client-side timestamp; server will validate and may override */
+    timestamp: z.string().datetime().optional(),
+})
+    .superRefine((data, ctx) => {
+    const schema = payloadSchemasByEventType[data.eventType];
+    if (schema) {
+        const result = schema.safeParse(data.payload);
+        if (!result.success) {
+            for (const issue of result.error.issues) {
+                ctx.addIssue({
+                    ...issue,
+                    path: ['payload', ...issue.path],
+                });
+            }
+        }
+    }
+});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,121 @@
+/**
+ * @agentlens/core — Storage Interface
+ *
+ * Defines the IEventStore interface that all storage backends implement.
+ * This enables pluggable storage (SQLite, PostgreSQL, in-memory for tests)
+ * and clean mock testing.
+ */
+import type { AgentLensEvent, EventQuery, EventQueryResult, Session, SessionQuery, Agent, AlertRule, AlertHistory } from './types.js';
+/**
+ * Analytics result with time-bucketed metrics and totals.
+ */
+export interface AnalyticsResult {
+    buckets: Array<{
+        timestamp: string;
+        eventCount: number;
+        toolCallCount: number;
+        errorCount: number;
+        avgLatencyMs: number;
+        totalCostUsd: number;
+        uniqueSessions: number;
+    }>;
+    totals: {
+        eventCount: number;
+        toolCallCount: number;
+        errorCount: number;
+        avgLatencyMs: number;
+        totalCostUsd: number;
+        uniqueSessions: number;
+        uniqueAgents: number;
+    };
+}
+/**
+ * Storage statistics for monitoring and the /api/stats endpoint.
+ */
+export interface StorageStats {
+    totalEvents: number;
+    totalSessions: number;
+    totalAgents: number;
+    oldestEvent?: string;
+    newestEvent?: string;
+    storageSizeBytes?: number;
+}
+/**
+ * Core storage interface — all backends implement this.
+ *
+ * Methods are grouped by domain:
+ * - Events: insert, query, get, timeline, count
+ * - Sessions: upsert, query, get
+ * - Agents: upsert, list, get
+ * - Analytics: aggregated metrics
+ * - Alert Rules: CRUD
+ * - Maintenance: retention, stats
+ */
+export interface IEventStore {
+    /** Persist one or more events (already validated & hashed) */
+    insertEvents(events: AgentLensEvent[]): Promise<void>;
+    /** Query events with filters */
+    queryEvents(query: EventQuery): Promise<EventQueryResult>;
+    /** Get a single event by ID */
+    getEvent(id: string): Promise<AgentLensEvent | null>;
+    /** Get all events in a session, ordered by timestamp ascending */
+    getSessionTimeline(sessionId: string): Promise<AgentLensEvent[]>;
+    /** Get the hash of the last event in a session (for chain continuation) */
+    getLastEventHash(sessionId: string): Promise<string | null>;
+    /** Count events matching a query (for pagination) */
+    countEvents(query: Omit<EventQuery, 'limit' | 'offset'>): Promise<number>;
+    /** Upsert session (materialized from events) */
+    upsertSession(session: Partial<Session> & {
+        id: string;
+    }): Promise<void>;
+    /** Query sessions */
+    querySessions(query: SessionQuery): Promise<{
+        sessions: Session[];
+        total: number;
+    }>;
+    /** Get a single session by ID */
+    getSession(id: string): Promise<Session | null>;
+    /** Upsert agent (materialized from events) */
+    upsertAgent(agent: Partial<Agent> & {
+        id: string;
+    }): Promise<void>;
+    /** List all agents */
+    listAgents(): Promise<Agent[]>;
+    /** Get agent by ID */
+    getAgent(id: string): Promise<Agent | null>;
+    /** Get aggregated metrics for a time range */
+    getAnalytics(params: {
+        from: string;
+        to: string;
+        agentId?: string;
+        granularity: 'hour' | 'day' | 'week';
+    }): Promise<AnalyticsResult>;
+    /** Create a new alert rule */
+    createAlertRule(rule: AlertRule): Promise<void>;
+    /** Update an existing alert rule */
+    updateAlertRule(id: string, updates: Partial<AlertRule>): Promise<void>;
+    /** Delete an alert rule */
+    deleteAlertRule(id: string): Promise<void>;
+    /** List all alert rules */
+    listAlertRules(): Promise<AlertRule[]>;
+    /** Get a single alert rule by ID */
+    getAlertRule(id: string): Promise<AlertRule | null>;
+    /** Insert an alert history record */
+    insertAlertHistory(entry: AlertHistory): Promise<void>;
+    /** List alert history with optional filters */
+    listAlertHistory(opts?: {
+        ruleId?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        entries: AlertHistory[];
+        total: number;
+    }>;
+    /** Apply retention policy — delete events older than given date */
+    applyRetention(olderThan: string): Promise<{
+        deletedCount: number;
+    }>;
+    /** Get storage statistics */
+    getStats(): Promise<StorageStats>;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

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

package/dist/storage.js

@@ -0,0 +1,9 @@
+/**
+ * @agentlens/core — Storage Interface
+ *
+ * Defines the IEventStore interface that all storage backends implement.
+ * This enables pluggable storage (SQLite, PostgreSQL, in-memory for tests)
+ * and clean mock testing.
+ */
+export {};
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/types.d.ts

@@ -0,0 +1,239 @@
+/**
+ * @agentlens/core — Core Event Types and Interfaces
+ *
+ * All types per Architecture §4.1
+ */
+/**
+ * Unique identifier (ULID for time-sortability)
+ */
+export type EventId = string;
+/**
+ * ISO 8601 timestamp string
+ */
+export type Timestamp = string;
+/**
+ * All supported event types (16 types)
+ */
+export type EventType = 'session_started' | 'session_ended' | 'tool_call' | 'tool_response' | 'tool_error' | 'approval_requested' | 'approval_granted' | 'approval_denied' | 'approval_expired' | 'form_submitted' | 'form_completed' | 'form_expired' | 'cost_tracked' | 'alert_triggered' | 'alert_resolved' | 'custom';
+/**
+ * Array of all event types for iteration/validation
+ */
+export declare const EVENT_TYPES: readonly EventType[];
+/**
+ * Severity levels for events
+ */
+export type EventSeverity = 'debug' | 'info' | 'warn' | 'error' | 'critical';
+/**
+ * Array of all severity levels for iteration/validation
+ */
+export declare const EVENT_SEVERITIES: readonly EventSeverity[];
+export interface ToolCallPayload {
+    toolName: string;
+    serverName?: string;
+    arguments: Record<string, unknown>;
+    /** Correlation ID to match with tool_response/tool_error */
+    callId: string;
+}
+export interface ToolResponsePayload {
+    callId: string;
+    toolName: string;
+    result: unknown;
+    durationMs: number;
+}
+export interface ToolErrorPayload {
+    callId: string;
+    toolName: string;
+    error: string;
+    errorCode?: string;
+    durationMs: number;
+}
+export interface SessionStartedPayload {
+    agentName?: string;
+    agentVersion?: string;
+    mcpClientInfo?: Record<string, unknown>;
+    tags?: string[];
+}
+export interface SessionEndedPayload {
+    reason: 'completed' | 'error' | 'timeout' | 'manual';
+    summary?: string;
+    totalToolCalls?: number;
+    totalDurationMs?: number;
+}
+export interface ApprovalRequestedPayload {
+    /** AgentGate request ID for cross-reference */
+    requestId: string;
+    action: string;
+    params: Record<string, unknown>;
+    urgency: string;
+}
+export interface ApprovalDecisionPayload {
+    requestId: string;
+    action: string;
+    decidedBy: string;
+    reason?: string;
+}
+export interface FormSubmittedPayload {
+    /** FormBridge submission ID */
+    submissionId: string;
+    formId: string;
+    formName?: string;
+    fieldCount: number;
+}
+export interface FormCompletedPayload {
+    submissionId: string;
+    formId: string;
+    completedBy: string;
+    durationMs: number;
+}
+export interface FormExpiredPayload {
+    submissionId: string;
+    formId: string;
+    expiredAfterMs: number;
+}
+export interface CostTrackedPayload {
+    provider: string;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    costUsd: number;
+    /** What triggered this cost (tool call, completion, etc.) */
+    trigger?: string;
+}
+export interface AlertTriggeredPayload {
+    alertRuleId: string;
+    alertName: string;
+    condition: string;
+    currentValue: number;
+    threshold: number;
+    message: string;
+}
+export interface AlertResolvedPayload {
+    alertRuleId: string;
+    alertName: string;
+    resolvedBy?: string;
+}
+export interface CustomPayload {
+    type: string;
+    data: Record<string, unknown>;
+}
+/**
+ * Discriminated union of all payload types
+ */
+export type EventPayload = ToolCallPayload | ToolResponsePayload | ToolErrorPayload | SessionStartedPayload | SessionEndedPayload | ApprovalRequestedPayload | ApprovalDecisionPayload | FormSubmittedPayload | FormCompletedPayload | FormExpiredPayload | CostTrackedPayload | AlertTriggeredPayload | AlertResolvedPayload | CustomPayload;
+/**
+ * The core event record — the fundamental unit of data in AgentLens
+ */
+export interface AgentLensEvent {
+    /** ULID — unique, time-sortable identifier */
+    id: EventId;
+    /** ISO 8601 timestamp of when the event occurred */
+    timestamp: Timestamp;
+    /** Session this event belongs to */
+    sessionId: string;
+    /** Agent that produced this event */
+    agentId: string;
+    /** Type discriminator */
+    eventType: EventType;
+    /** Severity level */
+    severity: EventSeverity;
+    /** Event-type-specific payload (see typed payloads above) */
+    payload: EventPayload;
+    /** Arbitrary metadata (tags, labels, correlation IDs) */
+    metadata: Record<string, unknown>;
+    /** SHA-256 hash of previous event in session (hash chain) */
+    prevHash: string | null;
+    /** SHA-256 hash of this event (computed on ingest) */
+    hash: string;
+}
+/**
+ * Session status enum values
+ */
+export type SessionStatus = 'active' | 'completed' | 'error';
+/**
+ * Agent session — materialized from session_started/session_ended events
+ */
+export interface Session {
+    id: string;
+    agentId: string;
+    agentName?: string;
+    startedAt: Timestamp;
+    endedAt?: Timestamp;
+    status: SessionStatus;
+    eventCount: number;
+    toolCallCount: number;
+    errorCount: number;
+    totalCostUsd: number;
+    tags: string[];
+}
+/**
+ * Registered agent
+ */
+export interface Agent {
+    id: string;
+    name: string;
+    description?: string;
+    firstSeenAt: Timestamp;
+    lastSeenAt: Timestamp;
+    sessionCount: number;
+}
+export interface EventQuery {
+    sessionId?: string;
+    agentId?: string;
+    eventType?: EventType | EventType[];
+    severity?: EventSeverity | EventSeverity[];
+    from?: Timestamp;
+    to?: Timestamp;
+    limit?: number;
+    offset?: number;
+    /** Sort direction (default: desc — newest first) */
+    order?: 'asc' | 'desc';
+    /** Full-text search on payload */
+    search?: string;
+}
+export interface EventQueryResult {
+    events: AgentLensEvent[];
+    total: number;
+    hasMore: boolean;
+}
+export interface SessionQuery {
+    agentId?: string;
+    status?: SessionStatus | SessionStatus[];
+    from?: Timestamp;
+    to?: Timestamp;
+    limit?: number;
+    offset?: number;
+    tags?: string[];
+}
+export interface SessionQueryResult {
+    sessions: Session[];
+    total: number;
+}
+export type AlertCondition = 'error_rate_exceeds' | 'cost_exceeds' | 'latency_exceeds' | 'event_count_exceeds' | 'no_events_for';
+export interface AlertRule {
+    id: string;
+    name: string;
+    enabled: boolean;
+    condition: AlertCondition;
+    threshold: number;
+    windowMinutes: number;
+    /** Scope: all agents, specific agent, specific session tag */
+    scope: {
+        agentId?: string;
+        tags?: string[];
+    };
+    /** Notification channels (webhook URLs, email, etc.) */
+    notifyChannels: string[];
+    createdAt: Timestamp;
+    updatedAt: Timestamp;
+}
+export interface AlertHistory {
+    id: string;
+    ruleId: string;
+    triggeredAt: Timestamp;
+    resolvedAt?: Timestamp;
+    currentValue: number;
+    threshold: number;
+    message: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,37 @@
+/**
+ * @agentlens/core — Core Event Types and Interfaces
+ *
+ * All types per Architecture §4.1
+ */
+/**
+ * Array of all event types for iteration/validation
+ */
+export const EVENT_TYPES = [
+    'session_started',
+    'session_ended',
+    'tool_call',
+    'tool_response',
+    'tool_error',
+    'approval_requested',
+    'approval_granted',
+    'approval_denied',
+    'approval_expired',
+    'form_submitted',
+    'form_completed',
+    'form_expired',
+    'cost_tracked',
+    'alert_triggered',
+    'alert_resolved',
+    'custom',
+];
+/**
+ * Array of all severity levels for iteration/validation
+ */
+export const EVENT_SEVERITIES = [
+    'debug',
+    'info',
+    'warn',
+    'error',
+    'critical',
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4CH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAyB;IAC/C,iBAAiB;IACjB,eAAe;IACf,WAAW;IACX,eAAe;IACf,YAAY;IACZ,oBAAoB;IACpB,kBAAkB;IAClB,iBAAiB;IACjB,kBAAkB;IAClB,gBAAgB;IAChB,gBAAgB;IAChB,cAAc;IACd,cAAc;IACd,iBAAiB;IACjB,gBAAgB;IAChB,QAAQ;CACA,CAAC;AAOX;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IACxD,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,UAAU;CACF,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@agentlensai/core",
+  "version": "0.2.0",
+  "description": "Core types, schemas, and utilities for AgentLens — AI agent observability platform",
+  "type": "module",
+  "license": "MIT",
+  "author": "Amit Paz",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/amitpaz/agentlens.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/amitpaz/agentlens/tree/main/packages/core",
+  "bugs": {
+    "url": "https://github.com/amitpaz/agentlens/issues"
+  },
+  "keywords": [
+    "agentlens",
+    "ai-agents",
+    "observability",
+    "mcp",
+    "event-sourcing",
+    "audit-trail",
+    "types",
+    "schemas",
+    "zod"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "ulid": "^3.0.2",
+    "zod": "^3.25.76"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc -b --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}