@happyvertical/smrt-education 0.57.46 → 0.57.47

package/dist/ingestion.d.ts

@@ -73,6 +73,7 @@ export declare function captureEducationIntake(input: {
     }>;
     awaitingParentRelease?: boolean;
     sourceRequiresParentRelease?: boolean;
+    selfReported?: boolean;
     grade: null | {
         id: string;
         graderKind: import("./submissions.js").Grade["graderKind"];
@@ -138,5 +139,6 @@ export declare function preserveWorkbookIntakeAnalysis(input: {
 }): Promise<WorkbookPreservationResult>;
 export { receiveFamilyIntake, retainFamilyIntakeReceipt, } from './family-intake-ingestion.js';
 export { FamilyIntakeService } from './family-intake-service.js';
+export { educationQuestionExtractionHandler, preserveQuestionExtractionAnalysis, QUESTION_EXTRACTION_HANDLER_ID, questionExtractionGrounding, } from './question-extraction-ingestion.js';
 export { preserveWorkbookPhotoIdentification, processWorkbookPhotoAnalysis, receiveWorkbookPhotoIntake, retainWorkbookPhotoReceipt, WORKBOOK_PHOTO_HANDLER, workbookPhotoIntakeHandlers, workbookPhotoIntakeTargetResolver, } from './workbook-photo-ingestion.js';
 //# sourceMappingURL=ingestion.d.ts.map

package/dist/ingestion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ingestion.d.ts","sourceRoot":"","sources":["../src/ingestion.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ingestion.d.ts","sourceRoot":"","sources":["../src/ingestion.ts"],"names":[],"mappings":"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"}

package/dist/ingestion.js

@@ -1,4 +1,4 @@
-import { B as validateWorkbookAssessment, I as WORKBOOK_MATH_VOCABULARY, L as WorkbookAssessmentValidationError, Q as FamilyIntakeCollection, V as workbookAggregateFeedback, Z as FamilyIntakeAssetCollection, d as WorkbookPhotoIntakeCollection, et as FamilyIntakeDecisionCollection, f as validateWorkbookPhotoIdentification, m as normalizeWorkbookAnswerRegions, n as preservePhotoProposal, p as normalizeWorkbookObservedLayout, r as WorkbookService, s as WorkbookPhotoAssetCollection, t as WorkbookPhotoService, tt as familyIntakeScopeId, v as LearnerAuthorizationError, z as aggregateWorkbookQuestions } from "./chunks/workbook-photo-service-DKgoUHeb.js";
+import { $ as LearnerAuthorizationError, At as workbookAggregateFeedback, Bt as FamilyIntakeAssetCollection, D as QUESTION_EXTRACTION_ARGS_SCHEMA, Et as WorkbookAssessmentValidationError, Ot as aggregateWorkbookQuestions, S as questionExtractionProposalDigest, Tt as WORKBOOK_MATH_VOCABULARY, Ut as FamilyIntakeDecisionCollection, Vt as FamilyIntakeCollection, Wt as familyIntakeScopeId, X as QuestionExtractionValidationError, Y as QuestionExtractionPendingError, d as WorkbookPhotoIntakeCollection, f as validateWorkbookPhotoIdentification, kt as validateWorkbookAssessment, m as normalizeWorkbookAnswerRegions, n as preservePhotoProposal, p as normalizeWorkbookObservedLayout, r as WorkbookService, s as WorkbookPhotoAssetCollection, t as WorkbookPhotoService } from "./chunks/workbook-photo-service-B7Tujv__.js";
 import { getCurrentTenant, withTenant } from "@happyvertical/smrt-tenancy";
 import { withPrivateAssetAccess } from "@happyvertical/smrt-assets";
 import { registerPermissionDefinitions } from "@happyvertical/smrt-users";
@@ -438,6 +438,201 @@ var FamilyIntakeService = class FamilyIntakeService extends WorkbookPhotoService
 	}
 };
 //#endregion
