@agentlensai/core 0.2.0

package/dist/constants.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @agentlens/core — Shared Constants
+ */
+/** Default number of results per page */
+export declare const DEFAULT_PAGE_SIZE = 50;
+/** Maximum number of results per page */
+export declare const MAX_PAGE_SIZE = 500;
+/** Maximum payload size in UTF-8 bytes (10KB). Measured with Buffer.byteLength(). */
+export declare const MAX_PAYLOAD_SIZE = 10240;
+/** Default retention period in days */
+export declare const DEFAULT_RETENTION_DAYS = 90;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yCAAyC;AACzC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,yCAAyC;AACzC,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AAEtC,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,KAAK,CAAC"}

package/dist/constants.js

@@ -0,0 +1,12 @@
+/**
+ * @agentlens/core — Shared Constants
+ */
+/** Default number of results per page */
+export const DEFAULT_PAGE_SIZE = 50;
+/** Maximum number of results per page */
+export const MAX_PAGE_SIZE = 500;
+/** Maximum payload size in UTF-8 bytes (10KB). Measured with Buffer.byteLength(). */
+export const MAX_PAYLOAD_SIZE = 10240;
+/** Default retention period in days */
+export const DEFAULT_RETENTION_DAYS = 90;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yCAAyC;AACzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,yCAAyC;AACzC,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC,qFAAqF;AACrF,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAEtC,uCAAuC;AACvC,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,41 @@
+import type { AgentLensEvent, EventType, EventSeverity, EventPayload } from './types.js';
+/**
+ * Options for creating an event
+ */
+export interface CreateEventOptions {
+    /** Session this event belongs to */
+    sessionId: string;
+    /** Agent that produced this event */
+    agentId: string;
+    /** Event type */
+    eventType: EventType;
+    /** Event payload */
+    payload: EventPayload;
+    /** Severity level (defaults to 'info') */
+    severity?: EventSeverity;
+    /** Arbitrary metadata */
+    metadata?: Record<string, unknown>;
+    /** Hash of the previous event in the session chain (null for first event) */
+    prevHash?: string | null;
+    /** Optional client-provided timestamp (defaults to now) */
+    timestamp?: string;
+}
+/**
+ * Create a fully-formed AgentLensEvent with generated ULID id,
+ * ISO timestamp, default severity, and computed hash.
+ *
+ * @param options - Event creation options
+ * @returns A complete AgentLensEvent ready for persistence
+ */
+export declare function createEvent(options: CreateEventOptions): AgentLensEvent;
+/**
+ * Truncate a payload if its JSON serialization exceeds MAX_PAYLOAD_SIZE.
+ *
+ * When truncated, the payload is replaced with a summary object containing
+ * a `_truncated: true` flag and the original size.
+ *
+ * @param payload - The event payload to potentially truncate
+ * @returns The original payload or a truncated version
+ */
+export declare function truncatePayload(payload: EventPayload): EventPayload;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAIzF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,oBAAoB;IACpB,OAAO,EAAE,YAAY,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,cAAc,CAkCvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAgBnE"}

package/dist/events.js

