@fluxpointstudios/orynq-sdk-flight-recorder 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @fluxpointstudios/orynq-sdk-flight-recorder
+ *
+ * Streaming flight recorder for Proof of Inference (PoI).
+ * Captures inference events with chunking, compression, and encryption.
+ *
+ * @example
+ * ```typescript
+ * import { FlightRecorder, LocalStorageAdapter } from '@fluxpointstudios/orynq-sdk-flight-recorder';
+ *
+ * const storage = new LocalStorageAdapter({ baseDir: './traces' });
+ *
+ * const recorder = new FlightRecorder({
+ *   agentId: 'my-agent',
+ *   chunkSizeBytes: 4 * 1024 * 1024, // 4MB chunks
+ *   encryption: {
+ *     algorithm: 'aes-256-gcm',
+ *     keyDerivation: 'hkdf-sha256',
+ *     keyMode: { type: 'ephemeral' },
+ *   },
+ *   storage,
+ * });
+ *
+ * await recorder.start();
+ *
+ * await recorder.record({
+ *   kind: 'inference:start',
+ *   requestId: 'req-123',
+ *   model: 'claude-3-opus',
+ *   promptHash: '...',
+ *   params: { temperature: 0.7 },
+ * });
+ *
+ * const result = await recorder.finalize();
+ * console.log('Manifest:', result.manifest);
+ * ```
+ */
+export * from "./types.js";
+export { FlightRecorder } from "./recorder/stream-recorder.js";
+export { EventBuffer } from "./recorder/event-buffer.js";
+export { ChunkManager } from "./recorder/chunk-manager.js";
+export { generateKey, encrypt, decrypt, exportKey, importKey, deriveKey, type EncryptionKey, type EncryptedData, } from "./crypto/encryption.js";
+export { compress, decompress, compressString, decompressString, isCompressible, type CompressionType, type CompressionResult, } from "./crypto/compression.js";
+export { sha256, sha256String, sha256Json, rollingHash, merkleLeaf, merkleNode, buildMerkleRoot, generateMerkleProof, verifyMerkleProof, HASH_DOMAINS, type HashDomain, type MerkleProof, } from "./crypto/hashing.js";
+export { ManifestBuilder, type ManifestInput } from "./manifest/manifest-builder.js";
+export { LocalStorageAdapter, type LocalStorageConfig } from "./storage/local-adapter.js";
+export { OpenClawAdapter, type LegacyTraceEvent, type LegacyTraceBundle, type LegacyManifest, } from "./integration/openclaw-adapter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAGH,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAG3D,OAAO,EACL,WAAW,EACX,OAAO,EACP,OAAO,EACP,SAAS,EACT,SAAS,EACT,SAAS,EACT,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,QAAQ,EACR,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,MAAM,EACN,YAAY,EACZ,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAGrF,OAAO,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAG1F,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -0,0 +1,54 @@
+/**
+ * @fluxpointstudios/orynq-sdk-flight-recorder
+ *
+ * Streaming flight recorder for Proof of Inference (PoI).
+ * Captures inference events with chunking, compression, and encryption.
+ *
+ * @example
+ * ```typescript
+ * import { FlightRecorder, LocalStorageAdapter } from '@fluxpointstudios/orynq-sdk-flight-recorder';
+ *
+ * const storage = new LocalStorageAdapter({ baseDir: './traces' });
+ *
+ * const recorder = new FlightRecorder({
+ *   agentId: 'my-agent',
+ *   chunkSizeBytes: 4 * 1024 * 1024, // 4MB chunks
+ *   encryption: {
+ *     algorithm: 'aes-256-gcm',
+ *     keyDerivation: 'hkdf-sha256',
+ *     keyMode: { type: 'ephemeral' },
+ *   },
+ *   storage,
+ * });
+ *
+ * await recorder.start();
+ *
+ * await recorder.record({
+ *   kind: 'inference:start',
+ *   requestId: 'req-123',
+ *   model: 'claude-3-opus',
+ *   promptHash: '...',
+ *   params: { temperature: 0.7 },
+ * });
+ *
+ * const result = await recorder.finalize();
+ * console.log('Manifest:', result.manifest);
+ * ```
+ */
+// Types
+export * from "./types.js";
+// Core recorder
+export { FlightRecorder } from "./recorder/stream-recorder.js";
+export { EventBuffer } from "./recorder/event-buffer.js";
+export { ChunkManager } from "./recorder/chunk-manager.js";
+// Crypto utilities
+export { generateKey, encrypt, decrypt, exportKey, importKey, deriveKey, } from "./crypto/encryption.js";
+export { compress, decompress, compressString, decompressString, isCompressible, } from "./crypto/compression.js";
+export { sha256, sha256String, sha256Json, rollingHash, merkleLeaf, merkleNode, buildMerkleRoot, generateMerkleProof, verifyMerkleProof, HASH_DOMAINS, } from "./crypto/hashing.js";
+// Manifest
+export { ManifestBuilder } from "./manifest/manifest-builder.js";
+// Storage
+export { LocalStorageAdapter } from "./storage/local-adapter.js";
+// Integration
+export { OpenClawAdapter, } from "./integration/openclaw-adapter.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,gBAAgB;AAChB,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,mBAAmB;AACnB,OAAO,EACL,WAAW,EACX,OAAO,EACP,OAAO,EACP,SAAS,EACT,SAAS,EACT,SAAS,GAGV,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,QAAQ,EACR,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,GAGf,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,MAAM,EACN,YAAY,EACZ,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,GAGb,MAAM,qBAAqB,CAAC;AAE7B,WAAW;AACX,OAAO,EAAE,eAAe,EAAsB,MAAM,gCAAgC,CAAC;AAErF,UAAU;AACV,OAAO,EAAE,mBAAmB,EAA2B,MAAM,4BAA4B,CAAC;AAE1F,cAAc;AACd,OAAO,EACL,eAAe,GAIhB,MAAM,mCAAmC,CAAC"}

