botmux 2.111.0 → 2.112.0

package/dist/services/vc-meeting-delivery-protocol.js

@@ -0,0 +1,443 @@
+import { createHash } from 'node:crypto';
+import { canonicalJson, computeInputHash } from '../utils/canonical-input-hash.js';
+import { normalizeVcMeetingMemberPolicy } from './vc-meeting-member-policy.js';
+import { normalizeVcMeetingProfileInstructions } from './vc-meeting-profile-instructions.js';
+export const VC_MEETING_DELIVERY_SCHEMA_VERSION = 1;
+export const VC_MEETING_DELIVERY_KEY_NAMESPACE = 'vc_';
+export const VC_MEETING_DELIVERY_KEY_MAX_LENGTH = 50;
+export const VC_MEETING_DELIVERY_KINDS = [
+    'item',
+    'final',
+    'gap',
+    'effect_result',
+    'control',
+];
+export const VC_MEETING_DELIVERY_GAP_REASONS = [
+    'retention_expired',
+    'poll_unavailable',
+    'recovery_ambiguous',
+    'backpressure_skipped',
+    'operator_skip',
+];
+export const VC_MEETING_MEMBER_STATUSES = ['active', 'paused', 'removed'];
+export const VC_MEETING_RESPONSE_MODES = ['silent', 'listener_thread'];
+/** Validate the fenced hub -> receiver membership projection. The receiver
+ *  chooses receiverSessionId after this step; the hub cannot inject one. */
+export function validateVcMeetingMemberProjectionRequest(raw) {
+    if (!isRecord(raw))
+        return badProjectionRequest('request body must be an object');
+    if (raw.schemaVersion !== VC_MEETING_DELIVERY_SCHEMA_VERSION) {
+        return badProjectionRequest('schemaVersion must be 1', 'schemaVersion');
+    }
+    if (!isRecord(raw.meeting))
+        return badProjectionRequest('meeting must be an object', 'meeting');
+    if (!isRecord(raw.member))
+        return badProjectionRequest('member must be an object', 'member');
+    if (!isRecord(raw.outputRoute))
+        return badProjectionRequest('outputRoute must be an object', 'outputRoute');
+    for (const [value, path] of [
+        [raw.meeting.listenerAppId, 'meeting.listenerAppId'],
+        [raw.meeting.meetingId, 'meeting.meetingId'],
+        [raw.meeting.ownerBootId, 'meeting.ownerBootId'],
+        [raw.member.memberId, 'member.memberId'],
+        [raw.member.agentAppId, 'member.agentAppId'],
+        [raw.member.role, 'member.role'],
+        [raw.outputRoute.chatId, 'outputRoute.chatId'],
+    ]) {
+        const error = validateIdentifier(value, path);
+        if (error)
+            return { ...error, errorCode: 'bad_request' };
+    }
+    for (const [value, path] of [
+        [raw.meeting.ownerEpoch, 'meeting.ownerEpoch'],
+        [raw.member.epoch, 'member.epoch'],
+        [raw.member.membershipGeneration, 'member.membershipGeneration'],
+    ]) {
+        if (!isPositiveSafeInteger(value)) {
+            return badProjectionRequest(`${path} must be a positive safe integer`, path);
+        }
+    }
+    if (typeof raw.member.joinedAtIngestSeq !== 'number'
+        || !Number.isSafeInteger(raw.member.joinedAtIngestSeq)
+        || raw.member.joinedAtIngestSeq < 0) {
+        return badProjectionRequest('member.joinedAtIngestSeq must be a non-negative safe integer', 'member.joinedAtIngestSeq');
+    }
+    if (typeof raw.member.status !== 'string'
+        || !VC_MEETING_MEMBER_STATUSES.includes(raw.member.status)) {
+        return badProjectionRequest('member.status is not supported', 'member.status');
+    }
+    if (typeof raw.member.responseMode !== 'string'
+        || !VC_MEETING_RESPONSE_MODES.includes(raw.member.responseMode)) {
+        return badProjectionRequest('member.responseMode is not supported', 'member.responseMode');
+    }
+    const policy = normalizeVcMeetingMemberPolicy({
+        memberId: raw.member.memberId,
+        role: raw.member.role,
+        membershipGeneration: raw.member.membershipGeneration,
+        responseMode: raw.member.responseMode,
+        filter: raw.member.filter,
+        capabilities: raw.member.capabilities,
+        ownedSinks: raw.member.ownedSinks,
+        sinkOwnerGeneration: raw.member.sinkOwnerGeneration,
+    });
+    if (!policy) {
+        return badProjectionRequest('member filter/capabilities/ownedSinks/sinkOwnerGeneration are invalid', 'member');
+    }
+    const normalizedInstructions = normalizeVcMeetingProfileInstructions(raw.member.instructions);
+    if (!normalizedInstructions.ok) {
+        return badProjectionRequest(`member.instructions ${normalizedInstructions.error}`, 'member.instructions');
+    }
+    return {
+        ok: true,
+        request: {
+            schemaVersion: VC_MEETING_DELIVERY_SCHEMA_VERSION,
+            meeting: {
+                listenerAppId: raw.meeting.listenerAppId,
+                meetingId: raw.meeting.meetingId,
+                ownerBootId: raw.meeting.ownerBootId,
+                ownerEpoch: raw.meeting.ownerEpoch,
+            },
+            member: {
+                memberId: raw.member.memberId,
+                agentAppId: raw.member.agentAppId,
+                role: raw.member.role,
+                ...(normalizedInstructions.instructions !== undefined
+                    ? { instructions: normalizedInstructions.instructions }
+                    : {}),
+                epoch: raw.member.epoch,
+                membershipGeneration: raw.member.membershipGeneration,
+                status: raw.member.status,
+                joinedAtIngestSeq: raw.member.joinedAtIngestSeq,
+                responseMode: raw.member.responseMode,
+                ...policy,
+            },
+            outputRoute: { chatId: raw.outputRoute.chatId },
+        },
+    };
+}
+/**
+ * Return the full semantic delivery envelope used for input immutability.
+ * Transport timestamps/trace ids and the claimed inputHash are excluded.
+ *
+ * This function intentionally copies the v1 schema field-by-field. Callers
+ * must bump schemaVersion and this projection together when adding a semantic
+ * field, so an unrecognised transport property cannot silently change runtime
+ * behaviour without entering the hash.
+ */
+export function canonicalVcMeetingDeliveryInput(request) {
+    return {
+        schemaVersion: request.schemaVersion,
+        meeting: {
+            listenerAppId: request.meeting.listenerAppId,
+            meetingId: request.meeting.meetingId,
+            ownerBootId: request.meeting.ownerBootId,
+            ownerEpoch: request.meeting.ownerEpoch,
+        },
+        member: {
+            memberId: request.member.memberId,
+            agentAppId: request.member.agentAppId,
+            role: request.member.role,
+            epoch: request.member.epoch,
+            membershipGeneration: request.member.membershipGeneration,
+        },
+        stream: {
+            fromSeq: request.stream.fromSeq,
+            toSeq: request.stream.toSeq,
+            batchId: request.stream.batchId,
+            final: request.stream.final,
+        },
+        entries: request.entries.map((entry) => ({
+            deliverySeq: entry.deliverySeq,
+            ...(entry.ingestSeq !== undefined ? { ingestSeq: entry.ingestSeq } : {}),
+            ...(entry.itemVersionKey !== undefined ? { itemVersionKey: entry.itemVersionKey } : {}),
+            ...(entry.contentHash !== undefined ? { contentHash: entry.contentHash } : {}),
+            kind: entry.kind,
+            ...(entry.controlKey !== undefined ? { controlKey: entry.controlKey } : {}),
+            ...(entry.gap !== undefined ? {
+                gap: {
+                    ...(entry.gap.occurredFromMs !== undefined ? { occurredFromMs: entry.gap.occurredFromMs } : {}),
+                    ...(entry.gap.occurredToMs !== undefined ? { occurredToMs: entry.gap.occurredToMs } : {}),
+                    ...(entry.gap.missingItemVersionKey !== undefined
+                        ? { missingItemVersionKey: entry.gap.missingItemVersionKey }
+                        : {}),
+                    ...(entry.gap.originalContentHash !== undefined
+                        ? { originalContentHash: entry.gap.originalContentHash }
+                        : {}),
+                    reason: entry.gap.reason,
+                },
+            } : {}),
+            rawText: entry.rawText,
+        })),
+        target: {
+            sessionId: request.target.sessionId,
+            chatId: request.target.chatId,
+        },
+        instructionVersion: request.instructionVersion,
+    };
+}
+export function computeVcMeetingDeliveryInputHash(request) {
+    return computeInputHash(canonicalVcMeetingDeliveryInput(request));
+}
+/**
+ * Derive a provider-safe, bounded key from the ordered stream identity and
+ * canonical input hash. The canonical tuple avoids delimiter-boundary
+ * collisions; the `vc_` prefix leaves 188 bits of truncated SHA-256 entropy.
+ */
+export function deriveVcMeetingDeliveryKey(input) {
+    assertDeliveryKeyString(input.meetingId, 'meetingId');
+    assertDeliveryKeyString(input.memberId, 'memberId');
+    assertPositiveSafeInteger(input.epoch, 'epoch');
+    assertPositiveSafeInteger(input.fromSeq, 'fromSeq');
+    assertPositiveSafeInteger(input.toSeq, 'toSeq');
+    if (input.fromSeq > input.toSeq) {
+        throw new Error('deriveVcMeetingDeliveryKey: fromSeq must be <= toSeq');
+    }
+    if (!/^sha256:[0-9a-f]{64}$/.test(input.inputHash)) {
+        throw new Error('deriveVcMeetingDeliveryKey: inputHash must be a lowercase sha256 hash');
+    }
+    const hash = createHash('sha256')
+        .update(canonicalJson(input), 'utf8')
+        .digest('hex');
+    return VC_MEETING_DELIVERY_KEY_NAMESPACE
+        + hash.slice(0, VC_MEETING_DELIVERY_KEY_MAX_LENGTH - VC_MEETING_DELIVERY_KEY_NAMESPACE.length);
+}
+export function deriveVcMeetingDeliveryIdentity(request) {
+    const inputHash = computeVcMeetingDeliveryInputHash(request);
+    return {
+        inputHash,
+        deliveryKey: deriveVcMeetingDeliveryKey({
+            meetingId: request.meeting.meetingId,
+            memberId: request.member.memberId,
+            epoch: request.member.epoch,
+            fromSeq: request.stream.fromSeq,
+            toSeq: request.stream.toSeq,
+            inputHash,
+        }),
+    };
+}
+/** Validate and seal the v1 delivery envelope before any durable claim. */
+export function validateVcMeetingDeliveryRequest(raw) {
+    if (!isRecord(raw))
+        return badRequest('request body must be an object');
+    if (raw.schemaVersion !== VC_MEETING_DELIVERY_SCHEMA_VERSION) {
+        return badRequest('schemaVersion must be 1', 'schemaVersion');
+    }
+    if (!isRecord(raw.meeting))
+        return badRequest('meeting must be an object', 'meeting');
+    if (!isRecord(raw.member))
+        return badRequest('member must be an object', 'member');
+    if (raw.member.instructions !== undefined) {
+        return badRequest('member.instructions belongs to the registered membership projection, not a delivery envelope', 'member.instructions');
+    }
+    if (!isRecord(raw.stream))
+        return badRequest('stream must be an object', 'stream');
+    if (!Array.isArray(raw.entries))
+        return badRequest('entries must be an array', 'entries');
+    if (!isRecord(raw.target))
+        return badRequest('target must be an object', 'target');
+    const stringFields = [
+        [raw.meeting.listenerAppId, 'meeting.listenerAppId'],
+        [raw.meeting.meetingId, 'meeting.meetingId'],
+        [raw.meeting.ownerBootId, 'meeting.ownerBootId'],
+        [raw.member.memberId, 'member.memberId'],
+        [raw.member.agentAppId, 'member.agentAppId'],
+        [raw.member.role, 'member.role'],
+        [raw.stream.batchId, 'stream.batchId'],
+        [raw.target.sessionId, 'target.sessionId'],
+        [raw.target.chatId, 'target.chatId'],
+        [raw.instructionVersion, 'instructionVersion'],
+    ];
+    for (const [value, path] of stringFields) {
+        const error = validateIdentifier(value, path);
+        if (error)
+            return error;
+    }
+    if (raw.sentAt !== undefined && typeof raw.sentAt !== 'string') {
+        return badRequest('sentAt must be a string when present', 'sentAt');
+    }
+    if (raw.traceId !== undefined && typeof raw.traceId !== 'string') {
+        return badRequest('traceId must be a string when present', 'traceId');
+    }
+    const integerFields = [
+        [raw.meeting.ownerEpoch, 'meeting.ownerEpoch'],
+        [raw.member.epoch, 'member.epoch'],
+        [raw.member.membershipGeneration, 'member.membershipGeneration'],
+        [raw.stream.fromSeq, 'stream.fromSeq'],
+        [raw.stream.toSeq, 'stream.toSeq'],
+    ];
+    for (const [value, path] of integerFields) {
+        if (!isPositiveSafeInteger(value)) {
+            return badRequest(`${path} must be a positive safe integer`, path);
+        }
+    }
+    if (raw.stream.fromSeq > raw.stream.toSeq) {
+        return badRequest('stream.fromSeq must be <= stream.toSeq', 'stream');
+    }
+    if (typeof raw.stream.final !== 'boolean') {
+        return badRequest('stream.final must be a boolean', 'stream.final');
+    }
+    if (typeof raw.stream.inputHash !== 'string'
+        || !/^sha256:[0-9a-f]{64}$/.test(raw.stream.inputHash)) {
+        return badRequest('stream.inputHash must be a lowercase sha256 hash', 'stream.inputHash');
+    }
+    const fromSeq = raw.stream.fromSeq;
+    const toSeq = raw.stream.toSeq;
+    const expectedLength = toSeq - fromSeq + 1;
+    if (raw.entries.length !== expectedLength) {
+        return {
+            ok: false,
+            errorCode: 'entries_not_contiguous',
+            error: `entries must exactly cover [${fromSeq}, ${toSeq}] (${expectedLength} entries)`,
+            path: 'entries',
+        };
+    }
+    let finalIndex = -1;
+    for (let index = 0; index < raw.entries.length; index += 1) {
+        const entry = raw.entries[index];
+        const path = `entries[${index}]`;
+        if (!isRecord(entry))
+            return badRequest(`${path} must be an object`, path);
+        const expectedSeq = fromSeq + index;
+        if (entry.deliverySeq !== expectedSeq) {
+            return {
+                ok: false,
+                errorCode: 'entries_not_contiguous',
+                error: `${path}.deliverySeq must be ${expectedSeq}`,
+                path: `${path}.deliverySeq`,
+            };
+        }
+        if (entry.ingestSeq !== undefined && !isPositiveSafeInteger(entry.ingestSeq)) {
+            return badRequest(`${path}.ingestSeq must be a positive safe integer when present`, `${path}.ingestSeq`);
+        }
+        if (typeof entry.rawText !== 'string') {
+            return badRequest(`${path}.rawText must be a string`, `${path}.rawText`);
+        }
+        if (!isDeliveryKind(entry.kind)) {
+            return badRequest(`${path}.kind is not supported`, `${path}.kind`);
+        }
+        for (const field of ['itemVersionKey', 'contentHash', 'controlKey']) {
+            if (entry[field] !== undefined) {
+                const error = validateIdentifier(entry[field], `${path}.${field}`);
+                if (error)
+                    return error;
+            }
+        }
+        if (entry.kind === 'item') {
+            if (!isPositiveSafeInteger(entry.ingestSeq)) {
+                return badRequest(`${path}.ingestSeq is required for item entries`, `${path}.ingestSeq`);
+            }
+            for (const field of ['itemVersionKey', 'contentHash']) {
+                const error = validateIdentifier(entry[field], `${path}.${field}`);
+                if (error)
+                    return error;
+            }
+        }
+        if (entry.kind === 'gap') {
+            const gapError = validateGap(entry.gap, `${path}.gap`);
+            if (gapError)
+                return gapError;
+        }
+        else if (entry.gap !== undefined) {
+            return badRequest(`${path}.gap is only valid for gap entries`, `${path}.gap`);
+        }
+        if (entry.kind === 'control' || entry.kind === 'effect_result') {
+            const error = validateIdentifier(entry.controlKey, `${path}.controlKey`);
+            if (error)
+                return error;
+        }
+        else if (entry.controlKey !== undefined) {
+            return badRequest(`${path}.controlKey is only valid for control or effect_result entries`, `${path}.controlKey`);
+        }
+        if (entry.kind === 'final') {
+            if (finalIndex !== -1) {
+                return finalMismatch('a delivery batch may contain at most one final entry', `${path}.kind`);
+            }
+            finalIndex = index;
+        }
+    }
+    const final = raw.stream.final;
+    if (final && finalIndex !== raw.entries.length - 1) {
+        return finalMismatch('stream.final requires one final entry at the end of entries', 'stream.final');
+    }
+    if (!final && finalIndex !== -1) {
+        return finalMismatch('a final entry requires stream.final=true', `entries[${finalIndex}].kind`);
+    }
+    const request = raw;
+    const identity = deriveVcMeetingDeliveryIdentity(request);
+    if (request.stream.inputHash !== identity.inputHash) {
+        return {
+            ok: false,
+            errorCode: 'input_hash_mismatch',
+            error: 'stream.inputHash does not match the canonical delivery input',
+            path: 'stream.inputHash',
+            expectedInputHash: identity.inputHash,
+        };
+    }
+    return { ok: true, request, identity };
+}
+function validateGap(raw, path) {
+    if (!isRecord(raw))
+        return badRequest(`${path} is required for gap entries`, path);
+    if (!isGapReason(raw.reason)) {
+        return badRequest(`${path}.reason is not supported`, `${path}.reason`);
+    }
+    for (const field of ['occurredFromMs', 'occurredToMs']) {
+        if (raw[field] !== undefined
+            && (typeof raw[field] !== 'number' || !Number.isFinite(raw[field]) || raw[field] < 0)) {
+            return badRequest(`${path}.${field} must be a finite non-negative number`, `${path}.${field}`);
+        }
+    }
+    if (typeof raw.occurredFromMs === 'number'
+        && typeof raw.occurredToMs === 'number'
+        && raw.occurredFromMs > raw.occurredToMs) {
+        return badRequest(`${path}.occurredFromMs must be <= occurredToMs`, path);
+    }
+    for (const field of ['missingItemVersionKey', 'originalContentHash']) {
+        if (raw[field] !== undefined) {
+            const error = validateIdentifier(raw[field], `${path}.${field}`);
+            if (error)
+                return error;
+        }
+    }
+    return undefined;
+}
+function validateIdentifier(value, path) {
+    if (typeof value !== 'string' || value.length === 0 || value.trim() !== value) {
+        return badRequest(`${path} must be a non-empty string without surrounding whitespace`, path);
+    }
+    return undefined;
+}
+function badRequest(error, path) {
+    return { ok: false, errorCode: 'bad_request', error, ...(path ? { path } : {}) };
+}
+function badProjectionRequest(error, path) {
+    return { ok: false, errorCode: 'bad_request', error, ...(path ? { path } : {}) };
+}
+function finalMismatch(error, path) {
+    return { ok: false, errorCode: 'final_mismatch', error, path };
+}
+function isRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+function isPositiveSafeInteger(value) {
+    return typeof value === 'number' && Number.isSafeInteger(value) && value > 0;
+}
+function isDeliveryKind(value) {
+    return typeof value === 'string'
+        && VC_MEETING_DELIVERY_KINDS.includes(value);
+}
+function isGapReason(value) {
+    return typeof value === 'string'
+        && VC_MEETING_DELIVERY_GAP_REASONS.includes(value);
+}
+function assertDeliveryKeyString(value, field) {
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new Error(`deriveVcMeetingDeliveryKey: ${field} must be a non-empty string`);
+    }
+}
+function assertPositiveSafeInteger(value, field) {
+    if (!isPositiveSafeInteger(value)) {
+        throw new Error(`deriveVcMeetingDeliveryKey: ${field} must be a positive safe integer`);
+    }
+}
+//# sourceMappingURL=vc-meeting-delivery-protocol.js.map

