family-ai-agent 1.0.0

package/dist/memory/knowledge-base/index.js

@@ -0,0 +1,222 @@
+import { RecursiveCharacterTextSplitter } from '@langchain/textsplitters';
+import { query, transaction } from '../../database/client.js';
+import { getOpenRouterClient } from '../../llm/openrouter-client.js';
+import { createLogger, logMemoryOperation } from '../../utils/logger.js';
+import { MemoryError } from '../../utils/errors.js';
+const logger = createLogger('KnowledgeBase');
+export class KnowledgeBase {
+    client = getOpenRouterClient();
+    textSplitter = new RecursiveCharacterTextSplitter({
+        chunkSize: 1000,
+        chunkOverlap: 200,
+        separators: ['\n\n', '\n', '. ', ' ', ''],
+    });
+    // Add a document to the knowledge base
+    async addDocument(content, filename, options = {}) {
+        try {
+            // Split content into chunks
+            const chunks = await this.textSplitter.splitText(content);
+            logger.debug('Document split into chunks', {
+                filename,
+                chunkCount: chunks.length,
+            });
+            // Generate embeddings for all chunks
+            const embeddings = await this.client.embed(chunks);
+            // Store document and chunks in transaction
+            const documentId = await transaction(async (client) => {
+                // Insert document
+                const docResult = await client.query(`INSERT INTO documents (user_id, filename, file_type, file_size, content, metadata)
+           VALUES ($1, $2, $3, $4, $5, $6)
+           RETURNING id`, [
+                    options.userId ?? null,
+                    filename,
+                    options.fileType ?? null,
+                    options.fileSize ?? null,
+                    content,
+                    JSON.stringify(options.metadata ?? {}),
+                ]);
+                const docId = docResult.rows[0]?.id;
+                if (!docId) {
+                    throw new MemoryError('Failed to insert document');
+                }
+                // Insert chunks with embeddings
+                for (let i = 0; i < chunks.length; i++) {
+                    const chunk = chunks[i];
+                    const embedding = embeddings[i];
+                    await client.query(`INSERT INTO document_chunks (document_id, chunk_index, content, embedding, metadata)
+             VALUES ($1, $2, $3, $4, $5)`, [
+                        docId,
+                        i,
+                        chunk,
+                        `[${embedding.join(',')}]`,
+                        JSON.stringify({ chunkIndex: i, totalChunks: chunks.length }),
+                    ]);
+                }
+                return docId;
+            });
+            logMemoryOperation('write', 'knowledge_base', {
+                documentId,
+                filename,
+                chunkCount: chunks.length,
+            });
+            return documentId;
+        }
+        catch (error) {
+            logger.error('Failed to add document', { error, filename });
+            throw new MemoryError(`Failed to add document: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // Search the knowledge base
+    async search(queryText, options = {}) {
+        const { userId, limit = 5, minSimilarity = 0.7 } = options;
+        try {
+            // Generate query embedding
+            const queryEmbedding = await this.client.embedQuery(queryText);
+            // Build query
+            let sql = `
+        SELECT
+          dc.id as chunk_id,
+          dc.document_id,
+          dc.content,
+          dc.metadata as chunk_metadata,
+          d.filename,
+          d.metadata as doc_metadata,
+          1 - (dc.embedding <=> $1::vector) as similarity
+        FROM document_chunks dc
+        JOIN documents d ON d.id = dc.document_id
+        WHERE 1 - (dc.embedding <=> $1::vector) >= $2
+      `;
+            const params = [`[${queryEmbedding.join(',')}]`, minSimilarity];
+            let paramIndex = 3;
+            if (userId) {
+                sql += ` AND d.user_id = $${paramIndex}`;
+                params.push(userId);
+                paramIndex++;
+            }
+            sql += ` ORDER BY similarity DESC LIMIT $${paramIndex}`;
+            params.push(limit);
+            const result = await query(sql, params);
+            const searchResults = result.rows.map((row) => ({
+                chunkId: row.chunk_id,
+                documentId: row.document_id,
+                content: row.content,
+                similarity: row.similarity,
+                metadata: { ...row.doc_metadata, ...row.chunk_metadata },
+                filename: row.filename,
+            }));
+            logMemoryOperation('search', 'knowledge_base', {
+                queryLength: queryText.length,
+                resultsCount: searchResults.length,
+            });
+            return searchResults;
+        }
+        catch (error) {
+            logger.error('Failed to search knowledge base', { error });
+            throw new MemoryError(`Failed to search knowledge base: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // Get document by ID
+    async getDocument(id) {
+        try {
+            const result = await query(`SELECT id, user_id, filename, file_type, file_size, content, metadata, created_at
+         FROM documents WHERE id = $1`, [id]);
+            if (result.rows.length === 0) {
+                return null;
+            }
+            const row = result.rows[0];
+            return {
+                id: row.id,
+                userId: row.user_id ?? undefined,
+                filename: row.filename,
+                fileType: row.file_type ?? undefined,
+                fileSize: row.file_size ?? undefined,
+                content: row.content ?? undefined,
+                metadata: row.metadata,
+                createdAt: row.created_at,
+            };
+        }
+        catch (error) {
+            logger.error('Failed to get document', { error, id });
+            throw new MemoryError(`Failed to get document: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // List documents for a user
+    async listDocuments(userId, options = {}) {
+        const { limit = 20, offset = 0 } = options;
+        try {
+            const result = await query(`SELECT id, user_id, filename, file_type, file_size, metadata, created_at
+         FROM documents
+         WHERE user_id = $1
+         ORDER BY created_at DESC
+         LIMIT $2 OFFSET $3`, [userId, limit, offset]);
+            return result.rows.map((row) => ({
+                id: row.id,
+                userId: row.user_id ?? undefined,
+                filename: row.filename,
+                fileType: row.file_type ?? undefined,
+                fileSize: row.file_size ?? undefined,
+                metadata: row.metadata,
+                createdAt: row.created_at,
+            }));
+        }
+        catch (error) {
+            logger.error('Failed to list documents', { error });
+            throw new MemoryError(`Failed to list documents: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // Delete document and its chunks
+    async deleteDocument(id) {
+        try {
+            await query('DELETE FROM documents WHERE id = $1', [id]);
+            logMemoryOperation('write', 'knowledge_base', {
+                documentId: id,
+                action: 'delete',
+            });
+        }
+        catch (error) {
+            logger.error('Failed to delete document', { error, id });
+            throw new MemoryError(`Failed to delete document: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // Get chunks for a document
+    async getDocumentChunks(documentId) {
+        try {
+            const result = await query(`SELECT id, document_id, chunk_index, content, metadata
+         FROM document_chunks
+         WHERE document_id = $1
+         ORDER BY chunk_index ASC`, [documentId]);
+            return result.rows.map((row) => ({
+                id: row.id,
+                documentId: row.document_id,
+                chunkIndex: row.chunk_index,
+                content: row.content,
+                metadata: row.metadata,
+            }));
+        }
+        catch (error) {
+            logger.error('Failed to get document chunks', { error, documentId });
+            throw new MemoryError(`Failed to get document chunks: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // Get document count for user
+    async getDocumentCount(userId) {
+        try {
+            const result = await query('SELECT COUNT(*) as count FROM documents WHERE user_id = $1', [userId]);
+            return parseInt(result.rows[0]?.count ?? '0', 10);
+        }
+        catch (error) {
+            logger.error('Failed to get document count', { error });
+            throw new MemoryError(`Failed to get document count: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}
+// Singleton instance
+let kbInstance = null;
+export function getKnowledgeBase() {
+    if (!kbInstance) {
+        kbInstance = new KnowledgeBase();
+    }
+    return kbInstance;
+}
+export default KnowledgeBase;
+//# sourceMappingURL=index.js.map

package/dist/memory/knowledge-base/index.js.map

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

package/dist/memory/longterm/vector-store.d.ts

@@ -0,0 +1,44 @@
+import type { RetrievedMemory } from '../../core/agents/types.js';
+export type MemoryType = 'semantic' | 'episodic' | 'procedural';
+export interface MemoryEntry {
+    id: string;
+    userId?: string;
+    memoryType: MemoryType;
+    content: string;
+    importance: number;
+    metadata?: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface SearchOptions {
+    userId?: string;
+    memoryType?: MemoryType;
+    limit?: number;
+    minSimilarity?: number;
+}
+export declare class VectorStore {
+    private client;
+    store(content: string, memoryType: MemoryType, options?: {
+        userId?: string;
+        importance?: number;
+        metadata?: Record<string, unknown>;
+    }): Promise<string>;
+    search(queryText: string, options?: SearchOptions): Promise<RetrievedMemory[]>;
+    get(id: string): Promise<MemoryEntry | null>;
+    update(id: string, content: string, options?: {
+        importance?: number;
+        metadata?: Record<string, unknown>;
+    }): Promise<void>;
+    delete(id: string): Promise<void>;
+    bulkStore(entries: Array<{
+        content: string;
+        memoryType: MemoryType;
+        userId?: string;
+        importance?: number;
+        metadata?: Record<string, unknown>;
+    }>): Promise<string[]>;
+    getRecent(userId: string, limit?: number): Promise<MemoryEntry[]>;
+}
+export declare function getVectorStore(): VectorStore;
+export default VectorStore;
+//# sourceMappingURL=vector-store.d.ts.map

package/dist/memory/longterm/vector-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store.d.ts","sourceRoot":"","sources":["../../../src/memory/longterm/vector-store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAIlE,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAyB;IAGjC,KAAK,CACT,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,GACL,OAAO,CAAC,MAAM,CAAC;IA0CZ,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,eAAe,EAAE,CAAC;IAmFvB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAyC5C,MAAM,CACV,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAO,GACxE,OAAO,CAAC,IAAI,CAAC;IA6BV,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAajC,SAAS,CACb,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,UAAU,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC,GACD,OAAO,CAAC,MAAM,EAAE,CAAC;IAmDd,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAqC5E;AAKD,wBAAgB,cAAc,IAAI,WAAW,CAK5C;AAED,eAAe,WAAW,CAAC"}

package/dist/memory/longterm/vector-store.js

@@ -0,0 +1,229 @@
+import { query, transaction } from '../../database/client.js';
+import { getOpenRouterClient } from '../../llm/openrouter-client.js';
+import { createLogger, logMemoryOperation } from '../../utils/logger.js';
+import { MemoryError } from '../../utils/errors.js';
+const logger = createLogger('VectorStore');
+export class VectorStore {
+    client = getOpenRouterClient();
+    // Store a memory with embedding
+    async store(content, memoryType, options = {}) {
+        try {
+            // Generate embedding
+            const embedding = await this.client.embedQuery(content);
+            // Insert into database
+            const result = await query(`INSERT INTO long_term_memories
+         (user_id, memory_type, content, embedding, importance, metadata)
+         VALUES ($1, $2, $3, $4, $5, $6)
+         RETURNING id`, [
+                options.userId ?? null,
+                memoryType,
+                content,
+                `[${embedding.join(',')}]`,
+                options.importance ?? 0.5,
+                JSON.stringify(options.metadata ?? {}),
+            ]);
+            const memoryId = result.rows[0]?.id;
+            if (!memoryId) {
+                throw new MemoryError('Failed to store memory');
+            }
+            logMemoryOperation('write', 'long_term', {
+                memoryId,
+                memoryType,
+                contentLength: content.length,
+            });
+            return memoryId;
+        }
+        catch (error) {
+            logger.error('Failed to store memory', { error });
+            throw new MemoryError(`Failed to store memory: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // Search for similar memories
+    async search(queryText, options = {}) {
+        const { userId, memoryType, limit = 5, minSimilarity = 0.7, } = options;
+        try {
+            // Generate query embedding
+            const queryEmbedding = await this.client.embedQuery(queryText);
+            // Build the query with filters
+            let sql = `
+        SELECT
+          id,
+          memory_type,
+          content,
+          metadata,
+          1 - (embedding <=> $1::vector) as similarity
+        FROM long_term_memories
+        WHERE 1 - (embedding <=> $1::vector) >= $2
+      `;
+            const params = [`[${queryEmbedding.join(',')}]`, minSimilarity];
+            let paramIndex = 3;
+            if (userId) {
+                sql += ` AND user_id = $${paramIndex}`;
+                params.push(userId);
+                paramIndex++;
+            }
+            if (memoryType) {
+                sql += ` AND memory_type = $${paramIndex}`;
+                params.push(memoryType);
+                paramIndex++;
+            }
+            sql += ` ORDER BY similarity DESC LIMIT $${paramIndex}`;
+            params.push(limit);
+            const result = await query(sql, params);
+            // Update access count for retrieved memories
+            if (result.rows.length > 0) {
+                const ids = result.rows.map((r) => r.id);
+                await query(`UPDATE long_term_memories
+           SET access_count = access_count + 1, last_accessed = NOW()
+           WHERE id = ANY($1)`, [ids]);
+            }
+            const memories = result.rows.map((row) => ({
+                id: row.id,
+                type: row.memory_type,
+                content: row.content,
+                relevanceScore: row.similarity,
+                metadata: row.metadata,
+            }));
+            logMemoryOperation('search', 'long_term', {
+                queryLength: queryText.length,
+                resultsCount: memories.length,
+            });
+            return memories;
+        }
+        catch (error) {
+            logger.error('Failed to search memories', { error });
+            throw new MemoryError(`Failed to search memories: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // Get memory by ID
+    async get(id) {
+        try {
+            const result = await query(`SELECT id, user_id, memory_type, content, importance, metadata, created_at, updated_at
+         FROM long_term_memories WHERE id = $1`, [id]);
+            if (result.rows.length === 0) {
+                return null;
+            }
+            const row = result.rows[0];
+            return {
+                id: row.id,
+                userId: row.user_id ?? undefined,
+                memoryType: row.memory_type,
+                content: row.content,
+                importance: row.importance,
+                metadata: row.metadata,
+                createdAt: row.created_at,
+                updatedAt: row.updated_at,
+            };
+        }
+        catch (error) {
+            logger.error('Failed to get memory', { error, id });
+            throw new MemoryError(`Failed to get memory: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // Update memory content
+    async update(id, content, options = {}) {
+        try {
+            // Re-generate embedding for new content
+            const embedding = await this.client.embedQuery(content);
+            await query(`UPDATE long_term_memories
+         SET content = $2, embedding = $3, importance = COALESCE($4, importance),
+             metadata = COALESCE($5, metadata), updated_at = NOW()
+         WHERE id = $1`, [
+                id,
+                content,
+                `[${embedding.join(',')}]`,
+                options.importance ?? null,
+                options.metadata ? JSON.stringify(options.metadata) : null,
+            ]);
+            logMemoryOperation('write', 'long_term', { memoryId: id, action: 'update' });
+        }
+        catch (error) {
+            logger.error('Failed to update memory', { error, id });
+            throw new MemoryError(`Failed to update memory: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // Delete memory
+    async delete(id) {
+        try {
+            await query('DELETE FROM long_term_memories WHERE id = $1', [id]);
+            logMemoryOperation('write', 'long_term', { memoryId: id, action: 'delete' });
+        }
+        catch (error) {
+            logger.error('Failed to delete memory', { error, id });
+            throw new MemoryError(`Failed to delete memory: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // Bulk store memories
+    async bulkStore(entries) {
+        try {
+            // Generate embeddings for all entries
+            const embeddings = await this.client.embed(entries.map((e) => e.content));
+            // Use transaction for bulk insert
+            const ids = await transaction(async (client) => {
+                const results = [];
+                for (let i = 0; i < entries.length; i++) {
+                    const entry = entries[i];
+                    const embedding = embeddings[i];
+                    const result = await client.query(`INSERT INTO long_term_memories
+             (user_id, memory_type, content, embedding, importance, metadata)
+             VALUES ($1, $2, $3, $4, $5, $6)
+             RETURNING id`, [
+                        entry.userId ?? null,
+                        entry.memoryType,
+                        entry.content,
+                        `[${embedding.join(',')}]`,
+                        entry.importance ?? 0.5,
+                        JSON.stringify(entry.metadata ?? {}),
+                    ]);
+                    if (result.rows[0]) {
+                        results.push(result.rows[0].id);
+                    }
+                }
+                return results;
+            });
+            logMemoryOperation('write', 'long_term', {
+                action: 'bulk_store',
+                count: ids.length,
+            });
+            return ids;
+        }
+        catch (error) {
+            logger.error('Failed to bulk store memories', { error });
+            throw new MemoryError(`Failed to bulk store memories: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // Get recent memories for a user
+    async getRecent(userId, limit = 10) {
+        try {
+            const result = await query(`SELECT id, user_id, memory_type, content, importance, metadata, created_at, updated_at
+         FROM long_term_memories
+         WHERE user_id = $1
+         ORDER BY created_at DESC
+         LIMIT $2`, [userId, limit]);
+            return result.rows.map((row) => ({
+                id: row.id,
+                userId: row.user_id ?? undefined,
+                memoryType: row.memory_type,
+                content: row.content,
+                importance: row.importance,
+                metadata: row.metadata,
+                createdAt: row.created_at,
+                updatedAt: row.updated_at,
+            }));
+        }
+        catch (error) {
+            logger.error('Failed to get recent memories', { error });
+            throw new MemoryError(`Failed to get recent memories: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}
+// Singleton instance
+let storeInstance = null;
+export function getVectorStore() {
+    if (!storeInstance) {
+        storeInstance = new VectorStore();
+    }
+    return storeInstance;
+}
+export default VectorStore;
+//# sourceMappingURL=vector-store.js.map

package/dist/memory/longterm/vector-store.js.map

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

package/dist/safety/audit-logger.d.ts

@@ -0,0 +1,68 @@
+export interface AuditLogEntry {
+    id: string;
+    userId?: string;
+    agentId?: string;
+    actionType: string;
+    actionDetails: Record<string, unknown>;
+    inputHash?: string;
+    outputHash?: string;
+    status: 'success' | 'failure' | 'blocked';
+    errorMessage?: string;
+    executionTimeMs?: number;
+    createdAt: Date;
+}
+export type AuditActionType = 'user_input' | 'agent_execution' | 'tool_call' | 'memory_access' | 'document_upload' | 'safety_block' | 'error' | 'handoff' | 'api_request';
+export declare class AuditLogger {
+    private enabled;
+    constructor();
+    private hashContent;
+    log(actionType: AuditActionType, details: Record<string, unknown>, options?: {
+        userId?: string;
+        agentId?: string;
+        input?: string;
+        output?: string;
+        status?: 'success' | 'failure' | 'blocked';
+        error?: string;
+        executionTimeMs?: number;
+    }): Promise<string | null>;
+    logUserInput(input: string, options?: {
+        userId?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<string | null>;
+    logAgentExecution(agentId: string, input: string, output: string, executionTimeMs: number, options?: {
+        userId?: string;
+        success?: boolean;
+        error?: string;
+    }): Promise<string | null>;
+    logToolCall(toolName: string, input: unknown, output: unknown, options?: {
+        agentId?: string;
+        userId?: string;
+        success?: boolean;
+        error?: string;
+        executionTimeMs?: number;
+    }): Promise<string | null>;
+    logSafetyBlock(reason: string, details: Record<string, unknown>, options?: {
+        userId?: string;
+        input?: string;
+    }): Promise<string | null>;
+    query(filters?: {
+        userId?: string;
+        agentId?: string;
+        actionType?: AuditActionType;
+        status?: 'success' | 'failure' | 'blocked';
+        startDate?: Date;
+        endDate?: Date;
+    }, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<AuditLogEntry[]>;
+    getStats(userId?: string, days?: number): Promise<{
+        totalRequests: number;
+        successRate: number;
+        avgExecutionTime: number;
+        blockedCount: number;
+    }>;
+}
+export declare function getAuditLogger(): AuditLogger;
+export default AuditLogger;
+//# sourceMappingURL=audit-logger.d.ts.map

package/dist/safety/audit-logger.d.ts.map

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