package/dist/integration/index.d.ts

@@ -0,0 +1,2 @@
+export { OpenClawAdapter } from "./openclaw-adapter.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/integration/index.js

@@ -0,0 +1,2 @@
+export { OpenClawAdapter } from "./openclaw-adapter.js";
+//# sourceMappingURL=index.js.map

package/dist/integration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/integration/openclaw-adapter.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Adapter for migrating from poi-openclaw to flight-recorder.
+ * Bridges legacy trace formats to the new ManifestV2 format.
+ */
+import type { RecorderConfig, RecordingResult, ManifestV2 } from "../types.js";
+/**
+ * Legacy trace event format from poi-openclaw.
+ */
+export interface LegacyTraceEvent {
+    ts: string;
+    kind: "user" | "assistant" | "tool_call" | "tool_result";
+    agentId?: string;
+    sessionId?: string;
+    contentHash: string;
+    content?: string | null;
+    meta?: Record<string, unknown>;
+}
+/**
+ * Legacy trace bundle from poi-openclaw.
+ */
+export interface LegacyTraceBundle {
+    bundleId: string;
+    events: LegacyTraceEvent[];
+}
+/**
+ * Legacy manifest format from poi-openclaw.
+ */
+export interface LegacyManifest {
+    formatVersion: string;
+    agentId: string;
+    rootHash: string;
+    manifestHash: string;
+    merkleRoot: string;
+    totalEvents: number;
+    totalSpans: number;
+    createdAt: string;
+    metadata?: {
+        bundlePath?: string;
+    };
+}
+/**
+ * Adapter to bridge poi-openclaw traces to flight-recorder.
+ */
+export declare class OpenClawAdapter {
+    private readonly config;
+    constructor(config: RecorderConfig);
+    /**
+     * Convert a legacy trace bundle to a new recording.
+     */
+    importLegacyBundle(bundle: LegacyTraceBundle): Promise<RecordingResult>;
+    /**
+     * Convert a legacy event to a RecorderEvent.
+     */
+    private convertEvent;
+    /**
+     * Convert a legacy manifest to ManifestV2 format.
+     */
+    convertManifest(legacy: LegacyManifest): Promise<ManifestV2>;
+    /**
+     * Check if a manifest is in legacy format.
+     */
+    static isLegacyManifest(manifest: unknown): manifest is LegacyManifest;
+}
+//# sourceMappingURL=openclaw-adapter.d.ts.map

