@fluxpointstudios/orynq-sdk-flight-recorder 0.1.0

package/dist/recorder/chunk-manager.js

@@ -0,0 +1,172 @@
+/**
+ * Chunk manager for the flight recorder.
+ * Handles chunk creation, compression, encryption, and storage.
+ */
+import { generateKey, encrypt } from "../crypto/encryption.js";
+import { compress } from "../crypto/compression.js";
+import { sha256, merkleLeaf } from "../crypto/hashing.js";
+export class ChunkManager {
+    storage;
+    encryptionConfig;
+    compressionType;
+    chunks = [];
+    leafHashes = [];
+    chunkIndex = 0;
+    encryptionKey = null;
+    constructor(storage, encryptionConfig, compressionType = "gzip") {
+        this.storage = storage;
+        this.encryptionConfig = encryptionConfig;
+        this.compressionType = compressionType;
+    }
+    /**
+     * Initialize encryption key for the session.
+     */
+    async initializeKey() {
+        this.encryptionKey = await generateKey(this.encryptionConfig.algorithm);
+    }
+    /**
+     * Get the current encryption key ID.
+     */
+    getKeyId() {
+        return this.encryptionKey?.keyId ?? null;
+    }
+    /**
+     * Create a chunk from buffered events.
+     */
+    async createChunk(events, eventRange, spanIds) {
+        if (!this.encryptionKey) {
+            throw new Error("Encryption key not initialized. Call initializeKey() first.");
+        }
+        // Serialize events to JSONL
+        const lines = events.map((e) => JSON.stringify(e.event));
+        const jsonl = lines.join("\n");
+        const rawData = new TextEncoder().encode(jsonl);
+        // Compress
+        const compressed = await compress(rawData, this.compressionType);
+        // Encrypt
+        const chunkMeta = {
+            index: this.chunkIndex,
+            eventRange,
+            spanIds,
+            createdAt: new Date().toISOString(),
+        };
+        const additionalData = new TextEncoder().encode(JSON.stringify(chunkMeta));
+        const encrypted = await encrypt(compressed.data, this.encryptionKey, additionalData);
+        // Create chunk data structure
+        const chunkData = {
+            ciphertext: encrypted.ciphertext,
+            nonce: encrypted.nonce,
+            tag: encrypted.tag,
+            meta: chunkMeta,
+        };
+        // Compute content hash of encrypted data
+        const encryptedPayload = new Uint8Array(encrypted.ciphertext.length + encrypted.nonce.length + encrypted.tag.length);
+        encryptedPayload.set(encrypted.ciphertext, 0);
+        encryptedPayload.set(encrypted.nonce, encrypted.ciphertext.length);
+        encryptedPayload.set(encrypted.tag, encrypted.ciphertext.length + encrypted.nonce.length);
+        const chunkHash = await sha256(encryptedPayload, "encryptedChunk");
+        const chunkId = `chunk-${this.chunkIndex.toString().padStart(6, "0")}-${chunkHash.slice(0, 16)}`;
+        // Store chunk
+        const storagePayload = this.serializeChunkForStorage(chunkData);
+        const storageRef = await this.storage.store(storagePayload);
+        // Create chunk reference
+        const chunkRef = {
+            id: chunkId,
+            hash: chunkHash,
+            size: storagePayload.length,
+            storageUri: storageRef.uri,
+            encryptionKeyId: this.encryptionKey.keyId,
+            compression: this.compressionType === "gzip" ? "gzip" : "none",
+        };
+        // Compute Merkle leaf hash
+        const leafHash = await merkleLeaf(encryptedPayload);
+        // Track chunk
+        this.chunks.push(chunkRef);
+        this.leafHashes.push(leafHash);
+        this.chunkIndex++;
+        return {
+            chunkRef,
+            chunkData,
+            leafHash,
+        };
+    }
+    /**
+     * Get all chunk references.
+     */
+    getChunks() {
+        return [...this.chunks];
+    }
+    /**
+     * Get all Merkle leaf hashes.
+     */
+    getLeafHashes() {
+        return [...this.leafHashes];
+    }
+    /**
+     * Get chunk count.
+     */
+    getChunkCount() {
+        return this.chunks.length;
+    }
+    /**
+     * Serialize chunk data for storage.
+     * Format: [4-byte meta length][meta JSON][nonce][tag][ciphertext]
+     */
+    serializeChunkForStorage(chunk) {
+        const metaJson = JSON.stringify(chunk.meta);
+        const metaBytes = new TextEncoder().encode(metaJson);
+        const metaLength = new Uint32Array([metaBytes.length]);
+        const metaLengthBytes = new Uint8Array(metaLength.buffer);
+        const totalLength = 4 + // meta length
+            metaBytes.length +
+            chunk.nonce.length +
+            chunk.tag.length +
+            chunk.ciphertext.length;
+        const result = new Uint8Array(totalLength);
+        let offset = 0;
+        result.set(metaLengthBytes, offset);
+        offset += 4;
+        result.set(metaBytes, offset);
+        offset += metaBytes.length;
+        result.set(chunk.nonce, offset);
+        offset += chunk.nonce.length;
+        result.set(chunk.tag, offset);
+        offset += chunk.tag.length;
+        result.set(chunk.ciphertext, offset);
+        return result;
+    }
+    /**
+     * Deserialize chunk data from storage.
+     */
+    static deserializeChunkFromStorage(data) {
+        let offset = 0;
+        // Read meta length
+        const metaLengthBytes = data.slice(offset, offset + 4);
+        const metaLengthArr = new Uint32Array(metaLengthBytes.buffer);
+        const metaLength = metaLengthArr[0];
+        if (metaLength === undefined) {
+            throw new Error("Invalid chunk data: missing meta length");
+        }
+        offset += 4;
+        // Read meta
+        const metaBytes = data.slice(offset, offset + metaLength);
+        const metaJson = new TextDecoder().decode(metaBytes);
+        const meta = JSON.parse(metaJson);
+        offset += metaLength;
+        // Read nonce (12 bytes for AES-GCM)
+        const nonce = data.slice(offset, offset + 12);
+        offset += 12;
+        // Read tag (16 bytes)
+        const tag = data.slice(offset, offset + 16);
+        offset += 16;
+        // Read ciphertext (rest)
+        const ciphertext = data.slice(offset);
+        return {
+            ciphertext,
+            nonce,
+            tag,
+            meta,
+        };
+    }
+}
+//# sourceMappingURL=chunk-manager.js.map

