playcademy 0.29.0 → 0.29.1-beta.2

package/dist/bucket.js

@@ -42,7 +42,7 @@ var GAME_API_ROUTES_DIRECTORY = `${GAME_SERVER_ROOT_DIRECTORY}/api`;
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.21",
+  version: "0.0.22-beta.2",
   type: "module",
   exports: {
     "./server": {

package/dist/cli.js

@@ -1208,7 +1208,7 @@ var SAMPLE_BUCKET_FILENAME = "bucket.ts";
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.21",
+  version: "0.0.22-beta.2",
   type: "module",
   exports: {
     "./server": {
@@ -3045,7 +3045,7 @@ import { existsSync as existsSync11, mkdirSync as mkdirSync5, readFileSync as re
 import { join as join12 } from "node:path";
 
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.29.0";
+var cliVersion = false ? "0.0.0-dev" : "0.29.1-beta.2";
 
 // src/lib/init/database.ts
 var drizzleConfigTemplate = loadTemplateString("database/drizzle-config.ts");

package/dist/constants.js

@@ -21,7 +21,7 @@ var SAMPLE_BUCKET_FILENAME = "bucket.ts";
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.21",
+  version: "0.0.22-beta.2",
   type: "module",
   exports: {
     "./server": {

package/dist/db.js

@@ -2333,7 +2333,7 @@ var GAME_API_ROUTES_DIRECTORY = `${GAME_SERVER_ROOT_DIRECTORY}/api`;
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.21",
+  version: "0.0.22-beta.2",
   type: "module",
   exports: {
     "./server": {

package/dist/index.js

@@ -2345,7 +2345,7 @@ var SAMPLE_BUCKET_FILENAME = "bucket.ts";
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.21",
+  version: "0.0.22-beta.2",
   type: "module",
   exports: {
     "./server": {
@@ -6486,7 +6486,7 @@ import { existsSync as existsSync11, mkdirSync as mkdirSync2, readFileSync as re
 import { join as join12 } from "node:path";
 
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.29.0";
+var cliVersion = false ? "0.0.0-dev" : "0.29.1-beta.2";
 
 // src/lib/init/database.ts
 var drizzleConfigTemplate = loadTemplateString("database/drizzle-config.ts");
@@ -22714,6 +22714,15 @@ var SubmitAssessmentBodySchema = external_exports.object({
     message: "Session timing needs a UUID runId and resumeId with non-negative active and inactive seconds"
   }).optional()
 });
+var FinalizeAssessmentBodySchema = external_exports.object({
+  submissionId: external_exports.string().trim().min(1),
+  xpAwarded: external_exports.number().finite().nonnegative(),
+  masteredUnits: external_exports.number().finite().optional(),
+  masteredUnitsAbsolute: external_exports.number().finite().int().optional()
+}).refine((body) => body.masteredUnits === void 0 || body.masteredUnitsAbsolute === void 0, {
+  message: "Provide either masteredUnits or masteredUnitsAbsolute, not both",
+  path: ["masteredUnits"]
+});
 var StartRuntimeAssessmentRequestSchema = AssessmentRuntimeIdentitySchema.and(StartAssessmentBodySchema);
 var SaveRuntimeAssessmentRequestSchema = AssessmentRuntimeIdentitySchema.extend(SaveAssessmentBodySchema.shape);
 var SubmitAssessmentItemRuntimeRequestSchema = AssessmentRuntimeIdentitySchema.extend(SubmitAssessmentItemBodySchema.shape);
@@ -22721,6 +22730,10 @@ var SubmitRuntimeAssessmentRequestSchema = AssessmentRuntimeIdentitySchema.exten
   appName: external_exports.string().trim().min(1),
   sensorUrl: external_exports.string().url()
 });
+var FinalizeRuntimeAssessmentRequestSchema = AssessmentRuntimeIdentitySchema.extend({
+  appName: external_exports.string().trim().min(1),
+  sensorUrl: external_exports.string().url()
+}).and(FinalizeAssessmentBodySchema);
 
 // src/lib/timeback/assessment-fixtures.ts
 function assessmentFixturePath(workspace = getWorkspace()) {

package/dist/runtime/dashboard-runtime/manifest.json

@@ -1,7 +1,7 @@
 {
-  "cliVersion": "0.29.0",
-  "sdkVersion": "0.17.0",
-  "runtimeBuildId": "8d696801888c",
-  "inputFingerprint": "8d696801888c6ba351bc7c899ba3124cdb00864c28c9be0c4fa94eb86f279079",
+  "cliVersion": "0.29.1-beta.2",
+  "sdkVersion": "0.17.1-beta.2",
+  "runtimeBuildId": "1fbde6bc12e9",
+  "inputFingerprint": "1fbde6bc12e961a9f80f44a0d8603ee681b92c647c286a60e67606bc1020ab70",
   "entry": "index.js"
 }

package/dist/runtime/game-runtime/index.js

@@ -10058,12 +10058,30 @@ function isAssessmentAttemptOpen(attempt) {
 function isAssessmentAttemptCompleted(attempt) {
   return attempt.inProgress === ASSESSMENT_ATTEMPT_COMPLETED.inProgress && attempt.scoreStatus === ASSESSMENT_ATTEMPT_COMPLETED.scoreStatus;
 }
+function isAssessmentAttemptAwaitingAward(attempt) {
+  return attempt.inProgress === ASSESSMENT_ATTEMPT_AWAITING_AWARD.inProgress && attempt.scoreStatus === ASSESSMENT_ATTEMPT_AWAITING_AWARD.scoreStatus;
+}
 function classifyAssessmentSubmission(attempt, submissionId) {
-  if (isAssessmentAttemptCompleted(attempt)) {
+  if (isAssessmentAttemptAwaitingAward(attempt)) {
     return attempt.submissionId === submissionId ? "replay" : "reject";
   }
+  if (isAssessmentAttemptCompleted(attempt)) {
+    return "reject";
+  }
   return isAssessmentAttemptOpen(attempt) ? "submit" : "reject";
 }
+function isSameAssessmentAward(recorded, input) {
+  return recorded.xpAwarded === input.xpAwarded && recorded.masteredUnits === input.masteredUnits && recorded.masteredUnitsAbsolute === input.masteredUnitsAbsolute;
+}
+function classifyAssessmentFinalization(attempt, input) {
+  if (isAssessmentAttemptCompleted(attempt)) {
+    return attempt.submissionId === input.submissionId && attempt.award !== void 0 && isSameAssessmentAward(attempt.award, input) ? "replay" : "conflict";
+  }
+  if (!isAssessmentAttemptAwaitingAward(attempt) || attempt.submissionId !== input.submissionId) {
+    return "reject";
+  }
+  return "finalize";
+}
 function assessmentFlowViolation(message2, details) {
   return {
     code: "ASSESSMENT_FLOW_VIOLATION",
@@ -10092,6 +10110,13 @@ function assessmentAlreadySubmitted(attemptId) {
     details: { attemptId }
   };
 }
+function assessmentAwardConflict(details) {
+  return {
+    code: "ASSESSMENT_FLOW_VIOLATION",
+    message: "This assessment award conflicts with the recorded finalization.",
+    details
+  };
+}
 function assessmentResponseVersionConflict(expectedResponseVersion, responseVersion) {
   return {
     code: "RESPONSE_VERSION_CONFLICT",
@@ -11352,7 +11377,7 @@ function orderRuntimeAssessmentTests(tests) {
   return [...tests].toSorted(compareAssessmentCatalogOrder);
 }
 function selectRuntimeAssessment(liveTests, attempts) {
-  const resumable = attempts.filter((attempt) => attempt.resumable !== false && isAssessmentAttemptOpen(attempt)).toSorted((left, right) => newestAttempt(left, right, "updatedAt"));
+  const resumable = attempts.filter((attempt) => attempt.resumable !== false && (isAssessmentAttemptOpen(attempt) || isAssessmentAttemptAwaitingAward(attempt))).toSorted((left, right) => newestAttempt(left, right, "updatedAt"));
   if (resumable.length > 0) {
     return {
       kind: "resume",
@@ -11365,7 +11390,7 @@ function selectRuntimeAssessment(liveTests, attempts) {
     return null;
   }
   const completed = attempts.filter(isAssessmentAttemptCompleted);
-  const exposedAssessmentKeys = new Set(attempts.filter((attempt) => isAssessmentAttemptOpen(attempt) || isAssessmentAttemptCompleted(attempt)).map((attempt) => attempt.selectedAssessmentKey));
+  const exposedAssessmentKeys = new Set(attempts.filter((attempt) => isAssessmentAttemptOpen(attempt) || isAssessmentAttemptAwaitingAward(attempt) || isAssessmentAttemptCompleted(attempt)).map((attempt) => attempt.selectedAssessmentKey));
   const unattempted = orderedTests.find((test) => !exposedAssessmentKeys.has(test.assessmentKey));
   if (unattempted) {
     return { kind: "start", test: unattempted, reason: "unattempted" };
@@ -11927,7 +11952,7 @@ function masteryStandardMatcher(requested) {
     return canonicalAuthored !== null && assessmentStandardRefKey(canonicalAuthored) === requestedKey;
   };
 }
-var SCRIPT_SCHEMES, DATA_RASTER_IMAGE_PATTERN, metadataSymbol, parser, SUPPORTED_QTI_INTERACTION_TYPES, INTERACTION_TYPES, BLANK_SENTINEL, MARKED_BLANK_PATTERN, MARKED_BLANK_GLOBAL_PATTERN, MATCH_CORRECT_TEMPLATE, MAP_RESPONSE_TEMPLATE, MAP_RESPONSE_TEMPLATES, RESPONSE_PROCESSING_TEMPLATES, COMMON_CORE_MATH_FRAMEWORK_ALIASES, COMMON_CORE_ELA_FRAMEWORK_ALIASES, COMMON_CORE_FRAMEWORK_ALIASES, ASSESSMENT_ATTEMPT_OPEN, ASSESSMENT_ATTEMPT_COMPLETED, ASSESSMENT_RUNTIME_ERROR_STATUS, ROUTING_KEY_MAX_LENGTH, ROUTING_RESULT_KEY_MAX_LENGTH, ROUTING_STAGE_LIMIT, ROUTING_TRACK_LIMIT, ROUTING_NODE_LIMIT, ROUTING_TERMINAL_LIMIT, ROUTING_GROUP_LIMIT, ROUTING_PREDICATE_DEPTH_LIMIT, ROUTING_EXPLORATION_STATE_LIMIT, RoutingKeySchema, RoutingResultKeySchema, DiagnosticTrackOutcomeSchema, DiagnosticActivationPredicateSchema, DiagnosticRoutingTransitionSchema, DiagnosticRoutingManifestV1Schema, GRADE_VALUES, POINT_RESPONSE_PATTERN, REVIEW_SELECTION_POLICY_VERSION, DEFAULT_REVIEW_SELECTION_POLICY, ASSESSMENT_RUNTIME_FIXTURE_BUNDLE_VERSION, RuntimeSubjectSchema, RuntimeGradeSchema, OptionalQueryGradeSchema, AssessmentResponseValueSchema, AssessmentRuntimeIdentitySchema, ResponseKeySchema, StartAssessmentBaseSchema, AssessmentStandardRefSchema, LatestAssessmentFilterBaseSchema, LatestAssessmentFiltersSchema, LatestRuntimeAssessmentQuerySchema, StartAssessmentBodySchema, SaveAssessmentBodySchema, SubmitAssessmentItemBodySchema, SubmitAssessmentBodySchema, StartRuntimeAssessmentRequestSchema, SaveRuntimeAssessmentRequestSchema, SubmitAssessmentItemRuntimeRequestSchema, SubmitRuntimeAssessmentRequestSchema;
+var SCRIPT_SCHEMES, DATA_RASTER_IMAGE_PATTERN, metadataSymbol, parser, SUPPORTED_QTI_INTERACTION_TYPES, INTERACTION_TYPES, BLANK_SENTINEL, MARKED_BLANK_PATTERN, MARKED_BLANK_GLOBAL_PATTERN, MATCH_CORRECT_TEMPLATE, MAP_RESPONSE_TEMPLATE, MAP_RESPONSE_TEMPLATES, RESPONSE_PROCESSING_TEMPLATES, COMMON_CORE_MATH_FRAMEWORK_ALIASES, COMMON_CORE_ELA_FRAMEWORK_ALIASES, COMMON_CORE_FRAMEWORK_ALIASES, ASSESSMENT_ATTEMPT_OPEN, ASSESSMENT_ATTEMPT_COMPLETED, ASSESSMENT_ATTEMPT_AWAITING_AWARD, ASSESSMENT_RUNTIME_ERROR_STATUS, ROUTING_KEY_MAX_LENGTH, ROUTING_RESULT_KEY_MAX_LENGTH, ROUTING_STAGE_LIMIT, ROUTING_TRACK_LIMIT, ROUTING_NODE_LIMIT, ROUTING_TERMINAL_LIMIT, ROUTING_GROUP_LIMIT, ROUTING_PREDICATE_DEPTH_LIMIT, ROUTING_EXPLORATION_STATE_LIMIT, RoutingKeySchema, RoutingResultKeySchema, DiagnosticTrackOutcomeSchema, DiagnosticActivationPredicateSchema, DiagnosticRoutingTransitionSchema, DiagnosticRoutingManifestV1Schema, GRADE_VALUES, POINT_RESPONSE_PATTERN, REVIEW_SELECTION_POLICY_VERSION, DEFAULT_REVIEW_SELECTION_POLICY, ASSESSMENT_RUNTIME_FIXTURE_BUNDLE_VERSION, RuntimeSubjectSchema, RuntimeGradeSchema, OptionalQueryGradeSchema, AssessmentResponseValueSchema, AssessmentRuntimeIdentitySchema, ResponseKeySchema, StartAssessmentBaseSchema, AssessmentStandardRefSchema, LatestAssessmentFilterBaseSchema, LatestAssessmentFiltersSchema, LatestRuntimeAssessmentQuerySchema, StartAssessmentBodySchema, SaveAssessmentBodySchema, SubmitAssessmentItemBodySchema, SubmitAssessmentBodySchema, FinalizeAssessmentBodySchema, StartRuntimeAssessmentRequestSchema, SaveRuntimeAssessmentRequestSchema, SubmitAssessmentItemRuntimeRequestSchema, SubmitRuntimeAssessmentRequestSchema, FinalizeRuntimeAssessmentRequestSchema;
 var init_assessment_runtime2 = __esm({
   "../timeback/dist/engines/assessment-runtime/index.js"() {
     "use strict";
@@ -12021,6 +12046,10 @@ var init_assessment_runtime2 = __esm({
       inProgress: "false",
       scoreStatus: "fully graded"
     };
+    ASSESSMENT_ATTEMPT_AWAITING_AWARD = {
+      inProgress: "false",
+      scoreStatus: "submitted"
+    };
     ASSESSMENT_RUNTIME_ERROR_STATUS = {
       NO_ELIGIBLE_TESTS: 404,
       REVIEW_BANK_SHORTAGE: 422,
@@ -12187,6 +12216,15 @@ var init_assessment_runtime2 = __esm({
         message: "Session timing needs a UUID runId and resumeId with non-negative active and inactive seconds"
       }).optional()
     });
+    FinalizeAssessmentBodySchema = external_exports.object({
+      submissionId: external_exports.string().trim().min(1),
+      xpAwarded: external_exports.number().finite().nonnegative(),
+      masteredUnits: external_exports.number().finite().optional(),
+      masteredUnitsAbsolute: external_exports.number().finite().int().optional()
+    }).refine((body) => body.masteredUnits === void 0 || body.masteredUnitsAbsolute === void 0, {
+      message: "Provide either masteredUnits or masteredUnitsAbsolute, not both",
+      path: ["masteredUnits"]
+    });
     StartRuntimeAssessmentRequestSchema = AssessmentRuntimeIdentitySchema.and(StartAssessmentBodySchema);
     SaveRuntimeAssessmentRequestSchema = AssessmentRuntimeIdentitySchema.extend(SaveAssessmentBodySchema.shape);
     SubmitAssessmentItemRuntimeRequestSchema = AssessmentRuntimeIdentitySchema.extend(SubmitAssessmentItemBodySchema.shape);
@@ -12194,6 +12232,10 @@ var init_assessment_runtime2 = __esm({
       appName: external_exports.string().trim().min(1),
       sensorUrl: external_exports.string().url()
     });
+    FinalizeRuntimeAssessmentRequestSchema = AssessmentRuntimeIdentitySchema.extend({
+      appName: external_exports.string().trim().min(1),
+      sensorUrl: external_exports.string().url()
+    }).and(FinalizeAssessmentBodySchema);
   }
 });
 
@@ -12221,6 +12263,12 @@ var init_local_assessment_runtime = __esm({
     LocalAssessmentRuntime = class {
       bundle;
       attempts = /* @__PURE__ */ new Map();
+      /**
+       * Running mastered-unit total per student so absolute awards resolve to
+       * a delta the way the platform does. Local fixtures configure no
+       * masterable ceiling, so nothing is bounded and no percentage is echoed.
+       */
+      masteredUnitsByStudent = /* @__PURE__ */ new Map();
       lastTimestampMs = 0;
       constructor(bundle) {
         this.bundle = bundle;
@@ -12747,7 +12795,7 @@ var init_local_assessment_runtime = __esm({
         const attempt = this.authorize(studentId2, attemptId);
         const submissionDisposition = classifyAssessmentSubmission(attempt, input.submissionId);
         if (submissionDisposition === "replay") {
-          return this.completedResult(attempt);
+          return this.submittedResult(attempt);
         }
         if (submissionDisposition === "reject") {
           throw failure(assessmentAlreadySubmitted(attemptId));
@@ -12779,11 +12827,11 @@ var init_local_assessment_runtime = __esm({
           attempt.score = scoreAssessmentFixture(test, attempt.responses);
         }
         attempt.submissionId = input.submissionId;
-        attempt.inProgress = ASSESSMENT_ATTEMPT_COMPLETED.inProgress;
-        attempt.scoreStatus = ASSESSMENT_ATTEMPT_COMPLETED.scoreStatus;
+        attempt.inProgress = ASSESSMENT_ATTEMPT_AWAITING_AWARD.inProgress;
+        attempt.scoreStatus = ASSESSMENT_ATTEMPT_AWAITING_AWARD.scoreStatus;
         attempt.updatedAt = this.timestamp();
         attempt.scoreDate = attempt.updatedAt;
-        return this.completedResult(attempt);
+        return this.submittedResult(attempt);
       }
       finalizeDiagnostic(attempt, submissionId) {
         const diagnostic = this.requireDiagnosticAttempt(attempt);
@@ -12814,11 +12862,47 @@ var init_local_assessment_runtime = __esm({
         }
         attempt.score = aggregateFixtureItemScores(diagnostic.commits.map((commit) => commit.scoring));
         attempt.submissionId = submissionId;
+        attempt.inProgress = ASSESSMENT_ATTEMPT_AWAITING_AWARD.inProgress;
+        attempt.scoreStatus = ASSESSMENT_ATTEMPT_AWAITING_AWARD.scoreStatus;
+        attempt.updatedAt = this.timestamp();
+        attempt.scoreDate = attempt.updatedAt;
+        return this.submittedDiagnosticResult(attempt, tracks);
+      }
+      finalize(studentId2, attemptId, input) {
+        const attempt = this.authorize(studentId2, attemptId);
+        switch (classifyAssessmentFinalization(attempt, input)) {
+          case "replay": {
+            return this.finalizedResult(attempt);
+          }
+          case "conflict": {
+            throw failure(
+              assessmentAwardConflict({
+                attemptId,
+                submissionId: input.submissionId,
+                xpAwarded: input.xpAwarded,
+                ...input.masteredUnits !== void 0 ? { masteredUnits: input.masteredUnits } : {},
+                ...input.masteredUnitsAbsolute !== void 0 ? { masteredUnitsAbsolute: input.masteredUnitsAbsolute } : {}
+              })
+            );
+          }
+          case "reject": {
+            throw failure(assessmentAlreadySubmitted(attemptId));
+          }
+        }
+        const masteryKey = `${studentId2}\0${attempt.catalogId}`;
+        const currentMasteredUnits = this.masteredUnitsByStudent.get(masteryKey) ?? 0;
+        const masteredUnitsApplied = input.masteredUnitsAbsolute !== void 0 ? input.masteredUnitsAbsolute - currentMasteredUnits : input.masteredUnits ?? 0;
+        this.masteredUnitsByStudent.set(masteryKey, currentMasteredUnits + masteredUnitsApplied);
+        attempt.award = {
+          xpAwarded: input.xpAwarded,
+          ...input.masteredUnits !== void 0 ? { masteredUnits: input.masteredUnits } : {},
+          ...input.masteredUnitsAbsolute !== void 0 ? { masteredUnitsAbsolute: input.masteredUnitsAbsolute } : {},
+          masteredUnitsApplied
+        };
         attempt.inProgress = ASSESSMENT_ATTEMPT_COMPLETED.inProgress;
         attempt.scoreStatus = ASSESSMENT_ATTEMPT_COMPLETED.scoreStatus;
         attempt.updatedAt = this.timestamp();
-        attempt.scoreDate = attempt.updatedAt;
-        return this.completedDiagnosticResult(attempt, tracks);
+        return this.finalizedResult(attempt);
       }
       catalog(input, studentId2) {
         const requestedReviewFingerprint = input.purpose === "review" ? reviewRequestFingerprint(input, DEFAULT_REVIEW_SELECTION_POLICY) : void 0;
@@ -12846,7 +12930,7 @@ var init_local_assessment_runtime = __esm({
               (attempt) => attempt.studentId === studentId2 && attempt.catalogId === catalog.id && attempt.activityId === input.activityId && (input.purpose !== "review" || attempt.selection.kind === "standards-review" && attempt.review?.requestFingerprint === requestedReviewFingerprint) && (input.purpose !== "mastery" || attempt.selection.kind === "standard-quiz" && masteryStandardMatches(
                 attempt.selection.standard,
                 input.standard
-              )) && (input.purpose !== "diagnostic" || attempt.selection.kind === "platform-routed-diagnostic" && attempt.selection.diagnosticKey === input.diagnosticKey) && isAssessmentAttemptOpen(attempt)
+              )) && (input.purpose !== "diagnostic" || attempt.selection.kind === "platform-routed-diagnostic" && attempt.selection.diagnosticKey === input.diagnosticKey) && (isAssessmentAttemptOpen(attempt) || isAssessmentAttemptAwaitingAward(attempt))
             );
           }
           courses.set(key, entry);
@@ -13010,7 +13094,22 @@ var init_local_assessment_runtime = __esm({
         });
       }
       snapshot(attempt) {
-        const completed = isAssessmentAttemptCompleted(attempt);
+        if (isAssessmentAttemptAwaitingAward(attempt)) {
+          return {
+            attemptId: attempt.attemptId,
+            responseVersion: attempt.responseVersion,
+            status: "awaiting_award",
+            result: this.submittedResult(attempt)
+          };
+        }
+        if (isAssessmentAttemptCompleted(attempt)) {
+          return {
+            attemptId: attempt.attemptId,
+            responseVersion: attempt.responseVersion,
+            status: "completed",
+            result: this.finalizedResult(attempt)
+          };
+        }
         const catalog = this.catalogForAttempt(attempt);
         const test = this.testForAttempt(attempt);
         if (attempt.selection.kind === "platform-routed-diagnostic") {
@@ -13027,7 +13126,7 @@ var init_local_assessment_runtime = __esm({
           return {
             attemptId: attempt.attemptId,
             responseVersion: attempt.responseVersion,
-            status: completed ? "completed" : "in_progress",
+            status: "in_progress",
             flow: "platform-routed-item-submit",
             activityData: {
               activityId: attempt.activityId,
@@ -13038,13 +13137,13 @@ var init_local_assessment_runtime = __esm({
             assessment: assessmentPresentationForAttempt(test.assessment, attempt.attemptId),
             selection: structuredClone(attempt.selection),
             routing: this.diagnosticRoutingSnapshot(attempt, replayed.state),
-            completion: completed ? this.completedResult(attempt) : null
+            completion: null
           };
         }
         return {
           attemptId: attempt.attemptId,
           responseVersion: attempt.responseVersion,
-          status: completed ? "completed" : "in_progress",
+          status: "in_progress",
           flow: assessmentFlowForSelection(attempt.selection),
           activityData: {
             activityId: attempt.activityId,
@@ -13057,11 +13156,11 @@ var init_local_assessment_runtime = __esm({
           assessment: assessmentPresentationForAttempt(test.assessment, attempt.attemptId),
           responses: structuredClone(attempt.responses),
           itemSubmissions: structuredClone(attempt.itemSubmissions),
-          score: completed ? structuredClone(this.scoreForAttempt(attempt)) : null,
+          score: null,
           selection: structuredClone(attempt.selection)
         };
       }
-      completedResult(attempt) {
+      submittedResult(attempt) {
         if (attempt.selection.kind === "platform-routed-diagnostic") {
           const diagnostic = this.requireDiagnosticAttempt(attempt);
           const { routingManifest } = this.diagnosticTestForAttempt(attempt);
@@ -13070,12 +13169,13 @@ var init_local_assessment_runtime = __esm({
           if (!tracks) {
             throw new Error("A completed diagnostic must have terminal track results");
           }
-          return this.completedDiagnosticResult(attempt, tracks);
+          return this.submittedDiagnosticResult(attempt, tracks);
         }
         const result = {
           attemptId: attempt.attemptId,
+          submissionId: attempt.submissionId,
           responseVersion: attempt.responseVersion,
-          status: "completed",
+          status: "awaiting_award",
           responses: structuredClone(attempt.responses),
           score: structuredClone(this.scoreForAttempt(attempt))
         };
@@ -13090,17 +13190,29 @@ var init_local_assessment_runtime = __esm({
         }
         return { ...result, purpose: attempt.selection.purpose };
       }
-      completedDiagnosticResult(attempt, tracks) {
+      submittedDiagnosticResult(attempt, tracks) {
         const diagnostic = this.requireDiagnosticAttempt(attempt);
         return {
           purpose: "diagnostic",
           attemptId: attempt.attemptId,
+          submissionId: attempt.submissionId,
           diagnosticKey: diagnostic.diagnosticKey,
           responseVersion: attempt.responseVersion,
-          status: "completed",
+          status: "awaiting_award",
           tracks: structuredClone([...tracks])
         };
       }
+      finalizedResult(attempt) {
+        if (attempt.award === void 0) {
+          throw new Error("A completed assessment must have a recorded award");
+        }
+        return {
+          ...this.submittedResult(attempt),
+          status: "completed",
+          xpAwarded: attempt.award.xpAwarded,
+          masteredUnitsApplied: attempt.award.masteredUnitsApplied
+        };
+      }
       diagnosticRoutingSnapshot(attempt, state) {
         const diagnostic = this.requireDiagnosticAttempt(attempt);
         return projectDiagnosticRoutingSnapshot(diagnostic.routingRevision, state);
@@ -13351,6 +13463,7 @@ var init_shared = __esm({
 // ../edge-play/src/game/routes/integrations/timeback/assessment-fixture-runtime.ts
 var assessment_fixture_runtime_exports = {};
 __export(assessment_fixture_runtime_exports, {
+  FINALIZE: () => FINALIZE,
   GET: () => GET2,
   LATEST: () => LATEST,
   SAVE: () => SAVE,
@@ -13422,6 +13535,12 @@ async function SUBMIT(c) {
     return provider(c).submit(studentId(c), c.req.param("attemptId"), input);
   });
 }
+async function FINALIZE(c) {
+  return respond(c, RESPOND_ERROR, async () => {
+    const input = parseBody2(FinalizeAssessmentBodySchema, await c.req.json());
+    return provider(c).finalize(studentId(c), c.req.param("attemptId"), input);
+  });
+}
 var fixtureSource, fixtureProvider, RESPOND_ERROR;
 var init_assessment_fixture_runtime = __esm({
   "../edge-play/src/game/routes/integrations/timeback/assessment-fixture-runtime.ts"() {
@@ -13440,6 +13559,7 @@ var init_assessment_fixture_runtime = __esm({
 // ../edge-play/src/game/routes/integrations/timeback/assessment-runtime.ts
 var assessment_runtime_exports = {};
 __export(assessment_runtime_exports, {
+  FINALIZE: () => FINALIZE2,
   GET: () => GET3,
   LATEST: () => LATEST2,
   SAVE: () => SAVE2,
@@ -13519,6 +13639,20 @@ async function SUBMIT2(c) {
     }
   );
 }
+async function FINALIZE2(c) {
+  return respond(
+    c,
+    { tag: "TimeBack Assessment Finalize", fallback: "Failed to finalize assessment" },
+    async () => {
+      const studentId2 = requireTimebackStudentId(c);
+      assertTimebackIntegrated(c);
+      const input = await c.req.json();
+      return c.get("sdk").timeback.assessments.finalize(studentId2, c.req.param("attemptId"), input, {
+        sensorUrl: new URL(c.req.url).origin
+      });
+    }
+  );
+}
 var init_assessment_runtime3 = __esm({
   "../edge-play/src/game/routes/integrations/timeback/assessment-runtime.ts"() {
     "use strict";
@@ -13580,9 +13714,9 @@ var init_list = __esm({
 // ../edge-play/src/game/lib/metadata.ts
 function getRuntimeMetadata() {
   return {
-    cliVersion: true ? "0.29.0" : "0.0.0-dev",
-    sdkVersion: true ? "0.17.0" : "0.0.0-dev",
-    buildId: true ? "8d696801888c" : "dev-source"
+    cliVersion: true ? "0.29.1-beta.2" : "0.0.0-dev",
+    sdkVersion: true ? "0.17.1-beta.2" : "0.0.0-dev",
+    buildId: true ? "1fbde6bc12e9" : "dev-source"
   };
 }
 var init_metadata = __esm({
@@ -15796,6 +15930,17 @@ function createTimebackNamespace(client) {
           appName: client.config.name,
           sensorUrl: context.sensorUrl
         }
+      ),
+      finalize: (studentId2, attemptId, input, context) => client["request"](
+        `/api/timeback/assessments/${encodeURIComponent(attemptId)}/finalize`,
+        "POST",
+        {
+          ...input,
+          gameId: client.gameId,
+          studentId: studentId2,
+          appName: client.config.name,
+          sensorUrl: context.sensorUrl
+        }
       )
     },
     /**
@@ -16656,6 +16801,7 @@ function registerAssessmentRoutes(app, assessments) {
   app.post(`${GAME_ROUTES.TIMEBACK.ASSESSMENTS}/:attemptId/save`, assessments.SAVE);
   app.post(`${GAME_ROUTES.TIMEBACK.ASSESSMENTS}/:attemptId/submit-item`, assessments.SUBMIT_ITEM);
   app.post(`${GAME_ROUTES.TIMEBACK.ASSESSMENTS}/:attemptId/submit`, assessments.SUBMIT);
+  app.post(`${GAME_ROUTES.TIMEBACK.ASSESSMENTS}/:attemptId/finalize`, assessments.FINALIZE);
 }
 async function timebackNotConfiguredStub(c) {
   return c.json({ __playcademyDevWarning: "timeback-not-configured" });
@@ -16767,6 +16913,7 @@ async function registerBuiltinRoutes(app, integrations, hasAssessmentFixtures =
       app.post(`${assessmentsBase}/:attemptId/save`, timebackNotConfiguredStub);
       app.post(`${assessmentsBase}/:attemptId/submit-item`, timebackNotConfiguredStub);
       app.post(`${assessmentsBase}/:attemptId/submit`, timebackNotConfiguredStub);
+      app.post(`${assessmentsBase}/:attemptId/finalize`, timebackNotConfiguredStub);
     }
   }
   if (assessments) {

package/dist/runtime/game-runtime/manifest.json

@@ -1,7 +1,7 @@
 {
-  "cliVersion": "0.29.0",
-  "sdkVersion": "0.17.0",
-  "runtimeBuildId": "8d696801888c",
-  "inputFingerprint": "8d696801888c6ba351bc7c899ba3124cdb00864c28c9be0c4fa94eb86f279079",
+  "cliVersion": "0.29.1-beta.2",
+  "sdkVersion": "0.17.1-beta.2",
+  "runtimeBuildId": "1fbde6bc12e9",
+  "inputFingerprint": "1fbde6bc12e961a9f80f44a0d8603ee681b92c647c286a60e67606bc1020ab70",
   "entry": "index.js"
 }

package/dist/utils.js

@@ -396,7 +396,7 @@ var DASHBOARD_API_ROUTES_DIRECTORY = "api";
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.21",
+  version: "0.0.22-beta.2",
   type: "module",
   exports: {
     "./server": {
@@ -2849,7 +2849,7 @@ import { existsSync as existsSync9, mkdirSync as mkdirSync2, writeFileSync as wr
 import { dirname as dirname4, join as join13 } from "node:path";
 
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.29.0";
+var cliVersion = false ? "0.0.0-dev" : "0.29.1-beta.2";
 
 // src/lib/build/binary-resource.ts
 function writeFileTree(baseDir, files) {
@@ -15482,6 +15482,15 @@ var SubmitAssessmentBodySchema = external_exports.object({
     message: "Session timing needs a UUID runId and resumeId with non-negative active and inactive seconds"
   }).optional()
 });
+var FinalizeAssessmentBodySchema = external_exports.object({
+  submissionId: external_exports.string().trim().min(1),
+  xpAwarded: external_exports.number().finite().nonnegative(),
+  masteredUnits: external_exports.number().finite().optional(),
+  masteredUnitsAbsolute: external_exports.number().finite().int().optional()
+}).refine((body) => body.masteredUnits === void 0 || body.masteredUnitsAbsolute === void 0, {
+  message: "Provide either masteredUnits or masteredUnitsAbsolute, not both",
+  path: ["masteredUnits"]
+});
 var StartRuntimeAssessmentRequestSchema = AssessmentRuntimeIdentitySchema.and(StartAssessmentBodySchema);
 var SaveRuntimeAssessmentRequestSchema = AssessmentRuntimeIdentitySchema.extend(SaveAssessmentBodySchema.shape);
 var SubmitAssessmentItemRuntimeRequestSchema = AssessmentRuntimeIdentitySchema.extend(SubmitAssessmentItemBodySchema.shape);
@@ -15489,6 +15498,10 @@ var SubmitRuntimeAssessmentRequestSchema = AssessmentRuntimeIdentitySchema.exten
   appName: external_exports.string().trim().min(1),
   sensorUrl: external_exports.string().url()
 });
+var FinalizeRuntimeAssessmentRequestSchema = AssessmentRuntimeIdentitySchema.extend({
+  appName: external_exports.string().trim().min(1),
+  sensorUrl: external_exports.string().url()
+}).and(FinalizeAssessmentBodySchema);
 
 // src/lib/timeback/assessment-fixtures.ts
 function assessmentFixturePath(workspace = getWorkspace()) {

package/dist/version.js

@@ -1,7 +1,7 @@
 import { createRequire as __pcCreateRequire } from 'node:module'; const require = __pcCreateRequire(import.meta.url);
 
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.29.0";
+var cliVersion = false ? "0.0.0-dev" : "0.29.1-beta.2";
 export {
   cliVersion
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "playcademy",
-    "version": "0.29.0",
+    "version": "0.29.1-beta.2",
     "type": "module",
     "exports": {
         ".": {
@@ -55,7 +55,7 @@
     },
     "dependencies": {
         "@inquirer/prompts": "^7.8.6",
-        "@playcademy/sdk": "0.17.0",
+        "@playcademy/sdk": "0.17.1-beta.2",
         "chokidar": "^4.0.3",
         "colorette": "^2.0.20",
         "commander": "^14.0.1",