package/dist/integration/openclaw-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-adapter.d.ts","sourceRoot":"","sources":["../../src/integration/openclaw-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,UAAU,EAKX,MAAM,aAAa,CAAC;AAarB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,CAAC;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC;AAED;;GAEG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAEnD;;OAEG;IACG,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAkB7E;;OAEG;IACH,OAAO,CAAC,YAAY;IAsDpB;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IA2ClE;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,cAAc;CAUvE"}

package/dist/integration/openclaw-adapter.js

@@ -0,0 +1,137 @@
+/**
+ * Adapter for migrating from poi-openclaw to flight-recorder.
+ * Bridges legacy trace formats to the new ManifestV2 format.
+ */
+import { FlightRecorder } from "../recorder/stream-recorder.js";
+import { sha256String } from "../crypto/hashing.js";
+/**
+ * Adapter to bridge poi-openclaw traces to flight-recorder.
+ */
+export class OpenClawAdapter {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Convert a legacy trace bundle to a new recording.
+     */
+    async importLegacyBundle(bundle) {
+        const recorder = new FlightRecorder({
+            ...this.config,
+            sessionId: bundle.bundleId,
+        });
+        await recorder.start();
+        for (const event of bundle.events) {
+            const converted = await this.convertEvent(event);
+            if (converted) {
+                await recorder.record(converted);
+            }
+        }
+        return recorder.finalize();
+    }
+    /**
+     * Convert a legacy event to a RecorderEvent.
+     */
+    convertEvent(event) {
+        switch (event.kind) {
+            case "user": {
+                const result = {
+                    kind: "inference:start",
+                    requestId: `req-${Date.now()}`,
+                    model: "unknown",
+                    promptHash: event.contentHash,
+                    params: {},
+                };
+                if (event.sessionId)
+                    result.spanId = event.sessionId;
+                return result;
+            }
+            case "assistant": {
+                const result = {
+                    kind: "inference:end",
+                    requestId: `req-${Date.now()}`,
+                    outputHash: event.contentHash,
+                    tokenCounts: { prompt: 0, completion: 0 },
+                    durationMs: 0,
+                };
+                if (event.sessionId)
+                    result.spanId = event.sessionId;
+                return result;
+            }
+            case "tool_call": {
+                const result = {
+                    kind: "tool:call",
+                    toolName: event.meta?.toolName || "unknown",
+                    argsHash: event.contentHash,
+                    visibility: "private",
+                };
+                if (event.sessionId)
+                    result.spanId = event.sessionId;
+                return result;
+            }
+            case "tool_result": {
+                const result = {
+                    kind: "tool:result",
+                    toolName: event.meta?.toolName || "unknown",
+                    resultHash: event.contentHash,
+                    success: true,
+                    visibility: "private",
+                };
+                if (event.sessionId)
+                    result.spanId = event.sessionId;
+                return result;
+            }
+            default:
+                return null;
+        }
+    }
+    /**
+     * Convert a legacy manifest to ManifestV2 format.
+     */
+    async convertManifest(legacy) {
+        const now = new Date().toISOString();
+        return {
+            formatVersion: "2.0",
+            agentId: legacy.agentId,
+            sessionId: legacy.metadata?.bundlePath || `migrated-${Date.now()}`,
+            rootHash: legacy.rootHash,
+            merkleRoot: legacy.merkleRoot,
+            manifestHash: await sha256String(JSON.stringify(legacy)),
+            inputs: {
+                promptHash: "", // Not available in legacy format
+            },
+            params: {
+                model: "unknown",
+            },
+            runtime: {
+                recorderVersion: "migrated-from-openclaw",
+            },
+            chunks: [], // Legacy format doesn't have chunks
+            outputs: {
+                transcriptRollingHash: legacy.rootHash,
+                toolCallCount: 0,
+                totalTokens: 0,
+                completionTokens: 0,
+            },
+            createdAt: legacy.createdAt,
+            startedAt: legacy.createdAt,
+            endedAt: now,
+            durationMs: 0,
+            totalEvents: legacy.totalEvents,
+            totalSpans: legacy.totalSpans,
+        };
+    }
+    /**
+     * Check if a manifest is in legacy format.
+     */
+    static isLegacyManifest(manifest) {
+        if (!manifest || typeof manifest !== "object")
+            return false;
+        const m = manifest;
+        return (typeof m.formatVersion === "string" &&
+            m.formatVersion.startsWith("1.") &&
+            typeof m.agentId === "string" &&
+            typeof m.rootHash === "string");
+    }
+}
+//# sourceMappingURL=openclaw-adapter.js.map