@@ -0,0 +1,73 @@
+/**
+ * @agentlens/core — Event Creation Helpers
+ *
+ * Factory functions for creating events with proper defaults.
+ */
+import { ulid } from 'ulid';
+import { computeEventHash } from './hash.js';
+import { MAX_PAYLOAD_SIZE } from './constants.js';
+/**
+ * Create a fully-formed AgentLensEvent with generated ULID id,
+ * ISO timestamp, default severity, and computed hash.
+ *
+ * @param options - Event creation options
+ * @returns A complete AgentLensEvent ready for persistence
+ */
+export function createEvent(options) {
+    const id = ulid();
+    const timestamp = options.timestamp ?? new Date().toISOString();
+    const severity = options.severity ?? 'info';
+    const metadata = options.metadata ?? {};
+    const prevHash = options.prevHash ?? null;
+    // Truncate payload if needed
+    const payload = truncatePayload(options.payload);
+    const hash = computeEventHash({
+        id,
+        timestamp,
+        sessionId: options.sessionId,
+        agentId: options.agentId,
+        eventType: options.eventType,
+        severity,
+        payload,
+        metadata,
+        prevHash,
+    });
+    return {
+        id,
+        timestamp,
+        sessionId: options.sessionId,
+        agentId: options.agentId,
+        eventType: options.eventType,
+        severity,
+        payload,
+        metadata,
+        prevHash,
+        hash,
+    };
+}
+/**
+ * Truncate a payload if its JSON serialization exceeds MAX_PAYLOAD_SIZE.
+ *
+ * When truncated, the payload is replaced with a summary object containing
+ * a `_truncated: true` flag and the original size.
+ *
+ * @param payload - The event payload to potentially truncate
+ * @returns The original payload or a truncated version
+ */
+export function truncatePayload(payload) {
+    const serialized = JSON.stringify(payload);
+    const byteLength = Buffer.byteLength(serialized, 'utf8');
+    if (byteLength <= MAX_PAYLOAD_SIZE) {
+        return payload;
+    }
+    return {
+        type: '_truncated',
+        data: {
+            _truncated: true,
+            originalSize: byteLength,
+            maxSize: MAX_PAYLOAD_SIZE,
+            preview: serialized.slice(0, 200) + '...',
+        },
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAwBlD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC;IAClB,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC;IAC5C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;IAE1C,6BAA6B;IAC7B,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjD,MAAM,IAAI,GAAG,gBAAgB,CAAC;QAC5B,EAAE;QACF,SAAS;QACT,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,QAAQ;KACT,CAAC,CAAC;IAEH,OAAO;QACL,EAAE;QACF,SAAS;QACT,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,QAAQ;QACR,IAAI;KACL,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,OAAqB;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACzD,IAAI,UAAU,IAAI,gBAAgB,EAAE,CAAC;QACnC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE;YACJ,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,UAAU;YACxB,OAAO,EAAE,gBAAgB;YACzB,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK;SAC1C;KACc,CAAC;AACpB,CAAC"}

package/dist/hash.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Hash format version. Bump when changing hash input structure
+ * to distinguish old vs new hashes.
+ */
+export declare const HASH_VERSION = 2;
+/**
+ * Input type for computing event hash.
+ * Includes all fields that contribute to the hash.
+ */
+export interface HashableEvent {
+    id: string;
+    timestamp: string;
+    sessionId: string;
+    agentId: string;
+    eventType: string;
+    severity: string;
+    payload: unknown;
+    metadata: Record<string, unknown>;
+    prevHash: string | null;
+}
+/**
+ * Compute a deterministic SHA-256 hash for an event.
+ *
+ * The hash is computed from a canonical JSON representation of the
+ * event's key fields plus the previous event's hash (hash chain).
+ *
+ * @param event - The event fields to hash
+ * @returns Hex-encoded SHA-256 hash string
+ */
+export declare function computeEventHash(event: HashableEvent): string;
+/**
+ * Interface for events in chain verification.
+ * Must include all hashable fields so hashes can be recomputed.
+ */
+export interface ChainEvent extends HashableEvent {
+    hash: string;
+}
+/**
+ * Detailed result from chain verification.
+ */
+export interface ChainVerificationResult {
+    valid: boolean;
+    /** Index of the first event that failed verification, or -1 if valid */
+    failedAtIndex: number;
+    /** Human-readable reason for the failure, or null if valid */
+    reason: string | null;
+}
+/**
+ * Verify the integrity of a hash chain.
+ *
+ * For each event:
+ * 1. Recomputes the hash from event contents and verifies it matches event.hash
+ * 2. Checks that prevHash matches the previous event's hash
+ *
+ * The first event in a chain should have prevHash = null.
+ *
+ * @param events - Ordered array of full events to verify
+ * @returns ChainVerificationResult with details on any failure
+ */
+export declare function verifyChain(events: ChainEvent[]): ChainVerificationResult;
+//# sourceMappingURL=hash.d.ts.map

package/dist/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAc7D;AAED;;;GAGG;AACH,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,uBAAuB,CAoCzE"}

package/dist/hash.js

@@ -0,0 +1,81 @@
+/**
+ * @agentlens/core — Hash Chain Utilities
+ *
+ * Cryptographic hash chain for tamper evidence per Architecture §4.3
+ */
+import { createHash } from 'node:crypto';
+/**
+ * Hash format version. Bump when changing hash input structure
+ * to distinguish old vs new hashes.
+ */
+export const HASH_VERSION = 2;
+/**
+ * Compute a deterministic SHA-256 hash for an event.
+ *
+ * The hash is computed from a canonical JSON representation of the
+ * event's key fields plus the previous event's hash (hash chain).
+ *
+ * @param event - The event fields to hash
+ * @returns Hex-encoded SHA-256 hash string
+ */
+export function computeEventHash(event) {
+    const canonical = JSON.stringify({
+        v: HASH_VERSION,
+        id: event.id,
+        timestamp: event.timestamp,
+        sessionId: event.sessionId,
+        agentId: event.agentId,
+        eventType: event.eventType,
+        severity: event.severity,
+        payload: event.payload,
+        metadata: event.metadata,
+        prevHash: event.prevHash,
+    });
+    return createHash('sha256').update(canonical).digest('hex');
+}
+/**
+ * Verify the integrity of a hash chain.
+ *
+ * For each event:
+ * 1. Recomputes the hash from event contents and verifies it matches event.hash
+ * 2. Checks that prevHash matches the previous event's hash
+ *
+ * The first event in a chain should have prevHash = null.
+ *
+ * @param events - Ordered array of full events to verify
+ * @returns ChainVerificationResult with details on any failure
+ */
+export function verifyChain(events) {
+    if (events.length === 0) {
+        return { valid: true, failedAtIndex: -1, reason: null };
+    }
+    // First event should have prevHash = null
+    if (events[0].prevHash !== null) {
+        return {
+            valid: false,
+            failedAtIndex: 0,
+            reason: 'First event must have prevHash = null',
+        };
+    }
+    for (let i = 0; i < events.length; i++) {
+        // Recompute hash from contents
+        const recomputed = computeEventHash(events[i]);
+        if (recomputed !== events[i].hash) {
+            return {
+                valid: false,
+                failedAtIndex: i,
+                reason: `Event ${i} hash mismatch: expected ${recomputed}, got ${events[i].hash}`,
+            };
+        }
+        // Verify prevHash chain continuity (skip first event, already checked prevHash === null)
+        if (i > 0 && events[i].prevHash !== events[i - 1].hash) {
+            return {
+                valid: false,
+                failedAtIndex: i,
+                reason: `Event ${i} prevHash does not match previous event's hash`,
+            };
+        }
+    }
+    return { valid: true, failedAtIndex: -1, reason: null };
+}
+//# sourceMappingURL=hash.js.map

package/dist/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAkB9B;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAC/B,CAAC,EAAE,YAAY;QACf,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC;IACH,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAqBD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,MAAoB;IAC9C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;IAED,0CAA0C;IAC1C,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAChC,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,aAAa,EAAE,CAAC;YAChB,MAAM,EAAE,uCAAuC;SAChD,CAAC;IACJ,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,+BAA+B;QAC/B,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,IAAI,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAClC,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,aAAa,EAAE,CAAC;gBAChB,MAAM,EAAE,SAAS,CAAC,4BAA4B,UAAU,SAAS,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;aAClF,CAAC;QACJ,CAAC;QAED,yFAAyF;QACzF,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACvD,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,aAAa,EAAE,CAAC;gBAChB,MAAM,EAAE,SAAS,CAAC,gDAAgD;aACnE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @agentlens/core — Shared types, validation schemas, and utilities
+ */
+export * from './types.js';
+export * from './storage.js';
+export * from './schemas.js';
+export * from './hash.js';
+export * from './events.js';
+export * from './constants.js';
+export * from './alert-schemas.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,YAAY,CAAC;AAG3B,cAAc,cAAc,CAAC;AAG7B,cAAc,cAAc,CAAC;AAG7B,cAAc,WAAW,CAAC;AAG1B,cAAc,aAAa,CAAC;AAG5B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * @agentlens/core — Shared types, validation schemas, and utilities
+ */
+// Re-export all types
+export * from './types.js';
+// Re-export storage interface
+export * from './storage.js';
+// Re-export schemas
+export * from './schemas.js';
+// Re-export hash chain utilities
+export * from './hash.js';
+// Re-export event creation helpers
+export * from './events.js';
+// Re-export constants
+export * from './constants.js';
+// Re-export alert schemas
+export * from './alert-schemas.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,sBAAsB;AACtB,cAAc,YAAY,CAAC;AAE3B,8BAA8B;AAC9B,cAAc,cAAc,CAAC;AAE7B,oBAAoB;AACpB,cAAc,cAAc,CAAC;AAE7B,iCAAiC;AACjC,cAAc,WAAW,CAAC;AAE1B,mCAAmC;AACnC,cAAc,aAAa,CAAC;AAE5B,sBAAsB;AACtB,cAAc,gBAAgB,CAAC;AAE/B,0BAA0B;AAC1B,cAAc,oBAAoB,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,301 @@
+/**
+ * @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 declare const eventTypeSchema: z.ZodEnum<["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 declare const severitySchema: z.ZodEnum<["debug", "info", "warn", "error", "critical"]>;
+export declare const toolCallPayloadSchema: z.ZodObject<{
+    toolName: z.ZodString;
+    callId: z.ZodString;
+    arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    serverName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    arguments: Record<string, unknown>;
+    toolName: string;
+    callId: string;
+    serverName?: string | undefined;
+}, {
+    arguments: Record<string, unknown>;
+    toolName: string;
+    callId: string;
+    serverName?: string | undefined;
+}>;
+export declare const toolResponsePayloadSchema: z.ZodObject<{
+    callId: z.ZodString;
+    toolName: z.ZodString;
+    result: z.ZodUnknown;
+    durationMs: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    toolName: string;
+    callId: string;
+    durationMs: number;
+    result?: unknown;
+}, {
+    toolName: string;
+    callId: string;
+    durationMs: number;
+    result?: unknown;
+}>;
+export declare const toolErrorPayloadSchema: z.ZodObject<{
+    callId: z.ZodString;
+    toolName: z.ZodString;
+    error: z.ZodString;
+    errorCode: z.ZodOptional<z.ZodString>;
+    durationMs: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    error: string;
+    toolName: string;
+    callId: string;
+    durationMs: number;
+    errorCode?: string | undefined;
+}, {
+    error: string;
+    toolName: string;
+    callId: string;
+    durationMs: number;
+    errorCode?: string | undefined;
+}>;
+export declare const sessionStartedPayloadSchema: z.ZodObject<{
+    agentName: z.ZodOptional<z.ZodString>;
+    agentVersion: z.ZodOptional<z.ZodString>;
+    mcpClientInfo: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    agentName?: string | undefined;
+    agentVersion?: string | undefined;
+    mcpClientInfo?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
+}, {
+    agentName?: string | undefined;
+    agentVersion?: string | undefined;
+    mcpClientInfo?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
+}>;
+export declare const sessionEndedPayloadSchema: z.ZodObject<{
+    reason: z.ZodEnum<["completed", "error", "timeout", "manual"]>;
+    summary: z.ZodOptional<z.ZodString>;
+    totalToolCalls: z.ZodOptional<z.ZodNumber>;
+    totalDurationMs: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    reason: "timeout" | "completed" | "error" | "manual";
+    summary?: string | undefined;
+    totalToolCalls?: number | undefined;
+    totalDurationMs?: number | undefined;
+}, {
+    reason: "timeout" | "completed" | "error" | "manual";
+    summary?: string | undefined;
+    totalToolCalls?: number | undefined;
+    totalDurationMs?: number | undefined;
+}>;
+export declare const approvalRequestedPayloadSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    action: z.ZodString;
+    params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    urgency: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    params: Record<string, unknown>;
+    requestId: string;
+    action: string;
+    urgency: string;
+}, {
+    params: Record<string, unknown>;
+    requestId: string;
+    action: string;
+    urgency: string;
+}>;
+export declare const approvalDecisionPayloadSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    action: z.ZodString;
+    decidedBy: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    requestId: string;
+    action: string;
+    decidedBy: string;
+    reason?: string | undefined;
+}, {
+    requestId: string;
+    action: string;
+    decidedBy: string;
+    reason?: string | undefined;
+}>;
+export declare const formSubmittedPayloadSchema: z.ZodObject<{
+    submissionId: z.ZodString;
+    formId: z.ZodString;
+    formName: z.ZodOptional<z.ZodString>;
+    fieldCount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    submissionId: string;
+    formId: string;
+    fieldCount: number;
+    formName?: string | undefined;
+}, {
+    submissionId: string;
+    formId: string;
+    fieldCount: number;
+    formName?: string | undefined;
+}>;
+export declare const formCompletedPayloadSchema: z.ZodObject<{
+    submissionId: z.ZodString;
+    formId: z.ZodString;
+    completedBy: z.ZodString;
+    durationMs: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    durationMs: number;
+    submissionId: string;
+    formId: string;
+    completedBy: string;
+}, {
+    durationMs: number;
+    submissionId: string;
+    formId: string;
+    completedBy: string;
+}>;
+export declare const formExpiredPayloadSchema: z.ZodObject<{
+    submissionId: z.ZodString;
+    formId: z.ZodString;
+    expiredAfterMs: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    submissionId: string;
+    formId: string;
+    expiredAfterMs: number;
+}, {
+    submissionId: string;
+    formId: string;
+    expiredAfterMs: number;
+}>;
+export declare const costTrackedPayloadSchema: z.ZodObject<{
+    provider: z.ZodString;
+    model: z.ZodString;
+    inputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+    totalTokens: z.ZodNumber;
+    costUsd: z.ZodNumber;
+    trigger: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    provider: string;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    costUsd: number;
+    trigger?: string | undefined;
+}, {
+    provider: string;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    costUsd: number;
+    trigger?: string | undefined;
+}>;
+export declare const alertTriggeredPayloadSchema: z.ZodObject<{
+    alertRuleId: z.ZodString;
+    alertName: z.ZodString;
+    condition: z.ZodString;
+    currentValue: z.ZodNumber;
+    threshold: z.ZodNumber;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    alertRuleId: string;
+    alertName: string;
+    condition: string;
+    currentValue: number;
+    threshold: number;
+}, {
+    message: string;
+    alertRuleId: string;
+    alertName: string;
+    condition: string;
+    currentValue: number;
+    threshold: number;
+}>;
+export declare const alertResolvedPayloadSchema: z.ZodObject<{
+    alertRuleId: z.ZodString;
+    alertName: z.ZodString;
+    resolvedBy: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    alertRuleId: string;
+    alertName: string;
+    resolvedBy?: string | undefined;
+}, {
+    alertRuleId: string;
+    alertName: string;
+    resolvedBy?: string | undefined;
+}>;
+export declare const customPayloadSchema: z.ZodObject<{
+    type: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    data: Record<string, unknown>;
+}, {
+    type: string;
+    data: Record<string, unknown>;
+}>;
+/**
+ * Map of event type to payload schema for type-specific validation.
+ */
+export declare const payloadSchemasByEventType: Record<string, z.ZodTypeAny>;
+/**
+ * Schema for validating inbound event ingestion.
+ *
+ * Uses superRefine to validate the payload against the correct
+ * type-specific schema based on eventType.
+ */
+export declare const ingestEventSchema: z.ZodEffects<z.ZodObject<{
+    sessionId: z.ZodString;
+    agentId: z.ZodString;
+    eventType: z.ZodEnum<["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"]>;
+    severity: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error", "critical"]>>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** Optional client-side timestamp; server will validate and may override */
+    timestamp: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    agentId: string;
+    eventType: "tool_call" | "session_started" | "session_ended" | "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";
+    severity: "error" | "debug" | "info" | "warn" | "critical";
+    payload: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+    timestamp?: string | undefined;
+}, {
+    sessionId: string;
+    agentId: string;
+    eventType: "tool_call" | "session_started" | "session_ended" | "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";
+    payload: Record<string, unknown>;
+    timestamp?: string | undefined;
+    severity?: "error" | "debug" | "info" | "warn" | "critical" | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>, {
+    sessionId: string;
+    agentId: string;
+    eventType: "tool_call" | "session_started" | "session_ended" | "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";
+    severity: "error" | "debug" | "info" | "warn" | "critical";
+    payload: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+    timestamp?: string | undefined;
+}, {
+    sessionId: string;
+    agentId: string;
+    eventType: "tool_call" | "session_started" | "session_ended" | "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";
+    payload: Record<string, unknown>;
+    timestamp?: string | undefined;
+    severity?: "error" | "debug" | "info" | "warn" | "critical" | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+/**
+ * Type inferred from the ingest event schema
+ */
+export type IngestEventInput = z.infer<typeof ingestEventSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,eAAe,iSAiB1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,2DAAyD,CAAC;AAIrF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;EAKpC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAMjC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;EAKtC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;EAKpC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;EAKzC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;EAKxC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;EAKrC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;EAKrC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;EAQnC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;EAOtC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAIrC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;EAG9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAiBlE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;IAQ1B,4EAA4E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgB5E,CAAC;AAEL;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}