vaspera 2.5.0

package/dist/transcripts/logger.test.js

@@ -0,0 +1,227 @@
+/**
+ * Tests for Transcript Logger
+ */
+import { describe, it, expect, beforeEach } from "vitest";
+import { TranscriptLogger, createLogger, getLogger, removeLogger, getActiveSessions, } from "./logger.js";
+describe("TranscriptLogger", () => {
+    let logger;
+    beforeEach(() => {
+        logger = new TranscriptLogger("test-session");
+    });
+    describe("constructor", () => {
+        it("creates logger with provided session ID", () => {
+            expect(logger.getSessionId()).toBe("test-session");
+        });
+        it("creates logger with generated session ID if not provided", () => {
+            const autoLogger = new TranscriptLogger();
+            expect(autoLogger.getSessionId()).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/);
+        });
+    });
+    describe("append", () => {
+        it("appends entry to chain", () => {
+            logger.append({
+                type: "prompt",
+                sessionId: "test-session",
+                content: "Hello, world!",
+            });
+            expect(logger.getEntryCount()).toBe(1);
+        });
+        it("generates sequential IDs", () => {
+            logger.logPrompt("First");
+            logger.logPrompt("Second");
+            logger.logPrompt("Third");
+            const entries = logger.getChain();
+            expect(entries[0].id).toBe("test-session-00001");
+            expect(entries[1].id).toBe("test-session-00002");
+            expect(entries[2].id).toBe("test-session-00003");
+        });
+        it("links entries with previous hash", () => {
+            logger.logPrompt("First");
+            logger.logPrompt("Second");
+            const entries = logger.getChain();
+            expect(entries[0].previousHash).toBe("genesis");
+            expect(entries[1].previousHash).toBe(entries[0].entryHash);
+        });
+    });
+    describe("log methods", () => {
+        it("logPrompt creates prompt entry", () => {
+            const entry = logger.logPrompt("User prompt", "claude-3", { key: "value" });
+            expect(entry.type).toBe("prompt");
+            expect(entry.content).toBe("User prompt");
+            expect(entry.modelId).toBe("claude-3");
+            expect(entry.metadata).toEqual({ key: "value" });
+        });
+        it("logToolCall creates tool_call entry", () => {
+            const entry = logger.logToolCall("search", '{"query": "test"}');
+            expect(entry.type).toBe("tool_call");
+            expect(entry.toolName).toBe("search");
+            expect(entry.content).toBe('{"query": "test"}');
+        });
+        it("logToolResult creates tool_result entry", () => {
+            const entry = logger.logToolResult("search", "Results found");
+            expect(entry.type).toBe("tool_result");
+            expect(entry.toolName).toBe("search");
+        });
+        it("logModelResponse creates model_response entry", () => {
+            const entry = logger.logModelResponse("AI response", "claude-3");
+            expect(entry.type).toBe("model_response");
+            expect(entry.modelId).toBe("claude-3");
+        });
+        it("logSystem creates system entry", () => {
+            const entry = logger.logSystem("System event");
+            expect(entry.type).toBe("system");
+        });
+        it("logError creates error entry", () => {
+            const entry = logger.logError("Something went wrong");
+            expect(entry.type).toBe("error");
+        });
+        it("logRedaction creates redaction entry and sets hasRedactions", () => {
+            const entry = logger.logRedaction("abc123hash", "email");
+            expect(entry.type).toBe("redaction");
+            expect(entry.metadata?.redactionType).toBe("email");
+            const transcript = logger.generateSignedTranscript();
+            expect(transcript.hasRedactions).toBe(true);
+        });
+    });
+    describe("verify", () => {
+        it("returns valid for empty transcript", () => {
+            const result = logger.verify();
+            expect(result.valid).toBe(true);
+            expect(result.entriesVerified).toBe(0);
+        });
+        it("returns valid for correctly linked chain", () => {
+            logger.logPrompt("First");
+            logger.logToolCall("tool", "input");
+            logger.logToolResult("tool", "output");
+            logger.logModelResponse("Response");
+            const result = logger.verify();
+            expect(result.valid).toBe(true);
+            expect(result.entriesVerified).toBe(4);
+        });
+        it("detects tampering in entry hash", () => {
+            logger.logPrompt("Original content");
+            // Tamper with the entry hash
+            const entries = logger.getChain();
+            entries[0].entryHash = "tampered-hash-value";
+            const result = logger.verify();
+            expect(result.valid).toBe(false);
+            expect(result.brokenAt).toBe(0);
+            expect(result.issue).toContain("hash mismatch");
+        });
+        it("detects tampering in content hash", () => {
+            logger.logPrompt("Original content");
+            // Tamper with the content hash
+            const entries = logger.getChain();
+            entries[0].contentHash = "tampered-content-hash";
+            const result = logger.verify();
+            expect(result.valid).toBe(false);
+            expect(result.brokenAt).toBe(0);
+        });
+    });
+    describe("generateSignedTranscript", () => {
+        it("generates correct entry summary", () => {
+            logger.logPrompt("P1");
+            logger.logPrompt("P2");
+            logger.logToolCall("t", "i");
+            logger.logToolResult("t", "o");
+            logger.logModelResponse("R");
+            const transcript = logger.generateSignedTranscript();
+            expect(transcript.entrySummary.prompt).toBe(2);
+            expect(transcript.entrySummary.tool_call).toBe(1);
+            expect(transcript.entrySummary.tool_result).toBe(1);
+            expect(transcript.entrySummary.model_response).toBe(1);
+            expect(transcript.entryCount).toBe(5);
+        });
+        it("includes correct hashes", () => {
+            logger.logPrompt("First");
+            logger.logPrompt("Last");
+            const transcript = logger.generateSignedTranscript();
+            const entries = logger.getChain();
+            expect(transcript.rootHash).toBe(entries[0].entryHash);
+            expect(transcript.tipHash).toBe(entries[1].entryHash);
+        });
+        it("sets hasRedactions correctly", () => {
+            logger.logPrompt("Normal content");
+            let transcript = logger.generateSignedTranscript();
+            expect(transcript.hasRedactions).toBe(false);
+            logger.logRedaction("hash", "ssn");
+            transcript = logger.generateSignedTranscript();
+            expect(transcript.hasRedactions).toBe(true);
+        });
+    });
+    describe("export methods", () => {
+        it("toJSONL returns newline-delimited JSON", () => {
+            logger.logPrompt("First");
+            logger.logPrompt("Second");
+            const jsonl = logger.toJSONL();
+            const lines = jsonl.split("\n");
+            expect(lines.length).toBe(2);
+            expect(JSON.parse(lines[0]).content).toBe("First");
+            expect(JSON.parse(lines[1]).content).toBe("Second");
+        });
+        it("toJSON returns pretty-printed JSON array", () => {
+            logger.logPrompt("Test");
+            const json = logger.toJSON();
+            const parsed = JSON.parse(json);
+            expect(Array.isArray(parsed)).toBe(true);
+            expect(parsed.length).toBe(1);
+        });
+    });
+});
+describe("Logger Factory Functions", () => {
+    beforeEach(() => {
+        // Clear all active loggers
+        for (const sessionId of getActiveSessions()) {
+            removeLogger(sessionId);
+        }
+    });
+    describe("createLogger", () => {
+        it("creates and registers logger", () => {
+            const logger = createLogger("factory-test");
+            expect(logger.getSessionId()).toBe("factory-test");
+            expect(getActiveSessions()).toContain("factory-test");
+        });
+        it("generates session ID if not provided", () => {
+            const logger = createLogger();
+            expect(getActiveSessions()).toContain(logger.getSessionId());
+        });
+    });
+    describe("getLogger", () => {
+        it("retrieves existing logger", () => {
+            const original = createLogger("get-test");
+            original.logPrompt("Test entry");
+            const retrieved = getLogger("get-test");
+            expect(retrieved).toBe(original);
+            expect(retrieved?.getEntryCount()).toBe(1);
+        });
+        it("returns undefined for non-existent logger", () => {
+            const result = getLogger("non-existent");
+            expect(result).toBeUndefined();
+        });
+    });
+    describe("removeLogger", () => {
+        it("removes logger from registry", () => {
+            createLogger("remove-test");
+            expect(getActiveSessions()).toContain("remove-test");
+            const result = removeLogger("remove-test");
+            expect(result).toBe(true);
+            expect(getActiveSessions()).not.toContain("remove-test");
+        });
+        it("returns false for non-existent logger", () => {
+            const result = removeLogger("non-existent");
+            expect(result).toBe(false);
+        });
+    });
+    describe("getActiveSessions", () => {
+        it("returns all active session IDs", () => {
+            createLogger("session-1");
+            createLogger("session-2");
+            createLogger("session-3");
+            const sessions = getActiveSessions();
+            expect(sessions).toContain("session-1");
+            expect(sessions).toContain("session-2");
+            expect(sessions).toContain("session-3");
+        });
+    });
+});
+//# sourceMappingURL=logger.test.js.map