+//#region src/question-extraction-ingestion.ts
+var QUESTION_EXTRACTION_HANDLER_ID = "@happyvertical/smrt-education:extract-questions";
+var QUESTION = "@happyvertical/smrt-education:Question";
+var MEDIA_TYPES = [
+	"image/jpeg",
+	"image/png",
+	"image/webp",
+	"application/pdf"
+];
+registerPermissionDefinitions([{
+	slug: "questions.create",
+	collection: "questions",
+	qualifiedName: QUESTION,
+	name: "Apply reviewed question extractions"
+}]);
+var DESCRIPTION = "Extract the printed questions of a scanned worksheet or imported course file as structured data for extraction review. Report every source page in pages with its role (exercise, example, instructions, cover, answer_key, mixed, unknown) and readability; never drop a page. questions holds printed task text only: prompt, numbering exactly as printed, subparts, choices, section, diagram/table/image references and any answer key or rubric printed in the source (origin source). Mark anything you supply yourself origin inferred; never present an inferred key, type or points as printed. Unreadable or unsupported tasks keep their key and numbering with status unreadable/unsupported and prompt null; content you cannot extract goes in omissions. Worked examples use role example. Learner handwriting goes only in studentWork (observed text, or null when illegible), never in prompts or keys; never solve a task and report it as observed work. Keys: printed numbering path (for example 3, 3b), else u:<short printed-task slug>:<occurrence>. worksheetVersionId only when a wsv1- id is printed on the page. Anchors cite original evidenceId, the physical source page (1-based, or null when unknown; printed page numbers are not pages) and regionId only from that evidence observedRegions catalog, else null; never coordinates. Applying needs a human extraction decision; it creates or links question records and never grades or attaches learner work.";
+function bound(request, context, work) {
+	if (context.scope.tenantId !== request.tenantId || context.scope.actorId !== request.actorUserId || !context.policy.requireReview) throw new Error("Question extraction scope mismatch");
+	if (!context.principal) return work();
+	const tenant = getCurrentTenant();
+	if (!tenant || tenant.tenantId !== request.tenantId || tenant.userId !== context.principal.context.userId || context.principal.context.tenantId !== request.tenantId) throw new Error("Question extraction principal tenant mismatch");
+	return withTenant({
+		...tenant,
+		tenantId: request.tenantId,
+		userId: request.actorUserId,
+		superAdminBypass: false
+	}, work);
+}
+function summary(view) {
+	const count = (outcome) => view.match.questions.filter((m) => m.outcome === outcome).length;
+	return {
+		extractionId: view.extractionId,
+		sourceKind: view.extraction.sourceKind,
+		worksheetVersionId: view.match.worksheetVersionId,
+		worksheetKnown: view.match.worksheetKnown,
+		questions: view.extraction.questions.length,
+		matched: count("matched"),
+		ambiguous: count("ambiguous"),
+		unmatched: count("unmatched"),
+		unreadable: view.extraction.questions.filter((q) => q.status === "unreadable" || q.status === "unsupported").length,
+		studentWork: view.studentWork.length,
+		omissions: view.extraction.omissions.length,
+		sourceWarnings: view.extraction.sourceWarnings,
+		extractionReviewRequired: true
+	};
+}
+function educationQuestionExtractionHandler(input) {
+	const { extractions, request } = input;
+	const preserved = async (args, context) => {
+		const view = await bound(request, context, () => extractions.withExecutor(context.db).findExtraction({
+			...request,
+			intakeItemId: context.itemId,
+			proposalDigest: questionExtractionProposalDigest(args)
+		}));
+		if (!view) throw new Error("Question extraction must be preserved before review");
+		return view;
+	};
+	return {
+		id: QUESTION_EXTRACTION_HANDLER_ID,
+		version: "1",
+		label: "Extract questions",
+		description: DESCRIPTION,
+		operation: {
+			model: QUESTION,
+			action: "create",
+			version: "1"
+		},
+		capability: {
+			effect: "write",
+			idempotent: true,
+			openWorld: false
+		},
+		argsSchema: QUESTION_EXTRACTION_ARGS_SCHEMA,
+		resultSchema: {
+			type: "object",
+			additionalProperties: false,
+			required: ["extractionId"],
+			properties: { extractionId: {
+				type: "string",
+				minLength: 1,
+				maxLength: 64
+			} }
+		},
+		resultModels: {},
+		discovery: {
+			mediaTypes: MEDIA_TYPES,
+			references: {}
+		},
+		validate: async (args, context) => {
+			await preserved(args, context);
+			return { ok: true };
+		},
+		preview: async (args, context) => ({
+			display: summary(await preserved(args, context)),
+			normalizedArgs: args,
+			targetPreconditions: []
+		}),
+		execution: {
+			kind: "database",
+			apply: async (args, context) => {
+				const view = await preserved(args, context);
+				await bound(request, context, () => extractions.withExecutor(context.db).applyExtraction({
+					...request,
+					extractionId: view.extractionId
+				}));
+				return { extractionId: view.extractionId };
+			}
+		}
+	};
+}
+function questionExtractionGrounding(snapshot, warnings = []) {
+	const results = Array.isArray(snapshot.result.output?.results) ? snapshot.result.output.results : [];
+	const originals = intakeOriginalEvidence(snapshot.evidence ?? []).filter((e) => e.mediaType !== "application/json");
+	const pagesOf = (location) => {
+		const valid = (n) => Number.isSafeInteger(n) && n > 0;
+		if (location?.kind === "page" && valid(location.page)) return [location.page];
+		if (location?.kind === "pages" && valid(location.startPage) && valid(location.endPage) && location.endPage >= location.startPage) {
+			if (location.endPage - location.startPage >= 1e3) throw new QuestionExtractionValidationError("Too many source pages");
+			return Array.from({ length: location.endPage - location.startPage + 1 }, (_, i) => location.startPage + i);
+		}
+		return [];
+	};
+	const sources = originals.map((evidence) => {
+		const base = {
+			evidenceId: evidence.id,
+			sha256: evidence.contentHash,
+			mediaType: evidence.mediaType
+		};
+		const result = results.find((value) => !!value && typeof value === "object" && value.evidence?.id === evidence.id && value.evidence?.contentHash === evidence.contentHash);
+		if (!result) return {
+			...base,
+			pages: [],
+			extracted: false
+		};
+		const segments = Array.isArray(result.segments) ? result.segments : [];
+		const failed = [...Array.isArray(result.omitted) ? result.omitted : [], ...Array.isArray(result.errors) ? result.errors.map((e) => e?.location) : []];
+		const extractedPages = segments.flatMap((s) => pagesOf(s.location));
+		const omittedPages = [...new Set(failed.flatMap((l) => pagesOf(l)))].filter((p) => !extractedPages.includes(p)).sort((a, b) => a - b);
+		const pages = [.../* @__PURE__ */ new Set([...extractedPages, ...omittedPages])].sort((a, b) => a - b);
+		if (pages.length > 1e3) throw new QuestionExtractionValidationError("Too many source pages");
+		const catalogs = evidence.mediaType.startsWith("image/") ? segments.filter((s) => s.location?.kind === "source").map((s) => normalizeObservedImageRegions(s.observedRegions)).filter((c) => c !== void 0) : [];
+		const incomplete = result.truncated === true || failed.length > 0;
+		return {
+			...base,
+			pages,
+			...omittedPages.length ? { omittedPages } : {},
+			...incomplete ? { incomplete: true } : {},
+			...catalogs.length === 1 ? { observedRegions: catalogs[0] } : {}
+		};
+	});
+	const codes = [.../* @__PURE__ */ new Set([...warnings.filter((w) => /^[a-z][a-z0-9_.-]{0,47}$/.test(w)), ...snapshot.result.output?.truncated === true ? ["source_incomplete"] : []])].sort().slice(0, 16);
+	return {
+		version: 1,
+		extractionAttemptId: snapshot.attemptId,
+		...codes.length ? { warnings: codes } : {},
+		sources
+	};
+}
+async function preserveQuestionExtractionAnalysis(input) {
+	let snapshot;
+	try {
+		snapshot = await input.ingestion.getCompletedAnalysis(input.itemId);
+	} catch (error) {
+		if (error instanceof Error && error.message === "Analysis unavailable") throw new QuestionExtractionPendingError("pending");
+		throw error;
+	}
+	if (snapshot.configuration.stage !== "interpret" || !["completed", "partial"].includes(snapshot.result.status)) throw new QuestionExtractionPendingError("pending");
+	const generation = snapshot.result.output.proposals;
+	if (generation?.version !== 1 || !Array.isArray(generation.suggestions)) throw new QuestionExtractionValidationError("Malformed generation output");
+	if (generation.outcome === "ambiguous") throw new QuestionExtractionPendingError("ambiguous");
+	if (!["proposals", "needs_review"].includes(generation.outcome)) throw new QuestionExtractionPendingError("no_proposal");
+	const suggestions = generation.suggestions.filter((s) => s.handlerId === QUESTION_EXTRACTION_HANDLER_ID);
+	if (!suggestions.length) throw new QuestionExtractionPendingError("no_proposal");
+	if (suggestions.length > 1) throw new QuestionExtractionPendingError("ambiguous");
+	const suggestion = suggestions[0];
+	if (suggestion.missingFields.length) throw new QuestionExtractionValidationError("Incomplete question extraction");
+	const generative = generation.provenance.generative;
+	return input.extractions.preserveExtraction({
+		...input.request,
+		intakeItemId: input.itemId,
+		analysisAttemptId: snapshot.attemptId,
+		grounding: questionExtractionGrounding(snapshot, generation.warnings ?? []),
+		extractor: {
+			provider: generative.provider,
+			model: generative.model,
+			version: generative.version,
+			configurationVersion: generation.provenance.configurationVersion,
+			promptVersion: generation.provenance.promptVersion
+		},
+		extraction: suggestion.args,
+		...input.expectedWorksheetVersionId ? { expectedWorksheetVersionId: input.expectedWorksheetVersionId } : {},
+		...input.worksheets ? { worksheets: input.worksheets } : {}
+	});
+}
+//#endregion
 //#region src/workbook-photo-ingestion.ts
 var MODEL = "@happyvertical/smrt-education:WorkbookPhotoIntake";
 var WORKBOOK_PHOTO_HANDLER = "@happyvertical/smrt-education:identify-workbook-photo";
