import {z} from 'zod' export type StartSelfStudyRequest = {auto_correct_question_ids?: (Array | null) | undefined}; export type CreateApiKnowledgeQuizMyCoursesCourseIdStartArgs = {course_id: string, body: StartSelfStudyRequest | null}; export type CreateApiKnowledgeQuizMyCoursesCourseIdStartOptions = {baseUrl: string, OAuth2PasswordBearer?: string | undefined, fetch?: typeof fetch | undefined}; export const aIAuthor = z.object({type: z.literal("ai").optional(), prompt_id: z.string(), model: z.string().nullable().optional()}); export const humanAuthor = z.object({type: z.literal("human").optional(), user_id: z.string()}); export const textSpan = z.object({block_id: z.string(), start: z.number().int(), end: z.number().int()}); export const evidenceSpan = z.object({excerpt: z.string(), span: textSpan}); export const skillOutcome = z.object({savoir_faire_id: z.string(), outcome: z.enum(["correct", "partial", "wrong", "unanswered"]), note: z.string(), evidence: z.array(evidenceSpan)}); export const criterionOutcome = z.object({criterion_index: z.number().int(), outcome: z.enum(["correct", "partial", "wrong", "unanswered"]), note: z.string(), evidence: z.array(evidenceSpan), student_label: z.string().nullable().optional(), student_note: z.string().nullable().optional()}); export const ruleEffect = z.object({text: z.string().nullable(), proposed_points: z.number().nullable(), ladder_score: z.number().int(), ladder_points: z.number(), points: z.number().nullable(), applied: z.boolean(), ignored_reason: z.enum(["no_teacher_rules", "no_rule_stated", "not_graded", "out_of_range"]).nullable().optional()}); export const questionOutcome = z.object({score: z.number().int(), unanswered: z.boolean().optional(), note: z.string(), evidence: z.array(evidenceSpan).optional(), alternative_method: z.boolean().optional(), teacher_points_awarded: z.number().nullable().optional(), rule_effect: ruleEffect.nullable().optional(), demand_states: z.array(z.enum(["established", "form_flaw", "partly_established", "started", "nothing"])).nullable().optional()}); export const errorCategory = z.enum(["CALCULATION", "NOTATION", "CONCEPT", "METHOD", "REASONING", "COMPLETENESS", "UNITS", "TRANSCRIPTION", "TASK", "LANGUAGE"]); export const flaggedError = z.object({description: z.string(), evidence: z.array(evidenceSpan), categories: z.array(errorCategory).nullable().optional()}); export const rubricQuestionEvaluation = z.object({skill_outcomes: z.array(skillOutcome), criterion_outcomes: z.array(criterionOutcome).optional(), question_outcome: questionOutcome.nullable().optional(), errors: z.array(flaggedError), carried_from_attempt: z.number().int().nullable().optional()}); export const photoBBox = z.object({photo_index: z.number().int(), x: z.number(), y: z.number(), width: z.number(), height: z.number()}); export const questionZone = z.object({question_indexes: z.array(z.number().int()), boxes: z.array(photoBBox)}); export const rubricEvaluation = z.object({rubric_id: z.string(), author: z.discriminatedUnion("type", [aIAuthor, humanAuthor]), feedback: z.string(), questions: z.array(rubricQuestionEvaluation), question_zones: z.array(questionZone).optional(), computed_grade: z.number(), max_grade: z.number(), evaluated_at: z.string(), carried_photo_urls: z.array(z.string()).optional(), copied_from_session_id: z.string().nullable().optional()}); export const quizAnswerRecord = z.object({question_id: z.string(), answer_type: z.enum(["choice", "open"]).optional(), selected_answer_index: z.number().int().nullable().optional(), is_correct: z.boolean().optional(), photo_urls: z.array(z.string()).optional(), grading_status: z.enum(["processing", "graded", "error", "rejected"]).nullable().optional(), grading_error: z.string().nullable().optional(), rubric_evaluation: rubricEvaluation.nullable().optional(), points_earned: z.number().optional(), points_max: z.number().optional(), sheet_verdict: z.enum(["correct", "partial", "wrong"]).nullable().optional()}); export const selfStudyAttemptResponse = z.object({id: z.string(), quiz_id: z.string(), user_id: z.string(), course_id: z.string(), status: z.string(), score_out_of_20: z.number(), correct_count: z.number().int(), total_questions: z.number().int(), attempt_number: z.number().int(), started_at: z.string(), completed_at: z.string().nullable().optional(), answers: z.array(quizAnswerRecord).optional()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Start Self Study Attempt * * POST /knowledge-quiz/my-courses/{course_id}/start */ export const createApiKnowledgeQuizMyCoursesCourseIdStart = async (args: CreateApiKnowledgeQuizMyCoursesCourseIdStartArgs, options: CreateApiKnowledgeQuizMyCoursesCourseIdStartOptions) => { const {baseUrl, fetch: fetchFn = fetch, OAuth2PasswordBearer} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (OAuth2PasswordBearer !== undefined) headers.set('authorization', `Bearer ${OAuth2PasswordBearer}`) const url = `${baseUrl.replace(/\/+$/, '')}/knowledge-quiz/my-courses/${encodeURIComponent(String(args.course_id))}/start${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers, body: JSON.stringify(args.body)}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(selfStudyAttemptResponse, await res.json()) };