package/dist/recorder/chunk-manager.js.map

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

package/dist/recorder/event-buffer.d.ts

@@ -0,0 +1,61 @@
+/**
+ * In-memory event buffer for the flight recorder.
+ * Buffers events until chunk threshold is reached.
+ */
+import type { RecorderEvent } from "../types.js";
+export interface BufferedEvent {
+    event: RecorderEvent;
+    serialized: Uint8Array;
+    hash: string;
+}
+export interface BufferStats {
+    eventCount: number;
+    byteSize: number;
+    oldestEventTs: string | null;
+    newestEventTs: string | null;
+}
+export declare class EventBuffer {
+    private readonly maxSizeBytes;
+    private events;
+    private byteSize;
+    private seq;
+    constructor(maxSizeBytes: number);
+    /**
+     * Add an event to the buffer.
+     * Returns true if buffer should be flushed (threshold reached).
+     */
+    add(event: Omit<RecorderEvent, "seq">): Promise<boolean>;
+    /**
+     * Get all buffered events and clear the buffer.
+     */
+    flush(): BufferedEvent[];
+    /**
+     * Peek at buffered events without clearing.
+     */
+    peek(): BufferedEvent[];
+    /**
+     * Get buffer statistics.
+     */
+    getStats(): BufferStats;
+    /**
+     * Check if buffer is empty.
+     */
+    isEmpty(): boolean;
+    /**
+     * Get current sequence number.
+     */
+    getSeq(): number;
+    /**
+     * Get event range in buffer.
+     */
+    getEventRange(): [number, number] | null;
+    /**
+     * Get unique span IDs in buffer.
+     */
+    getSpanIds(): string[];
+    /**
+     * Serialize all events to a single byte array (for chunking).
+     */
+    serialize(): Uint8Array;
+}
+//# sourceMappingURL=event-buffer.d.ts.map