package/dist/integration/openclaw-adapter.js.map

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

package/dist/manifest/index.d.ts

@@ -0,0 +1,2 @@
+export { ManifestBuilder } from "./manifest-builder.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/manifest/index.js

@@ -0,0 +1,2 @@
+export { ManifestBuilder } from "./manifest-builder.js";
+//# sourceMappingURL=index.js.map

package/dist/manifest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/manifest/manifest-builder.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Manifest builder for flight recorder.
+ * Constructs ManifestV2 from recording data.
+ */
+import type { ManifestV2, ChunkRef, VerifierPolicy, TeeType } from "../types.js";
+export interface ManifestInput {
+    agentId: string;
+    sessionId: string;
+    rootHash: string;
+    merkleRoot: string;
+    chunks: ChunkRef[];
+    inputs: {
+        promptHash: string;
+        systemPromptHash?: string;
+        toolContextHash?: string;
+    };
+    params: {
+        model: string;
+        temperature?: number;
+        topP?: number;
+        topK?: number;
+        maxTokens?: number;
+    };
+    runtime: {
+        recorderVersion: string;
+        nodeVersion?: string;
+        containerDigest?: string;
+        gitCommit?: string;
+    };
+    outputs: {
+        transcriptRollingHash: string;
+        toolCallCount: number;
+        totalTokens: number;
+        completionTokens: number;
+    };
+    timing: {
+        startedAt: string;
+        endedAt: string;
+        durationMs: number;
+    };
+    stats: {
+        totalEvents: number;
+        totalSpans: number;
+    };
+    attestation?: {
+        teeType: TeeType;
+        evidenceHash: string;
+        evidenceUri?: string;
+        verifierPolicy: VerifierPolicy;
+        boundHash: "rootHash" | "manifestHash" | "merkleRoot";
+    };
+}
+export declare class ManifestBuilder {
+    /**
+     * Build a ManifestV2 from input data.
+     */
+    build(input: ManifestInput): Promise<ManifestV2>;
+    /**
+     * Compute the manifest hash.
+     * Hash is computed over the manifest with manifestHash set to empty string.
+     */
+    computeManifestHash(manifest: ManifestV2): Promise<string>;
+    /**
+     * Verify a manifest's integrity.
+     */
+    verify(manifest: ManifestV2): Promise<boolean>;
+    /**
+     * Create a minimal manifest for testing.
+     */
+    static createMinimal(agentId: string, sessionId: string): ManifestV2;
+}
+//# sourceMappingURL=manifest-builder.d.ts.map