package/dist/services/vc-meeting-delivery-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vc-meeting-delivery-protocol.js","sourceRoot":"","sources":["../../src/services/vc-meeting-delivery-protocol.ts"],"names":[],"mappings":"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"}

package/dist/services/vc-meeting-delivery-receiver.d.ts

@@ -0,0 +1,80 @@
+import type { WorkerToDaemon } from '../types.js';
+import type { TriggerRequest, TriggerResponse } from './trigger-types.js';
+import { type VcMeetingDeliveryRequest, type VcMeetingMemberProjectionRequest } from './vc-meeting-delivery-protocol.js';
+import { type VcMeetingAmbiguousReceiptRef } from './vc-meeting-delivery-store.js';
+export interface VcMeetingReceiverSessionBinding {
+    sessionId: string;
+    chatId: string;
+    agentAppId: string;
+    reliableTurnTerminal: boolean;
+}
+export interface VcMeetingDeliveryDispatchContext {
+    stableTurnId: string;
+    suppressFinalOutput: boolean;
+    beforeDispatch: (context: {
+        sessionId: string;
+        workerGeneration: number;
+    }) => {
+        dispatchAttempt: number;
+    };
+}
+export interface VcMeetingDeliveryReceiverDeps {
+    dataDir: string;
+    selfAppId: string;
+    receiverBootId: string;
+    /** Register creates/restores the receiver-owned session. The hub never gets
+     *  to choose a session id. */
+    ensureMemberSession: (request: VcMeetingMemberProjectionRequest, existingSessionId?: string) => Promise<VcMeetingReceiverSessionBinding>;
+    resolveSession: (sessionId: string) => VcMeetingReceiverSessionBinding | undefined;
+    dispatchTurn: (request: TriggerRequest, context: VcMeetingDeliveryDispatchContext) => Promise<TriggerResponse>;
+}
+export interface VcMeetingReceiverResult<T = unknown> {
+    status: number;
+    body: T;
+}
+export type VcMeetingDeliveryApiStatus = 'accepted' | 'dispatched' | 'completed' | 'duplicate' | 'failed_retryable' | 'failed_terminal' | 'ambiguous';
+export interface VcMeetingDeliveryReceiptBody {
+    ok: true;
+    status: VcMeetingDeliveryApiStatus;
+    memberEpoch: number;
+    receiverCommittedThrough: number;
+    deliveryKey: string;
+    stableTurnId: string;
+    receiverSessionId: string;
+    receiverBootId: string;
+    workerGeneration: number;
+    dispatchAttempt: number;
+    errorCode?: string;
+}
+export declare function registerVcMeetingMember(raw: unknown, deps: VcMeetingDeliveryReceiverDeps): Promise<VcMeetingReceiverResult>;
+export declare function buildVcMeetingDeliveryTriggerRequest(request: VcMeetingDeliveryRequest, deliveryKey?: string, responseMode?: 'silent' | 'listener_thread', configuredInstructions?: string): TriggerRequest;
+export declare function receiveVcMeetingDelivery(raw: unknown, deps: VcMeetingDeliveryReceiverDeps): Promise<VcMeetingReceiverResult>;
+/**
+ * Operator control: authorize one dispatch beyond the automatic retry budget.
+ * The hub must re-send the same frozen envelope after a successful response.
+ */
+export declare function retryPoisonedVcMeetingDelivery(deliveryKey: string, deps: Pick<VcMeetingDeliveryReceiverDeps, 'dataDir' | 'selfAppId'>): VcMeetingReceiverResult;
+/** Operator control: retire the poisoned epoch without advancing its cursor. */
+export declare function abandonPoisonedVcMeetingDelivery(deliveryKey: string, reason: string | undefined, deps: Pick<VcMeetingDeliveryReceiverDeps, 'dataDir' | 'selfAppId'>): VcMeetingReceiverResult;
+export declare function getVcMeetingDeliveryStatus(deliveryKey: string, deps: Pick<VcMeetingDeliveryReceiverDeps, 'dataDir' | 'selfAppId'>): VcMeetingReceiverResult;
+export declare function handleVcMeetingTurnTerminal(terminal: Extract<WorkerToDaemon, {
+    type: 'turn_terminal';
+}>, context: {
+    workerGeneration: number;
+}, deps: Pick<VcMeetingDeliveryReceiverDeps, 'dataDir' | 'selfAppId'>): {
+    handled: boolean;
+    reason?: string;
+    receipt?: VcMeetingDeliveryReceiptBody;
+};
+/** Reconcile both Node-worker exits and managed CLI exits. Only receipts
+ *  dispatched to the exact captured generation/attempt are changed; a stale
+ *  takeover worker cannot poison a newer attempt. Retry scheduling is left to
+ *  the stream pump so this callback never sends into a dying worker. */
+export declare function handleVcMeetingWorkerGenerationExit(context: {
+    sessionId: string;
+    workerGeneration: number;
+}, deps: Pick<VcMeetingDeliveryReceiverDeps, 'dataDir' | 'selfAppId'>): {
+    ambiguousDeliveryKeys: string[];
+    recoveryRefs: VcMeetingAmbiguousReceiptRef[];
+};
+//# sourceMappingURL=vc-meeting-delivery-receiver.d.ts.map