package/dist/transcripts/logger.test.js.map

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

package/dist/transcripts/redaction.d.ts

@@ -0,0 +1,125 @@
+/**
+ * PII Redaction Hooks
+ *
+ * Provides PII detection and redaction for transcript logging.
+ * Supports configurable patterns for various PII types.
+ * Never stores original values - only logs that redaction occurred.
+ *
+ * @module transcripts/redaction
+ */
+/**
+ * Types of PII that can be detected and redacted
+ */
+export type PIIRedactionType = "email" | "phone" | "ssn" | "credit-card" | "ip-address" | "name" | "address" | "api-key" | "password" | "jwt" | "uuid" | "custom";
+/**
+ * Log entry for a redaction (never stores original content)
+ */
+export interface RedactionLog {
+    /** Type of PII redacted */
+    type: PIIRedactionType;
+    /** Starting position in original string */
+    position: number;
+    /** Length of redacted content */
+    length: number;
+    /** Placeholder used for redaction */
+    placeholder: string;
+    /** Hash of original content (for deduplication) */
+    contentHash?: string;
+    /** Pattern name that matched */
+    patternName?: string;
+}
+/**
+ * Result of redacting content
+ */
+export interface RedactionResult {
+    /** Redacted content */
+    redacted: string;
+    /** Log of all redactions performed */
+    redactions: RedactionLog[];
+    /** Whether any PII was found */
+    hadPII: boolean;
+    /** Original content length */
+    originalLength: number;
+    /** Redacted content length */
+    redactedLength: number;
+}
+/**
+ * PII detection pattern
+ */
+export interface PIIPattern {
+    name: string;
+    type: PIIRedactionType;
+    pattern: RegExp;
+    placeholder?: string;
+    validate?: (match: string) => boolean;
+}
+/**
+ * Redaction options
+ */
+export interface RedactionOptions {
+    /** Additional custom patterns */
+    customPatterns?: PIIPattern[];
+    /** Patterns to exclude by name */
+    excludePatterns?: string[];
+    /** Hash original values for deduplication */
+    hashOriginals?: boolean;
+    /** Placeholder format (default: [REDACTED:{type}]) */
+    placeholderFormat?: string;
+    /** Maximum redactions per content (prevents DoS) */
+    maxRedactions?: number;
+}
+/**
+ * Default PII detection patterns
+ */
+export declare const DEFAULT_PII_PATTERNS: PIIPattern[];
+/**
+ * Redact PII from content
+ */
+export declare function redactPII(content: string, options?: RedactionOptions): RedactionResult;
+/**
+ * Check if content contains PII without redacting
+ */
+export declare function containsPII(content: string, options?: RedactionOptions): boolean;
+/**
+ * Get PII statistics for content
+ */
+export declare function analyzePII(content: string, options?: RedactionOptions): {
+    totalPII: number;
+    byType: Record<PIIRedactionType, number>;
+    patterns: string[];
+};
+/**
+ * Redact PII from multiple content strings
+ */
+export declare function redactPIIBatch(contents: string[], options?: RedactionOptions): RedactionResult[];
+/**
+ * Create a redaction hook for TranscriptLogger
+ */
+export declare function createRedactionHook(options?: RedactionOptions): (content: string) => {
+    content: string;
+    redactionLog?: RedactionLog[];
+};
+/**
+ * Create a custom PII pattern
+ */
+export declare function createPIIPattern(name: string, type: PIIRedactionType, pattern: RegExp | string, options?: {
+    placeholder?: string;
+    validate?: (match: string) => boolean;
+}): PIIPattern;
+/**
+ * Get all default pattern names
+ */
+export declare function getDefaultPatternNames(): string[];
+/**
+ * Get patterns by type
+ */
+export declare function getPatternsByType(type: PIIRedactionType): PIIPattern[];
+/**
+ * Generate redaction summary for logging
+ */
+export declare function generateRedactionSummary(results: RedactionResult[]): string;
+/**
+ * Generate markdown report of redactions
+ */
+export declare function generateRedactionReport(results: RedactionResult[]): string;
+//# sourceMappingURL=redaction.d.ts.map

package/dist/transcripts/redaction.d.ts.map

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