LibreChat/api/server/services/Endpoints/agents/backgroundCompletion.js
lia-by-librechat[bot] f88f3fb2fe
🪇 perf: Coalesce Ready Background Completions (#16650)
* 🪇 perf: Coalesce Ready Background Completions

* fix: Recover Receipt Batches and Gate Rolling Deploys

* fix: Fence Background Batch Handoffs and Cleanup Epochs

* fix: Bind Resumed Cleanup to Its Observed Batch

* fix: Preserve Background Results Through Recovery Handoffs

* fix: Recover Unconfirmed Manual Background Claims

* fix: Fence Automatic Recovery of Manual Handoffs

* fix: Preserve Background Reconciliation and Recovery Retention

* fix: Preserve Replayed Claims and Finish Follower Proofs

* fix: Recover Stale Background Projection Epochs

---------

Co-authored-by: Lia <lia@librechat.ai>
2026-10-02 15:03:22 -04:00

71 lines
2.3 KiB
JavaScript

const {
createBackgroundToolCompletionWakeupHandler,
GenerationJobManager,
createBackgroundToolDeadClaimRecovery,
createPendingBackgroundCompletions,
createBackgroundToolResultHandler,
claimBackgroundToolResult: claimResult,
} = require('@librechat/api');
const {
listPendingAgentBackgroundToolCompletions,
getAgentBackgroundToolResultBatch,
confirmAgentBackgroundToolResultBatch,
listUndeliveredAgentTriggerTaskIds,
} = require('~/models');
const {
enqueueAgentTrigger,
persistAgentBackgroundToolResult,
getAgentBackgroundToolResultClaim,
getBackgroundCompletionReceiptBatching,
releaseAgentBackgroundToolResultClaims,
renewAgentTriggerProducerLease,
retireAgentTrigger,
expediteCompletionWakeups,
} = require('../../Agents/triggers');
const preregisterBackgroundToolCompletion = createBackgroundToolCompletionWakeupHandler(
enqueueAgentTrigger,
retireAgentTrigger,
renewAgentTriggerProducerLease,
(deliveryKey, sourceId, result) =>
persistAgentBackgroundToolResult({ deliveryKey, sourceId, result }),
(deliveryKey) => expediteCompletionWakeups({ deliveryKeys: [deliveryKey] }),
getBackgroundCompletionReceiptBatching,
);
const pendingBackgroundToolCompletions = createPendingBackgroundCompletions({
list: listPendingAgentBackgroundToolCompletions,
listTaskIds: listUndeliveredAgentTriggerTaskIds,
retire: retireAgentTrigger,
});
function createBackgroundToolResultPersistence({ req, updateToolCallResult }) {
return createBackgroundToolResultHandler({ req, updateToolCallResult });
}
const claimBackgroundToolResult = (db, input) =>
claimResult(db, getAgentBackgroundToolResultClaim, input);
function createDeadBackgroundToolClaimRecovery(
releaseBackgroundToolResultClaims,
getGenerationJob,
fenceGenerationClaim,
) {
return createBackgroundToolDeadClaimRecovery(
retireAgentTrigger,
releaseBackgroundToolResultClaims,
getGenerationJob,
fenceGenerationClaim,
releaseAgentBackgroundToolResultClaims,
{ getAgentBackgroundToolResultBatch, confirmAgentBackgroundToolResultBatch },
(...args) => GenerationJobManager.getGenerationAdmissionEvidence(...args),
);
}
module.exports = {
preregisterBackgroundToolCompletion,
pendingBackgroundToolCompletions,
createBackgroundToolResultPersistence,
claimBackgroundToolResult,
createDeadBackgroundToolClaimRecovery,
};