package/dist/services/vc-meeting-delivery-receiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vc-meeting-delivery-receiver.d.ts","sourceRoot":"","sources":["../../src/services/vc-meeting-delivery-receiver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAIL,KAAK,wBAAwB,EAC7B,KAAK,gCAAgC,EACtC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAeL,KAAK,4BAA4B,EAElC,MAAM,gCAAgC,CAAC;AAKxC,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,gCAAgC;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,CACd,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,KACrD;QAAE,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;CAClC;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB;kCAC8B;IAC9B,mBAAmB,EAAE,CACnB,OAAO,EAAE,gCAAgC,EACzC,iBAAiB,CAAC,EAAE,MAAM,KACvB,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAC9C,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,+BAA+B,GAAG,SAAS,CAAC;IACnF,YAAY,EAAE,CACZ,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,gCAAgC,KACtC,OAAO,CAAC,eAAe,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC,GAAG,OAAO;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,MAAM,0BAA0B,GAClC,UAAU,GACV,YAAY,GACZ,WAAW,GACX,WAAW,GACX,kBAAkB,GAClB,iBAAiB,GACjB,WAAW,CAAC;AAEhB,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,0BAA0B,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB,EAAE,MAAM,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA0DD,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,6BAA6B,GAClC,OAAO,CAAC,uBAAuB,CAAC,CAuFlC;AAeD,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,wBAAwB,EACjC,WAAW,SAAuD,EAClE,YAAY,GAAE,QAAQ,GAAG,iBAAqC,EAC9D,sBAAsB,CAAC,EAAE,MAAM,GAC9B,cAAc,CAyDhB;AAwHD,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,6BAA6B,GAClC,OAAO,CAAC,uBAAuB,CAAC,CA+FlC;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,IAAI,CAAC,6BAA6B,EAAE,SAAS,GAAG,WAAW,CAAC,GACjE,uBAAuB,CA0BzB;AAED,gFAAgF;AAChF,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,IAAI,CAAC,6BAA6B,EAAE,SAAS,GAAG,WAAW,CAAC,GACjE,uBAAuB,CAmBzB;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,IAAI,CAAC,6BAA6B,EAAE,SAAS,GAAG,WAAW,CAAC,GACjE,uBAAuB,CAUzB;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,OAAO,CAAC,cAAc,EAAE;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC,EAC5D,OAAO,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAA;CAAE,EACrC,IAAI,EAAE,IAAI,CAAC,6BAA6B,EAAE,SAAS,GAAG,WAAW,CAAC,GACjE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,4BAA4B,CAAA;CAAE,CA6C/E;AAED;;;wEAGwE;AACxE,wBAAgB,mCAAmC,CACjD,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,EACxD,IAAI,EAAE,IAAI,CAAC,6BAA6B,EAAE,SAAS,GAAG,WAAW,CAAC,GACjE;IAAE,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,4BAA4B,EAAE,CAAA;CAAE,CAoCnF"}