@@ -1581,6 +1776,6 @@ async function preserveWorkbookIntakeAnalysis(input) {
 	}
 }
 //#endregion
-export { FamilyIntakeService, WORKBOOK_PHOTO_HANDLER, captureEducationIntake, educationIntakeHandlers, educationIntakeTargetResolver, preserveWorkbookIntakeAnalysis, preserveWorkbookPhotoIdentification, processEducationAnalysis, processWorkbookPhotoAnalysis, queueEducationExtraction, receiveFamilyIntake, receiveWorkbookPhotoIntake, requireIngestionMemoryLimit, retainFamilyIntakeReceipt, retainWorkbookPhotoReceipt, workbookPhotoIntakeHandlers, workbookPhotoIntakeTargetResolver };
+export { FamilyIntakeService, QUESTION_EXTRACTION_HANDLER_ID, WORKBOOK_PHOTO_HANDLER, captureEducationIntake, educationIntakeHandlers, educationIntakeTargetResolver, educationQuestionExtractionHandler, preserveQuestionExtractionAnalysis, preserveWorkbookIntakeAnalysis, preserveWorkbookPhotoIdentification, processEducationAnalysis, processWorkbookPhotoAnalysis, questionExtractionGrounding, queueEducationExtraction, receiveFamilyIntake, receiveWorkbookPhotoIntake, requireIngestionMemoryLimit, retainFamilyIntakeReceipt, retainWorkbookPhotoReceipt, workbookPhotoIntakeHandlers, workbookPhotoIntakeTargetResolver };
 
 //# sourceMappingURL=ingestion.js.map