Files
quality_analyse/web/src/analysisSubmission.ts
T

42 lines
2.1 KiB
TypeScript

import { createRequestUuid } from './requestUuid.ts';
type Context = Record<string, unknown> | 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 = () => createRequestUuid()): 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;
}