@relayplane/proxy 1.8.37 → 1.8.39

package/dist/trace-writer.d.ts

@@ -0,0 +1,155 @@
+/**
+ * TraceWriter — deterministic per-request trace files for RelayPlane.
+ *
+ * Writes structured JSONL trace files to ~/.relayplane/traces/{sessionId}/{YYYY-MM-DD}/{traceId}.jsonl
+ * and maintains a SQLite index at ~/.relayplane/traces/index.db.
+ *
+ * CAP 3: Deterministic Traces (Phase 2, Session 2)
+ */
+export type TraceEventType = 'request.start' | 'request.end' | 'tool.call' | 'tool.result' | 'tool.denied' | 'model.response.start' | 'model.response.end' | 'budget.checkpoint' | 'budget.threshold.hit' | 'model.switch' | 'memory.read' | 'memory.write' | 'session.start' | 'session.end';
+export interface TracePayload {
+    model?: string;
+    modelUsed?: string;
+    systemPromptHash?: string;
+    messageCount?: number;
+    requestedTools?: string[];
+    tokensIn?: number;
+    tokensOut?: number;
+    costUsd?: number;
+    finishReason?: string;
+    toolName?: string;
+    toolInputHash?: string;
+    toolOutputHash?: string;
+    toolInputPreview?: string;
+    sessionCostUsd?: number;
+    sessionCapUsd?: number;
+    sessionPct?: number;
+    fromModel?: string;
+    toModel?: string;
+    switchReason?: string;
+    memoryLayer?: 'semantic' | 'episodic' | 'procedural';
+    memoryKeysAccessed?: string[];
+}
+export interface TraceEvent {
+    traceId: string;
+    sessionId: string;
+    parentTraceId?: string;
+    agentId?: string;
+    sequence: number;
+    timestamp: number;
+    eventType: TraceEventType;
+    durationMs?: number;
+    error?: {
+        code: string;
+        message: string;
+        retryable: boolean;
+    };
+    payload: TracePayload;
+}
+export interface SessionGraph {
+    sessionId: string;
+    rootTraceId: string;
+    startedAt: number;
+    endedAt?: number;
+    nodes: Array<{
+        id: string;
+        type: 'request' | 'tool-call' | 'subagent';
+        label: string;
+        startedAt: number;
+        durationMs?: number;
+        costUsd?: number;
+        outcome?: 'success' | 'failure' | 'denied';
+    }>;
+    edges: Array<{
+        from: string;
+        to: string;
+        type: 'spawned' | 'called' | 'replied';
+        timestamp: number;
+    }>;
+}
+export interface TracesConfig {
+    enabled: boolean;
+    /** Store full request bodies for replay (default: false — hashes only) */
+    storeFullRequests: boolean;
+    retentionDays: number;
+    directory: string;
+    maxDiskMb: number;
+}
+export interface ReplayResult {
+    originalTraceId: string;
+    replayTraceId: string;
+    matchScore: number;
+    diffs: Array<{
+        field: string;
+        original: unknown;
+        replayed: unknown;
+    }>;
+}
+export interface ExportOptions {
+    format: 'jsonl' | 'csv' | 'markdown' | 'traceops';
+    sessionIds?: string[];
+    fromTimestamp?: number;
+    toTimestamp?: number;
+    includeToolInputs?: boolean;
+    outputPath?: string;
+}
+/** Input type for write() — partial event (traceId, sessionId, sequence, timestamp filled in) */
+export interface WriteEventInput {
+    eventType: TraceEventType;
+    parentTraceId?: string;
+    agentId?: string;
+    durationMs?: number;
+    error?: {
+        code: string;
+        message: string;
+        retryable: boolean;
+    };
+    payload?: TracePayload;
+}
+export declare function defaultTracesConfig(): TracesConfig;
+export declare class TraceWriter {
+    private static _instance;
+    private db;
+    private readonly config;
+    private readonly baseDir;
+    private readonly sessionSequences;
+    private readonly traceEventCounts;
+    private readonly traceStartTimes;
+    private readonly sessionGraphs;
+    private readonly sessionIdleTimers;
+    private readonly knownSessions;
+    private constructor();
+    static getInstance(config?: TracesConfig): TraceWriter;
+    /** Replace the singleton (for testing / config reload) */
+    static reset(): void;
+    isEnabled(): boolean;
+    private initDb;
+    private traceFilePath;
+    private traceRelPath;
+    /** Estimate total size of baseDir in bytes (best-effort, non-recursive to keep it fast). */
+    private estimateDirSizeBytes;
+    /** Returns true if writing is allowed under the maxDiskMb cap. */
+    private isDiskBudgetOk;
+    private nextSequence;
+    private resetIdleTimer;
+    private updateGraph;
+    write(sessionId: string, traceId: string, input: WriteEventInput): Promise<void>;
+    private writeEventSync;
+    finalizeTrace(traceId: string, sessionId: string, meta: {
+        costUsd?: number;
+        modelUsed?: string;
+        durationMs?: number;
+    }): Promise<void>;
+    endSession(sessionId: string): Promise<void>;
+    private upsertSessionGraphRecord;
+    getRecentTraces(limit?: number): unknown[];
+    getSessionGraph(sessionId: string): SessionGraph | null;
+    /** Read raw JSONL events for a trace by traceId. Returns parsed events array. */
+    getTraceEvents(traceId: string): TraceEvent[];
+    export(options: ExportOptions): Promise<string>;
+    replay(_traceId: string): Promise<ReplayResult>;
+    pruneOldFiles(): void;
+    shutdown(): void;
+}
+export declare function sha256Hex(input: string): string;
+//# sourceMappingURL=trace-writer.d.ts.map

package/dist/trace-writer.d.ts.map

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