package/dist/recorder/event-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-buffer.d.ts","sourceRoot":"","sources":["../../src/recorder/event-buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,qBAAa,WAAW;IAKV,OAAO,CAAC,QAAQ,CAAC,YAAY;IAJzC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,GAAG,CAAK;gBAEa,YAAY,EAAE,MAAM;IAEjD;;;OAGG;IACG,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAgB9D;;OAEG;IACH,KAAK,IAAI,aAAa,EAAE;IAOxB;;OAEG;IACH,IAAI,IAAI,aAAa,EAAE;IAIvB;;OAEG;IACH,QAAQ,IAAI,WAAW;IASvB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,MAAM,IAAI,MAAM;IAIhB;;OAEG;IACH,aAAa,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAQxC;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAUtB;;OAEG;IACH,SAAS,IAAI,UAAU;CAKxB"}

package/dist/recorder/event-buffer.js

@@ -0,0 +1,101 @@
+/**
+ * In-memory event buffer for the flight recorder.
+ * Buffers events until chunk threshold is reached.
+ */
+import { sha256Json } from "../crypto/hashing.js";
+export class EventBuffer {
+    maxSizeBytes;
+    events = [];
+    byteSize = 0;
+    seq = 0;
+    constructor(maxSizeBytes) {
+        this.maxSizeBytes = maxSizeBytes;
+    }
+    /**
+     * Add an event to the buffer.
+     * Returns true if buffer should be flushed (threshold reached).
+     */
+    async add(event) {
+        const seqEvent = { ...event, seq: this.seq++ };
+        const serialized = new TextEncoder().encode(JSON.stringify(seqEvent));
+        const hash = await sha256Json(seqEvent, "event");
+        this.events.push({
+            event: seqEvent,
+            serialized,
+            hash,
+        });
+        this.byteSize += serialized.length;
+        return this.byteSize >= this.maxSizeBytes;
+    }
+    /**
+     * Get all buffered events and clear the buffer.
+     */
+    flush() {
+        const events = this.events;
+        this.events = [];
+        this.byteSize = 0;
+        return events;
+    }
+    /**
+     * Peek at buffered events without clearing.
+     */
+    peek() {
+        return [...this.events];
+    }
+    /**
+     * Get buffer statistics.
+     */
+    getStats() {
+        return {
+            eventCount: this.events.length,
+            byteSize: this.byteSize,
+            oldestEventTs: this.events[0]?.event.ts ?? null,
+            newestEventTs: this.events[this.events.length - 1]?.event.ts ?? null,
+        };
+    }
+    /**
+     * Check if buffer is empty.
+     */
+    isEmpty() {
+        return this.events.length === 0;
+    }
+    /**
+     * Get current sequence number.
+     */
+    getSeq() {
+        return this.seq;
+    }
+    /**
+     * Get event range in buffer.
+     */
+    getEventRange() {
+        if (this.events.length === 0)
+            return null;
+        const first = this.events[0];
+        const last = this.events[this.events.length - 1];
+        if (!first || !last)
+            return null;
+        return [first.event.seq, last.event.seq];
+    }
+    /**
+     * Get unique span IDs in buffer.
+     */
+    getSpanIds() {
+        const spanIds = new Set();
+        for (const { event } of this.events) {
+            if (event.spanId) {
+                spanIds.add(event.spanId);
+            }
+        }
+        return Array.from(spanIds);
+    }
+    /**
+     * Serialize all events to a single byte array (for chunking).
+     */
+    serialize() {
+        const lines = this.events.map((e) => JSON.stringify(e.event));
+        const jsonl = lines.join("\n");
+        return new TextEncoder().encode(jsonl);
+    }
+}
+//# sourceMappingURL=event-buffer.js.map

