botmux 2.111.0 → 2.112.0

package/dist/services/vc-meeting-im-reply.js

@@ -0,0 +1,279 @@
+import { beginVcMeetingAction, claimVcMeetingActionAttempt, finishVcMeetingAction, } from './vc-meeting-action-store.js';
+import { deriveVcMeetingImTurnSourceKey } from './vc-meeting-action-gate.js';
+import { findVcMeetingDeliveryByKey, getVcMeetingMemberProjection, } from './vc-meeting-delivery-store.js';
+import { isCurrentVcMeetingImTurnOrigin } from './vc-meeting-send-policy.js';
+// Lark message UUIDs deduplicate for one hour. Keep the same five-minute
+// clock/network margin as managed meeting_text: after this point an ambiguous
+// provider result must be reviewed manually, never blindly reissued.
+export const VC_MEETING_LISTENER_PROVIDER_DEDUP_SAFE_MS = 55 * 60_000;
+function refFor(record) {
+    return {
+        listenerAppId: record.listenerAppId,
+        meetingId: record.meetingId,
+        actionId: record.actionId,
+        inputHash: record.inputHash,
+    };
+}
+function nonEmpty(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function canonicalOutputFromRecord(record) {
+    const value = record.canonicalInput;
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const output = value;
+    if (!nonEmpty(output.targetChatId)
+        || !nonEmpty(output.msgType)
+        || !nonEmpty(output.content)
+        || (output.quoteTargetId !== undefined && !nonEmpty(output.quoteTargetId)))
+        return undefined;
+    return {
+        targetChatId: output.targetChatId,
+        ...(typeof output.quoteTargetId === 'string'
+            ? { quoteTargetId: output.quoteTargetId }
+            : {}),
+        msgType: output.msgType,
+        content: output.content,
+    };
+}
+export function prepareVcMeetingImReply(dataDir, origin, canonicalOutput, now = Date.now()) {
+    if (!origin
+        || !nonEmpty(origin.listenerAppId)
+        || !nonEmpty(origin.meetingId)
+        || !nonEmpty(origin.memberId)
+        || !nonEmpty(origin.agentAppId)
+        || !nonEmpty(origin.receiverSessionId)
+        || !nonEmpty(origin.larkMessageId)
+        || !Number.isSafeInteger(origin.memberEpoch)
+        || origin.memberEpoch < 1
+        || !Number.isSafeInteger(origin.sinkOwnerGeneration)
+        || origin.sinkOwnerGeneration < 1
+        || !nonEmpty(canonicalOutput.targetChatId)
+        || !nonEmpty(canonicalOutput.msgType)
+        || !nonEmpty(canonicalOutput.content)) {
+        return { kind: 'conflict', reason: 'invalid_origin', detail: 'IM reply origin/output is invalid' };
+    }
+    if (!isCurrentVcMeetingImTurnOrigin(dataDir, origin, canonicalOutput.targetChatId)) {
+        return {
+            kind: 'conflict',
+            reason: 'invalid_origin',
+            detail: 'IM reply membership is no longer active/current',
+        };
+    }
+    const sourceKey = deriveVcMeetingImTurnSourceKey(origin.receiverSessionId, origin.larkMessageId);
+    const begun = beginVcMeetingAction(dataDir, {
+        listenerAppId: origin.listenerAppId,
+        meetingId: origin.meetingId,
+        memberId: origin.memberId,
+        memberEpoch: origin.memberEpoch,
+        agentAppId: origin.agentAppId,
+        ownerGeneration: origin.sinkOwnerGeneration,
+        source: {
+            kind: 'im_turn',
+            key: sourceKey,
+            larkMessageId: origin.larkMessageId,
+        },
+        // `listener_chat + primary` is the deterministic assistant_reply slot for
+        // explicit IM turns. Managed meeting text/voice actions use other sinks.
+        sink: 'listener_chat',
+        actionSlot: 'primary',
+        canonicalInput: canonicalOutput,
+    }, now);
+    if (begun.kind === 'conflict') {
+        if (begun.reason === 'input_mismatch' && begun.record) {
+            const record = begun.record;
+            const firstOutput = canonicalOutputFromRecord(record);
+            if (!firstOutput
+                || !isCurrentVcMeetingImTurnOrigin(dataDir, origin, firstOutput.targetChatId)) {
+                return {
+                    kind: 'conflict',
+                    reason: firstOutput ? 'invalid_origin' : 'invalid_state',
+                    detail: firstOutput
+                        ? 'IM reply membership is no longer active/current'
+                        : 'the first IM reply output is invalid',
+                };
+            }
+            return prepareExistingVcMeetingListenerReply(dataDir, record, firstOutput, true, now);
+        }
+        return {
+            kind: 'conflict',
+            reason: 'invalid_origin',
+            detail: begun.detail ?? begun.reason,
+        };
+    }
+    const record = begun.record;
+    const firstOutput = canonicalOutputFromRecord(record);
+    if (!firstOutput) {
+        return { kind: 'conflict', reason: 'invalid_state', detail: 'the first IM reply output is invalid' };
+    }
+    return prepareExistingVcMeetingListenerReply(dataDir, record, firstOutput, false, now, begun.kind === 'existing');
+}
+/**
+ * Durable identity for the automatic listener-thread reply of one delivery.
+ * The identity is the stable delivery key (not dispatchAttempt), so a crash
+ * replay reuses the same provider UUID and first canonical output.
+ */
+export function prepareVcMeetingDeliveryReply(dataDir, origin, canonicalOutput, now = Date.now()) {
+    if (!nonEmpty(origin.receiverSessionId)
+        || !nonEmpty(origin.stableTurnId)
+        || !Number.isSafeInteger(origin.dispatchAttempt)
+        || origin.dispatchAttempt < 1
+        || !nonEmpty(canonicalOutput.targetChatId)
+        || !nonEmpty(canonicalOutput.msgType)
+        || !nonEmpty(canonicalOutput.content)) {
+        return { kind: 'conflict', reason: 'invalid_origin', detail: 'delivery reply origin/output is invalid' };
+    }
+    const lookup = findVcMeetingDeliveryByKey(dataDir, origin.stableTurnId, {
+        receiverSessionId: origin.receiverSessionId,
+    });
+    if (!lookup
+        || lookup.receipt.stableTurnId !== origin.stableTurnId
+        || lookup.receipt.dispatchAttempt !== origin.dispatchAttempt
+        || !['dispatched', 'completed'].includes(lookup.receipt.status)
+        || lookup.receipt.responseMode !== 'listener_thread'
+        || !Number.isSafeInteger(lookup.receipt.sinkOwnerGeneration)
+        || (lookup.receipt.sinkOwnerGeneration ?? 0) < 1) {
+        return { kind: 'conflict', reason: 'invalid_origin', detail: 'delivery reply receipt is stale or not listener-visible' };
+    }
+    const projection = getVcMeetingMemberProjection(dataDir, lookup.memberKey);
+    if (!projection
+        || projection.status !== 'active'
+        || projection.receiverSessionId !== origin.receiverSessionId
+        || projection.outputChatId !== canonicalOutput.targetChatId
+        || projection.sinkOwnerGeneration !== lookup.receipt.sinkOwnerGeneration) {
+        return { kind: 'conflict', reason: 'invalid_origin', detail: 'delivery reply membership is no longer active/current' };
+    }
+    const begun = beginVcMeetingAction(dataDir, {
+        ...lookup.memberKey,
+        agentAppId: projection.agentAppId,
+        ownerGeneration: lookup.receipt.sinkOwnerGeneration,
+        source: {
+            kind: 'delivery',
+            key: lookup.receipt.deliveryKey,
+            deliverySeq: lookup.receipt.toSeq,
+        },
+        sink: 'listener_chat',
+        actionSlot: 'primary',
+        canonicalInput: canonicalOutput,
+    }, now);
+    if (begun.kind === 'conflict') {
+        if (begun.reason === 'input_mismatch' && begun.record) {
+            const firstOutput = canonicalOutputFromRecord(begun.record);
+            if (!firstOutput || firstOutput.targetChatId !== projection.outputChatId) {
+                return {
+                    kind: 'conflict',
+                    reason: firstOutput ? 'invalid_origin' : 'invalid_state',
+                    detail: firstOutput
+                        ? 'the first delivery reply target is no longer current'
+                        : 'the first delivery reply output is invalid',
+                };
+            }
+            return prepareExistingVcMeetingListenerReply(dataDir, begun.record, firstOutput, true, now);
+        }
+        return {
+            kind: 'conflict',
+            reason: begun.reason === 'input_mismatch' ? 'output_mismatch' : 'invalid_origin',
+            detail: begun.detail ?? begun.reason,
+        };
+    }
+    const firstOutput = canonicalOutputFromRecord(begun.record);
+    if (!firstOutput) {
+        return { kind: 'conflict', reason: 'invalid_state', detail: 'the first delivery reply output is invalid' };
+    }
+    return prepareExistingVcMeetingListenerReply(dataDir, begun.record, firstOutput, false, now, begun.kind === 'existing');
+}
+function prepareExistingVcMeetingListenerReply(dataDir, record, canonicalOutput, outputMismatch, now, exactReplay = true) {
+    const providerReplayIsSafe = record.attemptedAt !== undefined
+        && now >= record.attemptedAt
+        && now - record.attemptedAt <= VC_MEETING_LISTENER_PROVIDER_DEDUP_SAFE_MS;
+    if (record.status === 'succeeded') {
+        const messageId = typeof record.externalRefs?.messageId === 'string'
+            ? record.externalRefs.messageId
+            : undefined;
+        if (!messageId && !providerReplayIsSafe) {
+            return {
+                kind: 'conflict',
+                reason: 'invalid_state',
+                detail: 'IM assistant reply succeeded without a provider message id and its idempotency window expired; manual review required',
+            };
+        }
+        return {
+            kind: 'succeeded',
+            providerKey: record.providerKey,
+            ref: refFor(record),
+            ...(messageId ? { messageId } : {}),
+            providerReplay: true,
+            canonicalOutput,
+            outputMismatch,
+        };
+    }
+    if (record.status === 'requested') {
+        const claimed = claimVcMeetingActionAttempt(dataDir, refFor(record), now);
+        if (claimed.kind === 'conflict') {
+            return { kind: 'conflict', reason: 'invalid_state', detail: claimed.reason };
+        }
+        return {
+            kind: 'send',
+            providerKey: claimed.record.providerKey,
+            ref: refFor(claimed.record),
+            replay: exactReplay || outputMismatch,
+            providerReplay: false,
+            canonicalOutput,
+            outputMismatch,
+        };
+    }
+    if (record.status === 'attempting' && providerReplayIsSafe) {
+        // The prior process may have died after Lark accepted the UUID. Reissuing
+        // the same provider key is safe only while Lark's UUID window is active.
+        return {
+            kind: 'send',
+            providerKey: record.providerKey,
+            ref: refFor(record),
+            replay: true,
+            providerReplay: true,
+            canonicalOutput,
+            outputMismatch,
+        };
+    }
+    if (record.status === 'attempting') {
+        const terminal = finishVcMeetingAction(dataDir, refFor(record), {
+            status: 'unknown',
+            errorCode: 'provider_idempotency_window_expired',
+            externalRefs: { providerKey: record.providerKey },
+        }, now);
+        if (terminal.kind === 'conflict') {
+            return {
+                kind: 'conflict',
+                reason: 'invalid_state',
+                detail: `failed to terminalize expired IM assistant reply: ${terminal.reason}`,
+            };
+        }
+        return {
+            kind: 'conflict',
+            reason: 'invalid_state',
+            detail: 'IM assistant reply provider result is ambiguous and its idempotency window expired; manual review required',
+        };
+    }
+    if (record.status === 'unknown') {
+        return {
+            kind: 'conflict',
+            reason: 'invalid_state',
+            detail: 'IM assistant reply provider result is unknown; manual review required',
+        };
+    }
+    return {
+        kind: 'conflict',
+        reason: 'invalid_state',
+        detail: `IM assistant reply is already ${record.status}`,
+    };
+}
+export function finishVcMeetingImReply(dataDir, ref, messageId, now = Date.now()) {
+    const finished = finishVcMeetingAction(dataDir, ref, {
+        status: 'succeeded',
+        externalRefs: { messageId },
+    }, now);
+    if (finished.kind === 'conflict') {
+        throw new Error(`failed to finish IM assistant reply: ${finished.reason}`);
+    }
+}
+//# sourceMappingURL=vc-meeting-im-reply.js.map

package/dist/services/vc-meeting-im-reply.js.map

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

package/dist/services/vc-meeting-im-routing.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Durable listener-chat -> receiver-session routing for explicit human IM turns.
+ *
+ * This module deliberately does not inspect daemon memory. A receiver session is
+ * routable only when both durable sources agree:
+ *
+ * 1. the runtime meeting record still selects this agent as active; and
+ * 2. the latest receiver projection for that selected member is active and is
+ *    bound to the same listener chat / agent.
+ *
+ * Keeping selection pure and deterministic is important here: `updatedAt` is
+ * never a tie-breaker. Multiple active meetings require an explicit quote or
+ * meeting reference, otherwise callers must show a disambiguation UI.
+ */
+export declare const DEFAULT_VC_MEETING_IM_CATCH_UP_TIMEOUT_MS = 8000;
+export declare const MAX_VC_MEETING_IM_CATCH_UP_TIMEOUT_MS = 30000;
+/** Match the historical runtime-route retention window. After this horizon a
+ * deliberately still-open receiver no longer captures ordinary chat turns. */
+export declare const DEFAULT_VC_MEETING_SEALED_IM_ROUTE_TTL_MS: number;
+export interface VcMeetingSealedReceiverSessionBinding {
+    listenerAppId: string;
+    listenerChatId: string;
+    meetingId: string;
+    memberId: string;
+    memberEpoch: number;
+    agentAppId: string;
+    receiverSessionId: string;
+}
+export interface VcMeetingImRoutingCandidate {
+    lifecycle: 'active' | 'sealed';
+    listenerAppId: string;
+    listenerChatId: string;
+    meetingId: string;
+    meetingNo?: string;
+    topic?: string;
+    memberId: string;
+    memberEpoch: number;
+    ownerBootId: string;
+    ownerEpoch: number;
+    membershipGeneration: number;
+    sinkOwnerGeneration: number;
+    agentAppId: string;
+    receiverSessionId: string;
+    responseMode: 'silent' | 'listener_thread';
+    /**
+     * Durable listener messages that unambiguously belong to this meeting.
+     * This combines the runtime consumer card with the bounded primary-output
+     * ledger maintained by meeting receiver send paths.
+     */
+    knownListenerMessageIds: string[];
+}
+export interface VcMeetingImDisambiguation {
+    /** Raw Lark parent_id. It is matched only against known listener messages. */
+    quotedMessageId?: string;
+    /** Meeting id resolved by a durable listener-message index. */
+    quotedMeetingId?: string;
+    /** Explicit meeting id / meeting number extracted by the caller. */
+    explicitMeetingId?: string;
+    /** Raw mention-stripped IM text; exact candidate ids/numbers are detected. */
+    messageText?: string;
+}
+export type VcMeetingImCatchUpStatus = 'not_attempted' | 'succeeded' | 'failed' | 'timed_out';
+export type VcMeetingImRoutingResult = {
+    kind: 'ordinary';
+    reason: 'no_active_membership';
+    candidates: [];
+} | {
+    kind: 'receiver';
+    selectedBy: 'only_active' | 'only_sealed' | 'quote' | 'meeting_reference';
+    candidate: VcMeetingImRoutingCandidate;
+    /** Fail-honest default until bounded catch-up proves the stream current. */
+    meetingContextMayLag: boolean;
+    catchUpStatus: VcMeetingImCatchUpStatus;
+    catchUpError?: string;
+} | {
+    kind: 'ambiguous';
+    reason: 'multiple_active' | 'multiple_sealed' | 'reference_not_found' | 'reference_not_unique' | 'conflicting_references';
+    candidates: VcMeetingImRoutingCandidate[];
+};
+export interface VcMeetingImCatchUpResult {
+    ok: boolean;
+    error?: string;
+}
+export type VcMeetingImCatchUp = (candidate: VcMeetingImRoutingCandidate, context: {
+    signal: AbortSignal;
+}) => Promise<boolean | VcMeetingImCatchUpResult>;
+/**
+ * Load durable active memberships for one listener chat and one addressed bot.
+ * Runtime-only or projection-only residue is intentionally not routable.
+ */
+export declare function listDurableVcMeetingImRoutingCandidates(dataDir: string, input: {
+    listenerChatId: string;
+    agentAppId: string;
+}, now?: number): VcMeetingImRoutingCandidate[];
+/**
+ * Reconstruct a post-meeting route from three independent durable facts:
+ *
+ * 1. the dedicated botmux Session is still active (supplied by its owner);
+ * 2. its latest receiver projection still matches the exact member epoch; and
+ * 3. the hub has durably closed that meeting after this member final-ACKed.
+ *
+ * This is intentionally a fallback, not a replacement for live runtime
+ * selection. A stale projection or an ended tombstone alone can never capture
+ * an ordinary chat turn.
+ */
+export declare function listSealedVcMeetingImRoutingCandidates(dataDir: string, input: {
+    listenerChatId: string;
+    agentAppId: string;
+    receiverSessions: readonly VcMeetingSealedReceiverSessionBinding[];
+}, now?: number, ttlMs?: number): VcMeetingImRoutingCandidate[];
+/**
+ * Deterministically select a receiver session. Multiple candidates are never
+ * reduced by recency or array order.
+ */
+export declare function selectVcMeetingImRoutingCandidate(inputCandidates: readonly VcMeetingImRoutingCandidate[], disambiguation?: VcMeetingImDisambiguation): VcMeetingImRoutingResult;
+/** Convenience loader + pure selector used by daemon routing. */
+export declare function resolveDurableVcMeetingImRouting(dataDir: string, input: {
+    listenerChatId: string;
+    agentAppId: string;
+    disambiguation?: VcMeetingImDisambiguation;
+    /** Active, dedicated Session bindings owned by this agent daemon. Used
+     * only when no live runtime membership exists. */
+    sealedReceiverSessions?: readonly VcMeetingSealedReceiverSessionBinding[];
+}, now?: number): VcMeetingImRoutingResult;
+/**
+ * Attempt the selected meeting's seal/wake catch-up within a strict budget.
+ * Failure and timeout still return the receiver route, but with the explicit
+ * `meetingContextMayLag=true` contract required by the IM prompt/turn metadata.
+ */
+export declare function runBoundedVcMeetingImCatchUp(route: VcMeetingImRoutingResult, catchUp: VcMeetingImCatchUp | undefined, timeoutMs?: number): Promise<VcMeetingImRoutingResult>;
+//# sourceMappingURL=vc-meeting-im-routing.d.ts.map

package/dist/services/vc-meeting-im-routing.d.ts.map

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