Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active
TypeScript aianthropicartifactsawsazurechatgptchatgpt-cloneclaudeclonedeepseekgeminigooglegpt-5librechatmcpo1openairesponses-apivisionwebui
import { useCallback, useMemo } from 'react';
import { useStore } from 'jotai';
import type { QueuedTurnReceipts } from './receipts';
import type { QueuedMessage } from '../../core';
import type { QueueRows } from './rows';
import { blockRecovery, canRestoreRecovery, recoveryDisposition } from '../../core';
import { recoveryDispositionsFamily } from '../steer/recovery';
import { revealedQueuedTurnFamily } from '../steer/atoms';
import { useSteerHost } from '../steer/host';
export interface QueuedRecovery {
discardQueued: (item: QueuedMessage) => Promise<boolean>;
dismissRecovery: (item: QueuedMessage) => void;
}
/** Lets go of a queued row's server copy (a durable queued turn or a parked
* steer receipt) before the row is edited, removed or sent another way. */
export default function useQueuedRecovery({
queueKey,
conversationId,
hasRealConvoId,
applyQueuedTurnReceipts,
downgradeServerQueuedTurn,
removeQueued,
}: {
queueKey: string;
conversationId: string;
hasRealConvoId: boolean;
applyQueuedTurnReceipts: QueuedTurnReceipts['applyQueuedTurnReceipts'];
downgradeServerQueuedTurn: QueueRows['downgradeServerQueuedTurn'];
removeQueued: QueueRows['removeQueued'];
}): QueuedRecovery {
const host = useSteerHost();
const localize = host.useLocalize();
const jotaiStore = useStore();
const notify = host.useNotify();
const cancelSteer = host.useCancelSteer();
const cancelAgentQueuedTurn = host.useCancelQueuedTurn();
/** Settle a queued row's terminal recovery source before an Edit/Remove.
* Ordinary rows have no server copy. A v2 leftover first uses its durable
* receipt to atomically discard the parked copy, then becomes an ordinary
* local row; the caller decides whether the live composer can consume it.
* The cancel deliberately omits the active epoch: the receipt belongs to the
* terminal source generation, not whichever run now occupies the chat. */
const discardQueued = useCallback(
async (item: QueuedMessage): Promise<boolean> => {
if (item.server != null) {
if (item.server.status === 'rejected' && item.server.id == null) {
return downgradeServerQueuedTurn(item.id);
}
if (item.server.id == null || !hasRealConvoId) {
notify({
message: localize('com_ui_steer_cancel_failed'),
status: 'error',
});
return false;
}
try {
const receipt = await cancelAgentQueuedTurn({
conversationId,
queuedTurnId: item.server.id,
});
if (receipt.status !== 'cancelled') {
notify({
message: localize('com_ui_steer_cancel_failed'),
status: 'error',
});
return false;
}
applyQueuedTurnReceipts([receipt], 'direct');
/** The turn was shown as next; the confirmed cancellation ends that
* at once rather than on the next receipt refetch. */
const revealFamily = revealedQueuedTurnFamily(queueKey);
if (jotaiStore.get(revealFamily)?.clientRequestId === item.clientRequestId) {
jotaiStore.set(revealFamily, null);
}
return downgradeServerQueuedTurn(item.id);
} catch {
notify({
message: localize('com_ui_steer_cancel_failed'),
status: 'error',
});
return false;
}
}
if (item.recoverySteerId == null) {
return true;
}
if (item.recoveryClientSteerId == null || !hasRealConvoId) {
jotaiStore.set(recoveryDispositionsFamily(queueKey), (previous) =>
blockRecovery(previous, item.recoverySteerId!),
);
notify({
message: localize('com_ui_steer_cancel_failed'),
status: 'error',
});
return false;
}
const dispositions = recoveryDispositionsFamily(queueKey);
const disposition = recoveryDisposition(jotaiStore.get(dispositions), item);
if (disposition === 'cancelled') {
return true;
}
if (disposition === 'cancelling') {
return false;
}
if (!canRestoreRecovery(jotaiStore.get(dispositions), item)) {
return false;
}
const steerId = item.recoverySteerId;
jotaiStore.set(dispositions, (previous) => ({ ...previous, [steerId]: 'cancelling' }));
try {
const { removed } = await cancelSteer({
conversationId,
steerId,
clientSteerId: item.recoveryClientSteerId,
});
if (removed !== true) {
notify({
message: localize('com_ui_steer_cancel_failed'),
status: 'error',
});
return false;
}
jotaiStore.set(dispositions, (previous) => ({ ...previous, [steerId]: 'cancelled' }));
// Keep the binding held until the caller's guarded Edit/Remove succeeds.
// A newer composer draft must not turn cancelled words into an auto-send.
return true;
} catch {
notify({
message: localize('com_ui_steer_cancel_failed'),
status: 'error',
});
return false;
} finally {
jotaiStore.set(dispositions, (previous) =>
previous[steerId] === 'cancelling' ? { ...previous, [steerId]: 'blocked' } : previous,
);
}
},
[
cancelSteer,
cancelAgentQueuedTurn,
applyQueuedTurnReceipts,
conversationId,
downgradeServerQueuedTurn,
hasRealConvoId,
localize,
notify,
jotaiStore,
queueKey,
],
);
const dismissRecovery = useCallback(
(item: QueuedMessage) => {
const dispositions = recoveryDispositionsFamily(queueKey);
if (
item.recoverySteerId == null ||
!['blocked', 'cancelled'].includes(
recoveryDisposition(jotaiStore.get(dispositions), item) ?? '',
)
) {
return;
}
const steerId = item.recoverySteerId;
jotaiStore.set(dispositions, (previous) => ({ ...previous, [steerId]: 'dismissed' }));
removeQueued(item.id);
},
[jotaiStore, queueKey, removeQueued],
);
return useMemo(
() => ({
discardQueued,
dismissRecovery,
}),
[discardQueued, dismissRecovery],
);
}