@kuralle-syrinx/recorder 4.4.0 → 4.5.0

package/dist/index.d.ts

@@ -0,0 +1,118 @@
+import { type PipelineBus, type PluginConfig, type VoicePlugin } from "@kuralle-syrinx/core";
+export { interleaveStereoPcm16, pcm16ToWav } from "./wav.js";
+export interface VoiceSessionRecorderConfig {
+    readonly outputDir: string;
+    readonly sessionId?: string;
+    readonly eventsFile?: string;
+    readonly userAudioFile?: string;
+    readonly assistantAudioFile?: string;
+    readonly manifestFile?: string;
+    readonly conversationFile?: string;
+    readonly userSampleRateHz?: number;
+    readonly assistantSampleRateHz?: number;
+}
+export interface VoiceSessionRecorderFiles {
+    readonly directory: string;
+    readonly eventsPath: string;
+    readonly userAudioPath: string;
+    readonly assistantAudioPath: string;
+    readonly manifestPath: string;
+    readonly conversationAudioPath?: string;
+}
+export interface VoiceSessionRecorderManifest {
+    readonly schemaVersion: 1;
+    readonly sessionId?: string;
+    readonly startedAtMs: number;
+    readonly closedAtMs: number;
+    readonly files: VoiceSessionRecorderFiles;
+    readonly audio: {
+        readonly user: {
+            readonly path: string;
+            readonly sampleRateHz: number;
+            readonly encoding: "pcm_s16le";
+            readonly channels: 1;
+            readonly byteLength: number;
+            readonly durationMs: number;
+            readonly chunks: number;
+        };
+        readonly assistant: {
+            readonly path: string;
+            readonly sampleRateHz: number;
+            readonly encoding: "pcm_s16le";
+            readonly channels: 1;
+            readonly byteLength: number;
+            readonly durationMs: number;
+            readonly chunks: number;
+            readonly truncations: number;
+        };
+        readonly conversation?: {
+            readonly path: string;
+            readonly sampleRateHz: number;
+            readonly channels: 2;
+            readonly encoding: "pcm_s16le";
+            readonly byteLength: number;
+            readonly durationMs: number;
+        };
+    };
+    readonly events: {
+        readonly path: string;
+        readonly packets: number;
+        readonly byteLength: number;
+    };
+}
+export declare class VoiceSessionRecorder implements VoicePlugin {
+    private bus;
+    private events;
+    private userAudio;
+    private assistantAudio;
+    private sessionId;
+    private userSampleRateHz;
+    private userChunks;
+    private userCursorBytes;
+    private assistantChunks;
+    private assistantCursorBytes;
+    private assistantPlayoutStartMs;
+    private assistantSampleRateHz;
+    private assistantSampleRateLocked;
+    private startedAtMs;
+    private userAudioBytes;
+    private userAudioChunks;
+    private assistantAudioBytes;
+    private assistantAudioChunks;
+    private assistantTruncations;
+    private eventBytes;
+    private eventPackets;
+    private conversationFile;
+    private conversationAudioPath;
+    private conversationAudioBytes;
+    private packetReader;
+    private packetPump;
+    private pendingWrites;
+    private closing;
+    private writeFailure;
+    private filesValue;
+    get files(): VoiceSessionRecorderFiles | null;
+    initialize(bus: PipelineBus, config: PluginConfig): Promise<void>;
+    close(): Promise<void>;
+    private recordPackets;
+    private writeEvent;
+    private recordUserAudio;
+    private recordAssistantAudio;
+    private recordPlayoutProgress;
+    private truncateAssistantAudio;
+    private flushUserAudio;
+    private flushAssistantAudio;
+    private writeConversationWav;
+    private writeManifest;
+    private currentUserWallOffsetBytes;
+    private currentAssistantWallOffsetBytes;
+    private reanchorAssistantToPlayout;
+    private writeStreamData;
+    private validatePcm16ByteLength;
+    private acceptAssistantSampleRate;
+    private waitForPendingWrites;
+}
+export declare function createVoiceSessionRecorder(config: VoiceSessionRecorderConfig): VoiceSessionRecorder;
+export declare function assertVoiceSessionRecorderManifest(manifest: unknown): asserts manifest is VoiceSessionRecorderManifest;
+export declare function validateVoiceSessionRecorderManifest(manifest: unknown): string[];
+//# 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":"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"}