package/dist/recorder/event-buffer.js.map

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

package/dist/recorder/index.d.ts

@@ -0,0 +1,4 @@
+export { FlightRecorder } from "./stream-recorder.js";
+export { EventBuffer } from "./event-buffer.js";
+export { ChunkManager } from "./chunk-manager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/recorder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/recorder/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/recorder/index.js

@@ -0,0 +1,4 @@
+export { FlightRecorder } from "./stream-recorder.js";
+export { EventBuffer } from "./event-buffer.js";
+export { ChunkManager } from "./chunk-manager.js";
+//# sourceMappingURL=index.js.map

package/dist/recorder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recorder/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/recorder/stream-recorder.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Main streaming flight recorder.
+ * Captures inference events, manages chunking, and builds manifests.
+ */
+import type { RecorderConfig, RecorderEvent, RecordingSession, RecordingResult } from "../types.js";
+export declare class FlightRecorder {
+    private readonly config;
+    private session;
+    private buffer;
+    private chunkManager;
+    private rollingHashState;
+    private startTime;
+    private toolCallCount;
+    private totalTokens;
+    private completionTokens;
+    private transcriptHashes;
+    private promptHash;
+    private systemPromptHash;
+    private modelName;
+    private inferenceParams;
+    private activeSpans;
+    private completedSpanCount;
+    private chunkTimeout;
+    constructor(config: RecorderConfig);
+    /**
+     * Start a recording session.
+     */
+    start(): Promise<RecordingSession>;
+    /**
+     * Record an event.
+     */
+    record(event: Omit<RecorderEvent, "seq" | "ts">): Promise<void>;
+    /**
+     * Start a span for grouping related events.
+     */
+    startSpan(name: string): string;
+    /**
+     * End a span.
+     */
+    endSpan(spanId: string): void;
+    /**
+     * Record an event within a span.
+     */
+    recordInSpan<T>(_spanId: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Finalize the recording and produce a manifest.
+     */
+    finalize(): Promise<RecordingResult>;
+    /**
+     * Abort the recording.
+     */
+    abort(reason?: string): Promise<void>;
+    /**
+     * Get current session info.
+     */
+    getSession(): RecordingSession | null;
+    private flushBuffer;
+    private trackEventData;
+    private buildManifest;
+    private captureRuntimeInfo;
+    private buildInputs;
+    private buildParams;
+    private startChunkTimeout;
+    private resetChunkTimeout;
+}
+//# sourceMappingURL=stream-recorder.d.ts.map

package/dist/recorder/stream-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-recorder.d.ts","sourceRoot":"","sources":["../../src/recorder/stream-recorder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,eAAe,EAIhB,MAAM,aAAa,CAAC;AAQrB,qBAAa,cAAc;IA2Bb,OAAO,CAAC,QAAQ,CAAC,MAAM;IA1BnC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAe;IAEnC,OAAO,CAAC,gBAAgB,CAAM;IAC9B,OAAO,CAAC,SAAS,CAAqB;IAGtC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,gBAAgB,CAAgB;IAGxC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,eAAe,CAAgC;IAGvD,OAAO,CAAC,WAAW,CAAwD;IAC3E,OAAO,CAAC,kBAAkB,CAAK;IAG/B,OAAO,CAAC,YAAY,CAA8C;gBAErC,MAAM,EAAE,cAAc;IASnD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA+BxC;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCrE;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAM/B;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO7B;;OAEG;IACG,YAAY,CAAC,CAAC,EAClB,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;IAMb;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,eAAe,CAAC;IA6E1C;;OAEG;IACG,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB3C;;OAEG;IACH,UAAU,IAAI,gBAAgB,GAAG,IAAI;YAMvB,WAAW;YAsBX,cAAc;YAyBd,aAAa;IA+C3B,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,iBAAiB;CAM1B"}