@agenticc/core 1.0.0

package/dist/audit/logger.js

@@ -0,0 +1,268 @@
+/**
+ * Audit Logger
+ *
+ * Records tool executions, configuration changes, and errors
+ * for audit and troubleshooting purposes.
+ *
+ * _Requirements: 10.1, 10.2, 10.3_
+ */
+import { v4 as uuidv4 } from 'uuid';
+/**
+ * Audit Logger
+ *
+ * In-memory audit logger that records all operations performed by the Agent.
+ * Provides methods for logging tool executions, config changes, and errors.
+ */
+export class AuditLogger {
+    logs = new Map();
+    // Indexes for faster lookups
+    logsBySession = new Map();
+    logsByType = new Map();
+    /**
+     * Log a tool execution
+     *
+     * @param input - Tool execution details
+     * @returns The created log entry
+     */
+    logToolExecution(input) {
+        const log = {
+            id: uuidv4(),
+            sessionId: input.sessionId,
+            operationType: 'tool_execution',
+            target: input.toolName,
+            params: input.args,
+            result: {
+                success: input.result.success,
+                content: input.result.content,
+                data: input.result.data,
+            },
+            status: input.result.success ? 'success' : 'failure',
+            errorMessage: input.result.error?.message,
+            createdAt: new Date(),
+            durationMs: input.durationMs,
+        };
+        if (input.result.error) {
+            log.metadata = { errorCode: input.result.error.code };
+        }
+        this.addLog(log);
+        return log;
+    }
+    /**
+     * Log a configuration change
+     *
+     * @param input - Config change details
+     * @returns The created log entry
+     */
+    logConfigChange(input) {
+        const log = {
+            id: uuidv4(),
+            sessionId: input.sessionId,
+            operationType: 'config_change',
+            target: input.configKey,
+            params: {
+                before: input.beforeValue,
+                after: input.afterValue,
+            },
+            result: {
+                before: input.beforeValue,
+                after: input.afterValue,
+            },
+            status: 'success',
+            createdAt: new Date(),
+            metadata: input.metadata,
+        };
+        this.addLog(log);
+        return log;
+    }
+    /**
+     * Log an error
+     *
+     * @param input - Error details
+     * @returns The created log entry
+     */
+    logError(input) {
+        const log = {
+            id: uuidv4(),
+            sessionId: input.sessionId,
+            operationType: 'error',
+            target: input.context,
+            status: 'failure',
+            errorMessage: input.message,
+            errorStack: input.stack,
+            createdAt: new Date(),
+            metadata: input.details,
+        };
+        this.addLog(log);
+        return log;
+    }
+    /**
+     * Log a knowledge addition
+     *
+     * @param sessionId - Session ID
+     * @param documentId - Document ID
+     * @param category - Document category
+     * @param title - Document title
+     * @returns The created log entry
+     */
+    logKnowledgeAdd(sessionId, documentId, category, title) {
+        const log = {
+            id: uuidv4(),
+            sessionId,
+            operationType: 'knowledge_add',
+            target: documentId,
+            params: { category, title },
+            status: 'success',
+            createdAt: new Date(),
+        };
+        this.addLog(log);
+        return log;
+    }
+    /**
+     * Log a knowledge deletion
+     *
+     * @param sessionId - Session ID
+     * @param documentId - Document ID
+     * @param success - Whether deletion was successful
+     * @returns The created log entry
+     */
+    logKnowledgeDelete(sessionId, documentId, success) {
+        const log = {
+            id: uuidv4(),
+            sessionId,
+            operationType: 'knowledge_delete',
+            target: documentId,
+            status: success ? 'success' : 'failure',
+            createdAt: new Date(),
+        };
+        this.addLog(log);
+        return log;
+    }
+    /**
+     * Log a session creation
+     *
+     * @param sessionId - Session ID
+     * @param metadata - Session metadata
+     * @returns The created log entry
+     */
+    logSessionCreate(sessionId, metadata) {
+        const log = {
+            id: uuidv4(),
+            sessionId,
+            operationType: 'session_create',
+            target: sessionId,
+            status: 'success',
+            createdAt: new Date(),
+            metadata,
+        };
+        this.addLog(log);
+        return log;
+    }
+    /**
+     * Log a session close
+     *
+     * @param sessionId - Session ID
+     * @returns The created log entry
+     */
+    logSessionClose(sessionId) {
+        const log = {
+            id: uuidv4(),
+            sessionId,
+            operationType: 'session_close',
+            target: sessionId,
+            status: 'success',
+            createdAt: new Date(),
+        };
+        this.addLog(log);
+        return log;
+    }
+    /**
+     * Get a log entry by ID
+     *
+     * @param logId - Log entry ID
+     * @returns The log entry or undefined
+     */
+    getLog(logId) {
+        return this.logs.get(logId);
+    }
+    /**
+     * Get all logs for a session
+     *
+     * @param sessionId - Session ID
+     * @returns Array of log entries
+     */
+    getLogsBySession(sessionId) {
+        const logIds = this.logsBySession.get(sessionId);
+        if (!logIds) {
+            return [];
+        }
+        return Array.from(logIds)
+            .map((id) => this.logs.get(id))
+            .filter(Boolean)
+            .sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime());
+    }
+    /**
+     * Get all logs of a specific type
+     *
+     * @param operationType - Operation type
+     * @returns Array of log entries
+     */
+    getLogsByType(operationType) {
+        const logIds = this.logsByType.get(operationType);
+        if (!logIds) {
+            return [];
+        }
+        return Array.from(logIds)
+            .map((id) => this.logs.get(id))
+            .filter(Boolean)
+            .sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime());
+    }
+    /**
+     * Get all logs
+     *
+     * @returns Array of all log entries
+     */
+    getAllLogs() {
+        return Array.from(this.logs.values()).sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime());
+    }
+    /**
+     * Get total log count
+     *
+     * @returns Total number of logs
+     */
+    getLogCount() {
+        return this.logs.size;
+    }
+    /**
+     * Clear all logs
+     */
+    clear() {
+        this.logs.clear();
+        this.logsBySession.clear();
+        this.logsByType.clear();
+    }
+    /**
+     * Add a log entry to storage
+     */
+    addLog(log) {
+        this.logs.set(log.id, log);
+        // Update session index
+        if (log.sessionId) {
+            if (!this.logsBySession.has(log.sessionId)) {
+                this.logsBySession.set(log.sessionId, new Set());
+            }
+            this.logsBySession.get(log.sessionId).add(log.id);
+        }
+        // Update type index
+        if (!this.logsByType.has(log.operationType)) {
+            this.logsByType.set(log.operationType, new Set());
+        }
+        this.logsByType.get(log.operationType).add(log.id);
+    }
+}
+/**
+ * Create a new AuditLogger instance
+ */
+export function createAuditLogger() {
+    return new AuditLogger();
+}
+//# sourceMappingURL=logger.js.map

