type Context = Record | undefined; export type SubmissionInput = { sessionId: string; question: string; context?: Context; generation: number }; export type AnalysisSubmission = SubmissionInput & { idempotencyKey: string; contextKey: string; inFlight: boolean; turnRequestStarted: boolean; uncertain: boolean; cancelRequested: boolean; acceptedTurnId?: string; }; function canonical(value: unknown): string { if (Array.isArray(value)) return `[${value.map(canonical).join(',')}]`; if (value && typeof value === 'object') return `{${Object.entries(value).sort(([a], [b]) => a.localeCompare(b)).map(([key, item]) => `${JSON.stringify(key)}:${canonical(item)}`).join(',')}}`; return JSON.stringify(value ?? null); } /** Only an uncertain retry of the same question, session and frozen context reuses its key. */ export function beginAnalysisSubmission(previous: AnalysisSubmission | null, input: SubmissionInput, key: () => string = () => crypto.randomUUID()): AnalysisSubmission { const contextKey = canonical(input.context || {}); if (previous?.uncertain && previous.generation === input.generation && previous.sessionId === input.sessionId && previous.question === input.question && previous.contextKey === contextKey) { previous.inFlight = true; return previous; } return { ...input, contextKey, idempotencyKey: key(), inFlight: true, turnRequestStarted: false, uncertain: false, cancelRequested: false }; } /** A connection failure, server timeout or 5xx does not prove that a POST was rejected. */ export function submissionOutcomeUnknown(error: unknown): boolean { const status = error && typeof error === 'object' && 'status' in error ? Number(error.status) : NaN; return !Number.isFinite(status) || status < 400 || status === 408 || status >= 500; } export function requestSubmissionCancellation(attempt: AnalysisSubmission | null, generation: number): boolean { if (!attempt || !attempt.inFlight || attempt.generation !== generation) return false; attempt.cancelRequested = true; return true; }