package/dist/manifest/manifest-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-builder.d.ts","sourceRoot":"","sources":["../../src/manifest/manifest-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGjF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,QAAQ,EAAE,CAAC;IAEnB,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IAEF,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,OAAO,EAAE;QACP,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,OAAO,EAAE;QACP,qBAAqB,EAAE,MAAM,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IAEF,MAAM,EAAE;QACN,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,WAAW,CAAC,EAAE;QACZ,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,cAAc,CAAC;QAC/B,SAAS,EAAE,UAAU,GAAG,cAAc,GAAG,YAAY,CAAC;KACvD,CAAC;CACH;AAED,qBAAa,eAAe;IAC1B;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAqCtD;;;OAGG;IACG,mBAAmB,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAKhE;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAKpD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU;CA2BrE"}

package/dist/manifest/manifest-builder.js

@@ -0,0 +1,84 @@
+/**
+ * Manifest builder for flight recorder.
+ * Constructs ManifestV2 from recording data.
+ */
+import { sha256Json } from "../crypto/hashing.js";
+export class ManifestBuilder {
+    /**
+     * Build a ManifestV2 from input data.
+     */
+    async build(input) {
+        const manifest = {
+            formatVersion: "2.0",
+            agentId: input.agentId,
+            sessionId: input.sessionId,
+            rootHash: input.rootHash,
+            merkleRoot: input.merkleRoot,
+            manifestHash: "", // Computed below
+            inputs: input.inputs,
+            params: input.params,
+            runtime: input.runtime,
+            chunks: input.chunks,
+            outputs: input.outputs,
+            createdAt: new Date().toISOString(),
+            startedAt: input.timing.startedAt,
+            endedAt: input.timing.endedAt,
+            durationMs: input.timing.durationMs,
+            totalEvents: input.stats.totalEvents,
+            totalSpans: input.stats.totalSpans,
+        };
+        // Add attestation if provided
+        if (input.attestation) {
+            manifest.attestation = input.attestation;
+        }
+        // Compute manifest hash
+        manifest.manifestHash = await this.computeManifestHash(manifest);
+        return manifest;
+    }
+    /**
+     * Compute the manifest hash.
+     * Hash is computed over the manifest with manifestHash set to empty string.
+     */
+    async computeManifestHash(manifest) {
+        const toHash = { ...manifest, manifestHash: "" };
+        return sha256Json(toHash, "manifest");
+    }
+    /**
+     * Verify a manifest's integrity.
+     */
+    async verify(manifest) {
+        const expectedHash = await this.computeManifestHash(manifest);
+        return manifest.manifestHash === expectedHash;
+    }
+    /**
+     * Create a minimal manifest for testing.
+     */
+    static createMinimal(agentId, sessionId) {
+        const now = new Date().toISOString();
+        return {
+            formatVersion: "2.0",
+            agentId,
+            sessionId,
+            rootHash: "",
+            merkleRoot: "",
+            manifestHash: "",
+            inputs: { promptHash: "" },
+            params: { model: "unknown" },
+            runtime: { recorderVersion: "0.1.0" },
+            chunks: [],
+            outputs: {
+                transcriptRollingHash: "",
+                toolCallCount: 0,
+                totalTokens: 0,
+                completionTokens: 0,
+            },
+            createdAt: now,
+            startedAt: now,
+            endedAt: now,
+            durationMs: 0,
+            totalEvents: 0,
+            totalSpans: 0,
+        };
+    }
+}
+//# sourceMappingURL=manifest-builder.js.map