package/dist/audit/logger.js.map

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

package/dist/audit/query.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Audit Log Query
+ *
+ * Provides advanced querying capabilities for audit logs
+ * with support for filtering by session, operation type, and time range.
+ *
+ * _Requirements: 10.4_
+ */
+import type { OperationLog, OperationType, OperationStatus, AuditLogger } from './logger.js';
+/**
+ * Query options for filtering audit logs
+ */
+export interface AuditLogQueryOptions {
+    /** Filter by session ID */
+    sessionId?: string;
+    /** Filter by operation type */
+    operationType?: OperationType;
+    /** Filter by multiple operation types */
+    operationTypes?: OperationType[];
+    /** Filter by status */
+    status?: OperationStatus;
+    /** Filter by target (e.g., tool name) */
+    target?: string;
+    /** Filter by timestamp (after) */
+    after?: Date;
+    /** Filter by timestamp (before) */
+    before?: Date;
+    /** Filter by error presence */
+    hasError?: boolean;
+    /** Maximum number of results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+    /** Sort order */
+    order?: 'asc' | 'desc';
+}
+/**
+ * Aggregated statistics for audit logs
+ */
+export interface AuditLogStats {
+    /** Total number of logs */
+    totalLogs: number;
+    /** Logs by operation type */
+    byOperationType: Record<OperationType, number>;
+    /** Logs by status */
+    byStatus: Record<OperationStatus, number>;
+    /** Number of unique sessions */
+    uniqueSessions: number;
+    /** Average duration for tool executions (ms) */
+    avgToolExecutionDuration?: number;
+    /** Error rate (percentage) */
+    errorRate: number;
+    /** Time range of logs */
+    timeRange?: {
+        earliest: Date;
+        latest: Date;
+    };
+}
+/**
+ * Query result with pagination info
+ */
+export interface AuditLogQueryResult {
+    /** Matching log entries */
+    logs: OperationLog[];
+    /** Total count (before pagination) */
+    totalCount: number;
+    /** Whether there are more results */
+    hasMore: boolean;
+    /** Current offset */
+    offset: number;
+    /** Current limit */
+    limit: number;
+}
+/**
+ * Audit Log Query Service
+ *
+ * Provides advanced querying and aggregation capabilities
+ * for audit logs.
+ */
+export declare class AuditLogQuery {
+    private logger;
+    constructor(logger: AuditLogger);
+    /**
+     * Query logs with advanced filtering
+     *
+     * @param options - Query options
+     * @returns Query result with pagination info
+     */
+    query(options?: AuditLogQueryOptions): AuditLogQueryResult;
+    /**
+     * Get logs for a specific session
+     *
+     * @param sessionId - Session ID
+     * @param options - Additional query options
+     * @returns Query result
+     */
+    queryBySession(sessionId: string, options?: Omit<AuditLogQueryOptions, 'sessionId'>): AuditLogQueryResult;
+    /**
+     * Get logs for a specific operation type
+     *
+     * @param operationType - Operation type
+     * @param options - Additional query options
+     * @returns Query result
+     */
+    queryByOperationType(operationType: OperationType, options?: Omit<AuditLogQueryOptions, 'operationType'>): AuditLogQueryResult;
+    /**
+     * Get logs within a time range
+     *
+     * @param after - Start of time range
+     * @param before - End of time range
+     * @param options - Additional query options
+     * @returns Query result
+     */
+    queryByTimeRange(after: Date, before: Date, options?: Omit<AuditLogQueryOptions, 'after' | 'before'>): AuditLogQueryResult;
+    /**
+     * Get error logs
+     *
+     * @param options - Additional query options
+     * @returns Query result
+     */
+    queryErrors(options?: Omit<AuditLogQueryOptions, 'hasError'>): AuditLogQueryResult;
+    /**
+     * Get tool execution logs
+     *
+     * @param toolName - Optional tool name filter
+     * @param options - Additional query options
+     * @returns Query result
+     */
+    queryToolExecutions(toolName?: string, options?: Omit<AuditLogQueryOptions, 'operationType' | 'target'>): AuditLogQueryResult;
+    /**
+     * Get aggregated statistics
+     *
+     * @param options - Optional filter options
+     * @returns Aggregated statistics
+     */
+    getStats(options?: AuditLogQueryOptions): AuditLogStats;
+    /**
+     * Get recent logs
+     *
+     * @param count - Number of logs to return
+     * @returns Array of recent logs
+     */
+    getRecentLogs(count?: number): OperationLog[];
+    /**
+     * Search logs by target pattern
+     *
+     * @param pattern - Search pattern (supports simple wildcards)
+     * @param options - Additional query options
+     * @returns Query result
+     */
+    searchByTarget(pattern: string, options?: Omit<AuditLogQueryOptions, 'target'>): AuditLogQueryResult;
+    /**
+     * Apply filters to logs
+     */
+    private applyFilters;
+}
+/**
+ * Create a new AuditLogQuery instance
+ *
+ * @param logger - AuditLogger instance to query
+ * @returns AuditLogQuery instance
+ */
+export declare function createAuditLogQuery(logger: AuditLogger): AuditLogQuery;
+//# sourceMappingURL=query.d.ts.map

