@camerontaylor/paseo-server 0.8.0-fork.1

package/dist/server/server/dictation/dictation-stream-manager.js

@@ -0,0 +1,578 @@
+import { v4 as uuidv4 } from "uuid";
+import { createDictationDebugChunkWriter, maybePersistDictationDebugAudio, } from "../agent/dictation-debug.js";
+import { isPaseoDictationDebugEnabled } from "../agent/recordings-debug.js";
+import { Pcm16MonoResampler } from "../agent/pcm16-resampler.js";
+import { toResolver } from "../speech/provider-resolver.js";
+import { parsePcmRateFromFormat, pcm16lePeakAbs } from "../speech/audio.js";
+const PCM_CHANNELS = 1;
+const PCM_BITS_PER_SAMPLE = 16;
+const DEFAULT_DICTATION_FINAL_TIMEOUT_MS = 10000;
+const DEFAULT_DICTATION_AUTO_COMMIT_SECONDS = 15;
+const DICTATION_FINAL_TIMEOUT_MAX_MS = 5 * 60 * 1000;
+const DICTATION_FINAL_TIMEOUT_PER_PENDING_SEGMENT_MS = 15 * 1000;
+const DICTATION_FINAL_TIMEOUT_PER_PENDING_AUDIO_SECOND_MS = 1500;
+const DICTATION_FINAL_TIMEOUT_PER_MISSING_SEQ_MS = 250;
+const DICTATION_SILENCE_PEAK_THRESHOLD = Number.parseInt(process.env.PASEO_DICTATION_SILENCE_PEAK_THRESHOLD ?? "300", 10);
+function parseNonNegativeNumber(value) {
+    if (value === undefined) {
+        return null;
+    }
+    const parsed = Number.parseFloat(value);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        return null;
+    }
+    return parsed;
+}
+function convertPCMToWavBuffer(pcmBuffer, sampleRate, channels, bitsPerSample) {
+    const headerSize = 44;
+    const wavBuffer = Buffer.alloc(headerSize + pcmBuffer.length);
+    const byteRate = (sampleRate * channels * bitsPerSample) / 8;
+    const blockAlign = (channels * bitsPerSample) / 8;
+    wavBuffer.write("RIFF", 0);
+    wavBuffer.writeUInt32LE(36 + pcmBuffer.length, 4);
+    wavBuffer.write("WAVE", 8);
+    wavBuffer.write("fmt ", 12);
+    wavBuffer.writeUInt32LE(16, 16);
+    wavBuffer.writeUInt16LE(1, 20);
+    wavBuffer.writeUInt16LE(channels, 22);
+    wavBuffer.writeUInt32LE(sampleRate, 24);
+    wavBuffer.writeUInt32LE(byteRate, 28);
+    wavBuffer.writeUInt16LE(blockAlign, 32);
+    wavBuffer.writeUInt16LE(bitsPerSample, 34);
+    wavBuffer.write("data", 36);
+    wavBuffer.writeUInt32LE(pcmBuffer.length, 40);
+    pcmBuffer.copy(wavBuffer, 44);
+    return wavBuffer;
+}
+export class DictationStreamManager {
+    constructor(params) {
+        this.streams = new Map();
+        this.logger = params.logger.child({ component: "dictation-stream-manager" });
+        this.emit = params.emit;
+        this.sessionId = params.sessionId;
+        this.resolveStt = toResolver(params.stt);
+        this.language = params.language ?? "en";
+        this.finalTimeoutMs = params.finalTimeoutMs ?? DEFAULT_DICTATION_FINAL_TIMEOUT_MS;
+        this.autoCommitSeconds =
+            params.autoCommitSeconds ??
+                parseNonNegativeNumber(process.env.PASEO_DICTATION_AUTO_COMMIT_SECONDS) ??
+                DEFAULT_DICTATION_AUTO_COMMIT_SECONDS;
+    }
+    cleanupAll() {
+        for (const dictationId of this.streams.keys()) {
+            this.cleanupDictationStream(dictationId);
+        }
+    }
+    async handleStart(dictationId, format) {
+        this.cleanupDictationStream(dictationId);
+        const sttProvider = this.resolveStt();
+        if (!sttProvider) {
+            this.failDictationStream(dictationId, "Dictation STT not configured", false);
+            return;
+        }
+        const transcriptionPrompt = process.env.PASEO_DICTATION_TRANSCRIPTION_PROMPT ??
+            "Transcribe only what the speaker says. Do not add words. Preserve punctuation and casing. If the audio is silence or non-speech noise, return an empty transcript.";
+        let stt;
+        try {
+            stt = sttProvider.createSession({
+                logger: this.logger.child({ dictationId }),
+                language: this.language,
+                prompt: transcriptionPrompt,
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.failDictationStream(dictationId, message, false);
+            return;
+        }
+        stt.on("committed", ({ segmentId }) => {
+            const state = this.streams.get(dictationId);
+            if (!state) {
+                return;
+            }
+            if (state.inFlightCommitCount > 0) {
+                state.inFlightCommitCount -= 1;
+            }
+            state.committedSegmentIds.push(segmentId);
+            if (state.finishRequested && state.awaitingFinalCommit) {
+                state.awaitingFinalCommit = false;
+            }
+            this.maybeFinalizeDictationStream(dictationId);
+        });
+        stt.on("transcript", ({ segmentId, transcript, isFinal }) => {
+            const state = this.streams.get(dictationId);
+            if (!state) {
+                return;
+            }
+            state.transcriptsBySegmentId.set(segmentId, transcript);
+            if (isFinal) {
+                state.finalTranscriptSegmentIds.add(segmentId);
+            }
+            if (state.finishRequested && state.awaitingFinalCommit && isFinal) {
+                state.awaitingFinalCommit = false;
+            }
+            const orderedIds = state.committedSegmentIds.includes(segmentId)
+                ? state.committedSegmentIds
+                : [...state.committedSegmentIds, segmentId];
+            const partialText = orderedIds
+                .map((id) => state.transcriptsBySegmentId.get(id) ?? "")
+                .join(" ")
+                .trim();
+            this.emitDictationPartial(dictationId, partialText);
+            this.maybeSealDictationStreamFinish(dictationId);
+            this.maybeFinalizeDictationStream(dictationId);
+        });
+        stt.on("error", (err) => {
+            const message = err instanceof Error ? err.message : String(err);
+            const state = this.streams.get(dictationId);
+            if (state && state.finishRequested && isBufferTooSmallError(message)) {
+                if (state.inFlightCommitCount > 0) {
+                    state.inFlightCommitCount -= 1;
+                }
+                if (state.awaitingFinalCommit) {
+                    state.awaitingFinalCommit = false;
+                }
+                this.maybeFinalizeDictationStream(dictationId);
+                return;
+            }
+            void this.failAndCleanupDictationStream(dictationId, message, true);
+        });
+        try {
+            await stt.connect();
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.failDictationStream(dictationId, message, true);
+            try {
+                stt.close();
+            }
+            catch {
+                // no-op
+            }
+            return;
+        }
+        const inputRate = parsePcmRateFromFormat(format, 16000) ?? 16000;
+        if (!Number.isFinite(inputRate) || inputRate <= 0) {
+            this.failDictationStream(dictationId, `Invalid dictation input rate in format: ${format}`, false);
+            try {
+                stt.close();
+            }
+            catch {
+                // no-op
+            }
+            return;
+        }
+        const debugChunkWriter = createDictationDebugChunkWriter({ sessionId: this.sessionId, dictationId }, this.logger);
+        const outputRate = stt.requiredSampleRate;
+        const autoCommitBytes = this.autoCommitSeconds > 0
+            ? Math.max(1, Math.round(this.autoCommitSeconds * outputRate * 2))
+            : 0;
+        this.streams.set(dictationId, {
+            dictationId,
+            sessionId: this.sessionId,
+            inputFormat: format,
+            stt,
+            inputRate,
+            outputRate,
+            resampler: inputRate === outputRate
+                ? null
+                : new Pcm16MonoResampler({
+                    inputRate,
+                    outputRate,
+                }),
+            debugAudioChunks: [],
+            debugRecordingPath: null,
+            debugChunkWriter,
+            receivedChunks: new Map(),
+            nextSeqToForward: 0,
+            ackSeq: -1,
+            autoCommitBytes,
+            bytesSinceCommit: 0,
+            peakSinceCommit: 0,
+            committedSegmentIds: [],
+            transcriptsBySegmentId: new Map(),
+            finalTranscriptSegmentIds: new Set(),
+            inFlightCommitCount: 0,
+            awaitingFinalCommit: false,
+            finishRequested: false,
+            finishSealed: false,
+            finalSeq: null,
+            finalTimeout: null,
+        });
+        this.emitDictationAck(dictationId, -1);
+    }
+    async handleChunk(params) {
+        const state = this.streams.get(params.dictationId);
+        if (!state) {
+            this.failDictationStream(params.dictationId, "Dictation stream not started", true);
+            return;
+        }
+        if (params.format !== state.inputFormat) {
+            void this.failAndCleanupDictationStream(params.dictationId, `Mismatched dictation stream format: ${params.format}`, false);
+            return;
+        }
+        if (params.seq < state.nextSeqToForward) {
+            this.emitDictationAck(params.dictationId, state.ackSeq);
+            return;
+        }
+        if (!state.receivedChunks.has(params.seq)) {
+            state.receivedChunks.set(params.seq, Buffer.from(params.audioBase64, "base64"));
+        }
+        while (state.receivedChunks.has(state.nextSeqToForward)) {
+            const seq = state.nextSeqToForward;
+            const pcm16 = state.receivedChunks.get(seq);
+            state.receivedChunks.delete(seq);
+            const resampled = state.resampler ? state.resampler.processChunk(pcm16) : pcm16;
+            if (resampled.length > 0) {
+                state.stt.appendPcm16(resampled);
+                state.debugAudioChunks.push(resampled);
+                state.bytesSinceCommit += resampled.length;
+                state.peakSinceCommit = Math.max(state.peakSinceCommit, pcm16lePeakAbs(resampled));
+                try {
+                    this.maybeAutoCommitDictationSegment(state);
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    void this.failAndCleanupDictationStream(params.dictationId, message, true);
+                    return;
+                }
+                if (state.debugChunkWriter) {
+                    void state.debugChunkWriter.writeChunk(seq, resampled).catch((err) => {
+                        this.logger.warn({ dictationId: params.dictationId, seq, err }, "Failed to write debug chunk");
+                    });
+                }
+            }
+            state.nextSeqToForward += 1;
+            state.ackSeq = state.nextSeqToForward - 1;
+        }
+        this.emitDictationAck(params.dictationId, state.ackSeq);
+        this.maybeSealDictationStreamFinish(params.dictationId);
+        this.maybeFinalizeDictationStream(params.dictationId);
+    }
+    async handleFinish(dictationId, finalSeq) {
+        const state = this.streams.get(dictationId);
+        if (!state) {
+            this.failDictationStream(dictationId, "Dictation stream not started", true);
+            return;
+        }
+        state.finishRequested = true;
+        state.finalSeq = finalSeq;
+        if (finalSeq >= 0 &&
+            state.ackSeq < 0 &&
+            state.nextSeqToForward === 0 &&
+            state.receivedChunks.size === 0) {
+            this.logger.debug({
+                dictationId,
+                finalSeq,
+                ackSeq: state.ackSeq,
+                nextSeqToForward: state.nextSeqToForward,
+                receivedChunks: state.receivedChunks.size,
+                bytesSinceCommit: state.bytesSinceCommit,
+            }, "Dictation finish: no chunks received (failing fast)");
+            this.failDictationStream(dictationId, `Dictation finished (finalSeq=${finalSeq}) but no audio chunks were received`, true);
+            this.cleanupDictationStream(dictationId);
+            return;
+        }
+        this.maybeSealDictationStreamFinish(dictationId);
+        this.maybeFinalizeDictationStream(dictationId);
+        const updatedState = this.streams.get(dictationId);
+        if (!updatedState) {
+            return;
+        }
+        const timeoutEstimate = this.estimateFinalizationTimeout(updatedState);
+        if (updatedState.finalTimeout) {
+            clearTimeout(updatedState.finalTimeout);
+        }
+        updatedState.finalTimeout = setTimeout(() => {
+            void this.failAndCleanupDictationStream(dictationId, "Timed out waiting for final transcription", true);
+        }, timeoutEstimate.timeoutMs);
+        this.emit({
+            type: "dictation_stream_finish_accepted",
+            payload: {
+                dictationId,
+                timeoutMs: timeoutEstimate.timeoutMs,
+            },
+        });
+        this.logger.debug({
+            dictationId,
+            finalSeq,
+            ackSeq: updatedState.ackSeq,
+            pendingSegments: timeoutEstimate.pendingSegments,
+            pendingAudioSeconds: timeoutEstimate.pendingAudioSeconds,
+            missingSeqCount: timeoutEstimate.missingSeqCount,
+            timeoutMs: timeoutEstimate.timeoutMs,
+        }, "Accepted dictation finish request with adaptive timeout budget");
+    }
+    handleCancel(dictationId) {
+        this.cleanupDictationStream(dictationId);
+    }
+    emitDictationAck(dictationId, ackSeq) {
+        this.emit({ type: "dictation_stream_ack", payload: { dictationId, ackSeq } });
+    }
+    emitDictationPartial(dictationId, text) {
+        this.emit({ type: "dictation_stream_partial", payload: { dictationId, text } });
+    }
+    async maybePersistDictationStreamAudio(dictationId) {
+        if (!isPaseoDictationDebugEnabled()) {
+            return null;
+        }
+        const state = this.streams.get(dictationId);
+        if (!state) {
+            return null;
+        }
+        if (state.debugRecordingPath) {
+            return state.debugRecordingPath;
+        }
+        if (state.debugAudioChunks.length === 0) {
+            return null;
+        }
+        const pcmBuffer = Buffer.concat(state.debugAudioChunks);
+        const wavBuffer = convertPCMToWavBuffer(pcmBuffer, state.outputRate, PCM_CHANNELS, PCM_BITS_PER_SAMPLE);
+        const path = await maybePersistDictationDebugAudio(wavBuffer, { sessionId: state.sessionId, dictationId: state.dictationId, format: "audio/wav" }, this.logger, state.debugChunkWriter?.folder);
+        state.debugRecordingPath = path;
+        return path;
+    }
+    failDictationStream(dictationId, error, retryable) {
+        this.emit({
+            type: "dictation_stream_error",
+            payload: { dictationId, error, retryable },
+        });
+    }
+    async failAndCleanupDictationStream(dictationId, error, retryable) {
+        const debugRecordingPath = await this.maybePersistDictationStreamAudio(dictationId);
+        this.emit({
+            type: "dictation_stream_error",
+            payload: {
+                dictationId,
+                error,
+                retryable,
+                ...(debugRecordingPath ? { debugRecordingPath } : {}),
+            },
+        });
+        if (debugRecordingPath) {
+            this.emit({
+                type: "activity_log",
+                payload: {
+                    id: uuidv4(),
+                    timestamp: new Date(),
+                    type: "system",
+                    content: `Saved dictation audio: ${debugRecordingPath}`,
+                    metadata: { recordingPath: debugRecordingPath, dictationId },
+                },
+            });
+        }
+        this.cleanupDictationStream(dictationId);
+    }
+    cleanupDictationStream(dictationId) {
+        const state = this.streams.get(dictationId) ?? null;
+        if (!state) {
+            return;
+        }
+        if (state.finalTimeout) {
+            clearTimeout(state.finalTimeout);
+        }
+        try {
+            state.stt.close();
+        }
+        catch {
+            // no-op
+        }
+        this.streams.delete(dictationId);
+    }
+    estimateFinalizationTimeout(state) {
+        const bytesPerSecond = Math.max(1, state.outputRate * PCM_CHANNELS * (PCM_BITS_PER_SAMPLE / 8));
+        const pendingCommittedSegments = state.committedSegmentIds.reduce((count, segmentId) => {
+            return state.finalTranscriptSegmentIds.has(segmentId) ? count : count + 1;
+        }, 0);
+        const pendingSegments = pendingCommittedSegments + state.inFlightCommitCount;
+        const pendingAudioSeconds = Math.ceil(Math.max(0, state.bytesSinceCommit) / bytesPerSecond);
+        const missingSeqCount = state.finalSeq === null ? 0 : Math.max(0, state.finalSeq - state.ackSeq);
+        const extraMs = pendingSegments * DICTATION_FINAL_TIMEOUT_PER_PENDING_SEGMENT_MS +
+            pendingAudioSeconds * DICTATION_FINAL_TIMEOUT_PER_PENDING_AUDIO_SECOND_MS +
+            missingSeqCount * DICTATION_FINAL_TIMEOUT_PER_MISSING_SEQ_MS;
+        const timeoutMs = Math.max(this.finalTimeoutMs, Math.min(DICTATION_FINAL_TIMEOUT_MAX_MS, this.finalTimeoutMs + extraMs));
+        return {
+            timeoutMs,
+            pendingSegments,
+            pendingAudioSeconds,
+            missingSeqCount,
+        };
+    }
+    maybeAutoCommitDictationSegment(state) {
+        if (state.finishRequested) {
+            return;
+        }
+        if (state.autoCommitBytes <= 0 || state.bytesSinceCommit < state.autoCommitBytes) {
+            return;
+        }
+        if (state.peakSinceCommit < DICTATION_SILENCE_PEAK_THRESHOLD) {
+            state.stt.clear();
+            state.bytesSinceCommit = 0;
+            state.peakSinceCommit = 0;
+            return;
+        }
+        this.requestDictationCommit(state);
+    }
+    requestDictationCommit(state) {
+        state.bytesSinceCommit = 0;
+        state.peakSinceCommit = 0;
+        state.inFlightCommitCount += 1;
+        try {
+            state.stt.commit();
+        }
+        catch (error) {
+            state.inFlightCommitCount -= 1;
+            throw error;
+        }
+    }
+    maybeSealDictationStreamFinish(dictationId) {
+        const state = this.streams.get(dictationId);
+        if (!state) {
+            return;
+        }
+        if (!state.finishRequested || state.finalSeq === null) {
+            return;
+        }
+        if (state.ackSeq < state.finalSeq) {
+            return;
+        }
+        if (state.finishSealed) {
+            return;
+        }
+        if (state.bytesSinceCommit > 0) {
+            if (state.peakSinceCommit < DICTATION_SILENCE_PEAK_THRESHOLD) {
+                this.logger.debug({
+                    dictationId,
+                    bytesSinceCommit: state.bytesSinceCommit,
+                    peakSinceCommit: state.peakSinceCommit,
+                }, "Dictation finish: clearing silence-only tail (skip final commit)");
+                state.stt.clear();
+                state.bytesSinceCommit = 0;
+                state.peakSinceCommit = 0;
+                state.awaitingFinalCommit = false;
+            }
+            else {
+                state.awaitingFinalCommit = true;
+                try {
+                    this.requestDictationCommit(state);
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    void this.failAndCleanupDictationStream(dictationId, message, true);
+                    return;
+                }
+            }
+        }
+        else {
+            state.awaitingFinalCommit = false;
+        }
+        state.finishSealed = true;
+    }
+    dropUncommittedNonFinalTranscripts(state) {
+        const committedSet = new Set(state.committedSegmentIds);
+        let droppedCount = 0;
+        for (const segmentId of state.transcriptsBySegmentId.keys()) {
+            if (committedSet.has(segmentId)) {
+                continue;
+            }
+            if (state.finalTranscriptSegmentIds.has(segmentId)) {
+                continue;
+            }
+            state.transcriptsBySegmentId.delete(segmentId);
+            droppedCount += 1;
+        }
+        return droppedCount;
+    }
+    maybeFinalizeDictationStream(dictationId) {
+        const state = this.streams.get(dictationId);
+        if (!state) {
+            return;
+        }
+        if (!state.finishRequested || state.finalSeq === null) {
+            return;
+        }
+        if (state.ackSeq < state.finalSeq) {
+            return;
+        }
+        if (state.awaitingFinalCommit) {
+            return;
+        }
+        if (state.inFlightCommitCount > 0) {
+            return;
+        }
+        const droppedSegments = this.dropUncommittedNonFinalTranscripts(state);
+        if (droppedSegments > 0) {
+            this.logger.debug({ dictationId, droppedSegments }, "Dropped abandoned non-final dictation transcript segments before finalization");
+        }
+        const committedSet = new Set(state.committedSegmentIds);
+        const orderedSegmentIds = [...state.committedSegmentIds];
+        for (const segmentId of state.transcriptsBySegmentId.keys()) {
+            if (!committedSet.has(segmentId)) {
+                orderedSegmentIds.push(segmentId);
+            }
+        }
+        if (orderedSegmentIds.length === 0) {
+            void (async () => {
+                const debugRecordingPath = await this.maybePersistDictationStreamAudio(dictationId);
+                this.emit({
+                    type: "dictation_stream_final",
+                    payload: {
+                        dictationId,
+                        text: "",
+                        ...(debugRecordingPath ? { debugRecordingPath } : {}),
+                    },
+                });
+                if (debugRecordingPath) {
+                    this.emit({
+                        type: "activity_log",
+                        payload: {
+                            id: uuidv4(),
+                            timestamp: new Date(),
+                            type: "system",
+                            content: `Saved dictation audio: ${debugRecordingPath}`,
+                            metadata: { recordingPath: debugRecordingPath, dictationId },
+                        },
+                    });
+                }
+                this.cleanupDictationStream(dictationId);
+            })();
+            return;
+        }
+        const allTranscriptsReady = orderedSegmentIds.every((segmentId) => state.finalTranscriptSegmentIds.has(segmentId));
+        if (!allTranscriptsReady) {
+            return;
+        }
+        const orderedText = orderedSegmentIds
+            .map((segmentId) => state.transcriptsBySegmentId.get(segmentId) ?? "")
+            .join(" ")
+            .trim();
+        void (async () => {
+            const debugRecordingPath = await this.maybePersistDictationStreamAudio(dictationId);
+            this.emit({
+                type: "dictation_stream_final",
+                payload: {
+                    dictationId,
+                    text: orderedText,
+                    ...(debugRecordingPath ? { debugRecordingPath } : {}),
+                },
+            });
+            if (debugRecordingPath) {
+                this.emit({
+                    type: "activity_log",
+                    payload: {
+                        id: uuidv4(),
+                        timestamp: new Date(),
+                        type: "system",
+                        content: `Saved dictation audio: ${debugRecordingPath}`,
+                        metadata: { recordingPath: debugRecordingPath, dictationId },
+                    },
+                });
+            }
+            this.cleanupDictationStream(dictationId);
+        })();
+    }
+}
+function isBufferTooSmallError(message) {
+    return /buffer too small/i.test(message);
+}
+//# sourceMappingURL=dictation-stream-manager.js.map

package/dist/server/server/directory-sync/index.d.ts

@@ -0,0 +1,45 @@
+import type { AgentSnapshotPayload, ProjectPlacementPayload, SessionOutboundMessage, WorkspaceDescriptorPayload, WorkspaceProjectDescriptorPayload } from "@camerontaylor/paseo-protocol/messages";
+interface AgentDirectoryEntry {
+    agent: AgentSnapshotPayload;
+    project: ProjectPlacementPayload;
+}
+interface DirectorySyncCursor {
+    generation?: string;
+    afterSeq?: number;
+}
+interface DirectoryVersion {
+    generation: string;
+    seq: number;
+}
+type ProjectUpdate = Extract<SessionOutboundMessage, {
+    type: "project.update";
+}>;
+type ProjectListResponse = Extract<SessionOutboundMessage, {
+    type: "project.list.response";
+}>["payload"];
+type FetchWorkspacesResponse = Extract<SessionOutboundMessage, {
+    type: "fetch_workspaces_response";
+}>["payload"];
+type FetchAgentsResponse = Extract<SessionOutboundMessage, {
+    type: "fetch_agents_response";
+}>["payload"];
+/** Daemon-global latest-state sequence owner for the active app directory. */
+export declare class DirectorySyncService {
+    private readonly generation;
+    private readonly projects;
+    private readonly workspaces;
+    private readonly agents;
+    constructor(generation?: `${string}-${string}-${string}-${string}-${string}`);
+    synchronizeProjects(snapshot: Iterable<WorkspaceProjectDescriptorPayload>, cursor: DirectorySyncCursor): Pick<ProjectListResponse, "projects" | "sync">;
+    synchronizeWorkspaces(snapshot: Iterable<WorkspaceDescriptorPayload>, cursor: DirectorySyncCursor): Pick<FetchWorkspacesResponse, "entries" | "emptyProjects" | "pageInfo" | "sync">;
+    synchronizeAgents(snapshot: Iterable<AgentDirectoryEntry>, cursor: DirectorySyncCursor): Pick<FetchAgentsResponse, "entries" | "pageInfo" | "sync">;
+    sequenceProjectUpdate(update: ProjectUpdate["payload"], includeSequence: boolean): ProjectUpdate["payload"];
+    sequenceWorkspaceUpdate<T extends object>(payload: T, value: WorkspaceDescriptorPayload | null, id: string, includeSequence: boolean): T & Partial<DirectoryVersion>;
+    sequenceAgentUpdate<T extends object>(payload: T, value: AgentDirectoryEntry | null, id: string, includeSequence: boolean): T & Partial<DirectoryVersion>;
+    private metadata;
+    private withVersion;
+    private read;
+    private version;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map