package/dist/manifest/manifest-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-builder.js","sourceRoot":"","sources":["../../src/manifest/manifest-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAyDlD,MAAM,OAAO,eAAe;IAC1B;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,KAAoB;QAC9B,MAAM,QAAQ,GAAe;YAC3B,aAAa,EAAE,KAAK;YAEpB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS;YAE1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,YAAY,EAAE,EAAE,EAAE,iBAAiB;YAEnC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;YAEtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS;YACjC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;YAC7B,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU;YAEnC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW;YACpC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU;SACnC,CAAC;QAEF,8BAA8B;QAC9B,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,QAAQ,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QAC3C,CAAC;QAED,wBAAwB;QACxB,QAAQ,CAAC,YAAY,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAEjE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,mBAAmB,CAAC,QAAoB;QAC5C,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;QACjD,OAAO,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,QAAoB;QAC/B,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC9D,OAAO,QAAQ,CAAC,YAAY,KAAK,YAAY,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAe,EAAE,SAAiB;QACrD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,OAAO;YACL,aAAa,EAAE,KAAK;YACpB,OAAO;YACP,SAAS;YACT,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,EAAE;YACd,YAAY,EAAE,EAAE;YAChB,MAAM,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;YAC1B,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;YAC5B,OAAO,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE;YACrC,MAAM,EAAE,EAAE;YACV,OAAO,EAAE;gBACP,qBAAqB,EAAE,EAAE;gBACzB,aAAa,EAAE,CAAC;gBAChB,WAAW,EAAE,CAAC;gBACd,gBAAgB,EAAE,CAAC;aACpB;YACD,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;YACd,OAAO,EAAE,GAAG;YACZ,UAAU,EAAE,CAAC;YACb,WAAW,EAAE,CAAC;YACd,UAAU,EAAE,CAAC;SACd,CAAC;IACJ,CAAC;CACF"}

package/dist/recorder/chunk-manager.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Chunk manager for the flight recorder.
+ * Handles chunk creation, compression, encryption, and storage.
+ */
+import type { ChunkRef, ChunkData, StorageAdapter, EncryptionConfig } from "../types.js";
+import { type CompressionType } from "../crypto/compression.js";
+import type { BufferedEvent } from "./event-buffer.js";
+export interface ChunkCreateResult {
+    chunkRef: ChunkRef;
+    chunkData: ChunkData;
+    leafHash: string;
+}
+export declare class ChunkManager {
+    private readonly storage;
+    private readonly encryptionConfig;
+    private readonly compressionType;
+    private chunks;
+    private leafHashes;
+    private chunkIndex;
+    private encryptionKey;
+    constructor(storage: StorageAdapter, encryptionConfig: EncryptionConfig, compressionType?: CompressionType);
+    /**
+     * Initialize encryption key for the session.
+     */
+    initializeKey(): Promise<void>;
+    /**
+     * Get the current encryption key ID.
+     */
+    getKeyId(): string | null;
+    /**
+     * Create a chunk from buffered events.
+     */
+    createChunk(events: BufferedEvent[], eventRange: [number, number], spanIds: string[]): Promise<ChunkCreateResult>;
+    /**
+     * Get all chunk references.
+     */
+    getChunks(): ChunkRef[];
+    /**
+     * Get all Merkle leaf hashes.
+     */
+    getLeafHashes(): string[];
+    /**
+     * Get chunk count.
+     */
+    getChunkCount(): number;
+    /**
+     * Serialize chunk data for storage.
+     * Format: [4-byte meta length][meta JSON][nonce][tag][ciphertext]
+     */
+    private serializeChunkForStorage;
+    /**
+     * Deserialize chunk data from storage.
+     */
+    static deserializeChunkFromStorage(data: Uint8Array): ChunkData;
+}
+//# sourceMappingURL=chunk-manager.d.ts.map

package/dist/recorder/chunk-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-manager.d.ts","sourceRoot":"","sources":["../../src/recorder/chunk-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,cAAc,EACd,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,YAAY;IAOrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe;IARlC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAA8B;gBAGhC,OAAO,EAAE,cAAc,EACvB,gBAAgB,EAAE,gBAAgB,EAClC,eAAe,GAAE,eAAwB;IAG5D;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC;;OAEG;IACH,QAAQ,IAAI,MAAM,GAAG,IAAI;IAIzB;;OAEG;IACG,WAAW,CACf,MAAM,EAAE,aAAa,EAAE,EACvB,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,iBAAiB,CAAC;IAuE7B;;OAEG;IACH,SAAS,IAAI,QAAQ,EAAE;IAIvB;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAIzB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAiChC;;OAEG;IACH,MAAM,CAAC,2BAA2B,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS;CAoChE"}