package/dist/audit/query.d.ts.map

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

package/dist/audit/query.js

@@ -0,0 +1,250 @@
+/**
+ * Audit Log Query
+ *
+ * Provides advanced querying capabilities for audit logs
+ * with support for filtering by session, operation type, and time range.
+ *
+ * _Requirements: 10.4_
+ */
+/**
+ * Audit Log Query Service
+ *
+ * Provides advanced querying and aggregation capabilities
+ * for audit logs.
+ */
+export class AuditLogQuery {
+    logger;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /**
+     * Query logs with advanced filtering
+     *
+     * @param options - Query options
+     * @returns Query result with pagination info
+     */
+    query(options) {
+        let logs = this.logger.getAllLogs();
+        // Apply filters
+        logs = this.applyFilters(logs, options);
+        // Get total count before pagination
+        const totalCount = logs.length;
+        // Apply sorting
+        const order = options?.order ?? 'desc';
+        logs.sort((a, b) => {
+            const diff = a.createdAt.getTime() - b.createdAt.getTime();
+            return order === 'asc' ? diff : -diff;
+        });
+        // Apply pagination
+        const offset = options?.offset ?? 0;
+        const limit = options?.limit ?? 100;
+        logs = logs.slice(offset, offset + limit);
+        return {
+            logs,
+            totalCount,
+            hasMore: offset + logs.length < totalCount,
+            offset,
+            limit,
+        };
+    }
+    /**
+     * Get logs for a specific session
+     *
+     * @param sessionId - Session ID
+     * @param options - Additional query options
+     * @returns Query result
+     */
+    queryBySession(sessionId, options) {
+        return this.query({ ...options, sessionId });
+    }
+    /**
+     * Get logs for a specific operation type
+     *
+     * @param operationType - Operation type
+     * @param options - Additional query options
+     * @returns Query result
+     */
+    queryByOperationType(operationType, options) {
+        return this.query({ ...options, operationType });
+    }
+    /**
+     * Get logs within a time range
+     *
+     * @param after - Start of time range
+     * @param before - End of time range
+     * @param options - Additional query options
+     * @returns Query result
+     */
+    queryByTimeRange(after, before, options) {
+        return this.query({ ...options, after, before });
+    }
+    /**
+     * Get error logs
+     *
+     * @param options - Additional query options
+     * @returns Query result
+     */
+    queryErrors(options) {
+        return this.query({ ...options, hasError: true });
+    }
+    /**
+     * Get tool execution logs
+     *
+     * @param toolName - Optional tool name filter
+     * @param options - Additional query options
+     * @returns Query result
+     */
+    queryToolExecutions(toolName, options) {
+        return this.query({
+            ...options,
+            operationType: 'tool_execution',
+            target: toolName,
+        });
+    }
+    /**
+     * Get aggregated statistics
+     *
+     * @param options - Optional filter options
+     * @returns Aggregated statistics
+     */
+    getStats(options) {
+        let logs = this.logger.getAllLogs();
+        logs = this.applyFilters(logs, options);
+        const byOperationType = {};
+        const byStatus = {};
+        const sessions = new Set();
+        let totalDuration = 0;
+        let durationCount = 0;
+        let errorCount = 0;
+        let earliest;
+        let latest;
+        for (const log of logs) {
+            // Count by operation type
+            byOperationType[log.operationType] = (byOperationType[log.operationType] ?? 0) + 1;
+            // Count by status
+            byStatus[log.status] = (byStatus[log.status] ?? 0) + 1;
+            // Track sessions
+            if (log.sessionId) {
+                sessions.add(log.sessionId);
+            }
+            // Track duration for tool executions
+            if (log.operationType === 'tool_execution' && log.durationMs !== undefined) {
+                totalDuration += log.durationMs;
+                durationCount++;
+            }
+            // Count errors
+            if (log.status === 'failure' || log.errorMessage) {
+                errorCount++;
+            }
+            // Track time range
+            if (!earliest || log.createdAt < earliest) {
+                earliest = log.createdAt;
+            }
+            if (!latest || log.createdAt > latest) {
+                latest = log.createdAt;
+            }
+        }
+        return {
+            totalLogs: logs.length,
+            byOperationType: byOperationType,
+            byStatus: byStatus,
+            uniqueSessions: sessions.size,
+            avgToolExecutionDuration: durationCount > 0 ? totalDuration / durationCount : undefined,
+            errorRate: logs.length > 0 ? (errorCount / logs.length) * 100 : 0,
+            timeRange: earliest && latest ? { earliest, latest } : undefined,
+        };
+    }
+    /**
+     * Get recent logs
+     *
+     * @param count - Number of logs to return
+     * @returns Array of recent logs
+     */
+    getRecentLogs(count = 10) {
+        const result = this.query({ limit: count, order: 'desc' });
+        return result.logs;
+    }
+    /**
+     * Search logs by target pattern
+     *
+     * @param pattern - Search pattern (supports simple wildcards)
+     * @param options - Additional query options
+     * @returns Query result
+     */
+    searchByTarget(pattern, options) {
+        let logs = this.logger.getAllLogs();
+        logs = this.applyFilters(logs, options);
+        // Convert pattern to regex (simple wildcard support)
+        const regexPattern = pattern
+            .replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+            .replace(/\\\*/g, '.*')
+            .replace(/\\\?/g, '.');
+        const regex = new RegExp(regexPattern, 'i');
+        logs = logs.filter((log) => log.target && regex.test(log.target));
+        const totalCount = logs.length;
+        const offset = options?.offset ?? 0;
+        const limit = options?.limit ?? 100;
+        const order = options?.order ?? 'desc';
+        logs.sort((a, b) => {
+            const diff = a.createdAt.getTime() - b.createdAt.getTime();
+            return order === 'asc' ? diff : -diff;
+        });
+        logs = logs.slice(offset, offset + limit);
+        return {
+            logs,
+            totalCount,
+            hasMore: offset + logs.length < totalCount,
+            offset,
+            limit,
+        };
+    }
+    /**
+     * Apply filters to logs
+     */
+    applyFilters(logs, options) {
+        if (!options) {
+            return logs;
+        }
+        if (options.sessionId) {
+            logs = logs.filter((log) => log.sessionId === options.sessionId);
+        }
+        if (options.operationType) {
+            logs = logs.filter((log) => log.operationType === options.operationType);
+        }
+        if (options.operationTypes && options.operationTypes.length > 0) {
+            const types = new Set(options.operationTypes);
+            logs = logs.filter((log) => types.has(log.operationType));
+        }
+        if (options.status) {
+            logs = logs.filter((log) => log.status === options.status);
+        }
+        if (options.target) {
+            logs = logs.filter((log) => log.target === options.target);
+        }
+        if (options.after) {
+            logs = logs.filter((log) => log.createdAt >= options.after);
+        }
+        if (options.before) {
+            logs = logs.filter((log) => log.createdAt <= options.before);
+        }
+        if (options.hasError !== undefined) {
+            if (options.hasError) {
+                logs = logs.filter((log) => log.status === 'failure' || log.errorMessage);
+            }
+            else {
+                logs = logs.filter((log) => log.status !== 'failure' && !log.errorMessage);
+            }
+        }
+        return logs;
+    }
+}
+/**
+ * Create a new AuditLogQuery instance
+ *
+ * @param logger - AuditLogger instance to query
+ * @returns AuditLogQuery instance
+ */
+export function createAuditLogQuery(logger) {
+    return new AuditLogQuery(logger);
+}
+//# sourceMappingURL=query.js.map