@plasius/learning 0.2.25 → 0.3.0

package/dist/index.d.cts

@@ -481,6 +481,154 @@ declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4: LearningPathVersionV1;
 /** Current pilot catalog for server adapters that intentionally follow releases. */
 declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT: LearningPathVersionV1;
 
+/** Stable activity order for complete courses; legacy authoring remains immutable. */
+declare const LEARNING_COURSE_STAGE_ORDER: readonly ["learn", "predict", "build", "run", "assess", "inspect", "fix", "explain", "reward"];
+declare const LEARNING_COURSE_LIMITS: Readonly<{
+    missions: 6;
+    stagesPerMission: 9;
+    projectFiles: 8;
+    sourceCharactersPerFile: 64000;
+    sourceCharactersPerProject: 96000;
+}>;
+type LearningProjectLanguageV1 = "javascript" | "python" | "cpp" | "html" | "css" | "blocks" | "json";
+interface LearningProjectFileV1 {
+    path: string;
+    source: string;
+}
+interface LearningProjectV1 {
+    files: LearningProjectFileV1[];
+}
+interface LearningCourseStageV1 {
+    id: string;
+    kind: MissionStageKindV1;
+    title: string;
+    instruction: string;
+    help: string;
+}
+interface LearningCourseMissionV1 {
+    id: string;
+    title: string;
+    concepts: string[];
+    estimatedMinutes: number;
+    goals: string[];
+    assessmentId: string;
+    stages: LearningCourseStageV1[];
+    extension: string;
+}
+/** Learner-safe content only. Protected scenarios and solutions are host-owned. */
+interface LearningCourseV1 {
+    schemaVersion: "1";
+    moduleId: string;
+    moduleVersion: string;
+    slug: string;
+    title: string;
+    summary: string;
+    runtimeId: string;
+    category: ModuleCategoryV1;
+    estimatedMinutes: number;
+    completionAssessmentId: string;
+    projectFiles: {
+        path: string;
+        language: LearningProjectLanguageV1;
+        maximumCharacters: number;
+    }[];
+    starterProject: LearningProjectV1;
+    reference: {
+        name: string;
+        signature: string;
+        description: string;
+        example: string;
+    }[];
+    missions: LearningCourseMissionV1[];
+    completionBadge: {
+        id: string;
+        title: string;
+    };
+}
+/** The only learner-owned save inputs. Progress/evidence are never draft authority. */
+interface LearningCourseDraftV1 {
+    schemaVersion: "1";
+    moduleVersion: string;
+    activeStageId: string;
+    project: LearningProjectV1;
+}
+type LearningSaveSlotIdV1 = "auto" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9";
+interface LearningCourseValidationIssueV1 {
+    code: "invalid-manifest" | "mission-count" | "stage-order" | "duplicate-id" | "incomplete-content" | "invalid-project";
+    path: string;
+}
+/** Errors contain no source, learner text or caller-supplied identifiers. */
+declare class LearningCourseInputError extends Error {
+    constructor();
+}
+/** Validate every file against the declared editable set; never preserve extra fields. */
+declare function parseLearningProject(course: Pick<LearningCourseV1, "projectFiles">, value: unknown): LearningProjectV1;
+/** Parse untrusted saves without accepting identity, scores, completion or evidence. */
+declare function parseLearningCourseDraft(course: LearningCourseV1, value: unknown): LearningCourseDraftV1;
+/** An account owns one autosave and nine explicitly managed slots per course version. */
+declare function parseLearningSaveSlotId(value: unknown): LearningSaveSlotIdV1;
+/** Structural publication gate. Working runtime/curriculum acceptance is additional. */
+declare function validateLearningCourse(value: unknown): LearningCourseValidationIssueV1[];
+/** Validate an external learner manifest and detach it from the supplied object. */
+declare function parseLearningCourse(value: unknown): LearningCourseV1;
+
+/** Stored host-issued assessment. No browser-supplied result may construct this authority. */
+interface LearningCourseAssessmentRecordV1 {
+    missionId: string;
+    assessmentId: string;
+    referenceId: string;
+    sourceDigest: string;
+    result: AssessmentResultV1;
+}
+/** Account and timestamps are supplied by the storage adapter, not the contract. */
+interface LearningCourseProgressV1 {
+    schemaVersion: "1";
+    moduleId: string;
+    moduleVersion: string;
+    completedStageIds: string[];
+    completedMissionIds: string[];
+    assessments: LearningCourseAssessmentRecordV1[];
+    completion: {
+        referenceId: string;
+        sourceDigest: string;
+        bestScore: number;
+    } | null;
+}
+/** Construct only after the host validates the activity-specific learner input. */
+interface VerifiedLearningActivityV1 {
+    stageId: string;
+    sourceDigest: string;
+    accepted: boolean;
+}
+/** Rubric and check results come from trusted assessment execution, never a save body. */
+interface LearningCourseAssessmentAuthorityV1 {
+    missionId: string;
+    assessmentId: string;
+    referenceId: string;
+    sourceDigest: string;
+    rubric: AssessmentRubricV1;
+    checks: AssessmentCheckResultV1[];
+}
+/** Parse storage-owned progress. This is not an accepted browser mutation shape. */
+declare function parseLearningCourseProgress(course: LearningCourseV1, value: unknown): LearningCourseProgressV1;
+/** Fresh course progress cannot inherit completion from project files or an old version. */
+declare function createLearningCourseProgress(course: LearningCourseV1): LearningCourseProgressV1;
+/** Saved navigation may revisit earned activities but cannot unlock later activities. */
+declare function resolveLearningCourseStage(course: LearningCourseV1, progress: LearningCourseProgressV1, requestedId: string): string;
+/**
+ * Record checks from a host-owned deterministic runner using the existing rubric
+ * calculator. A final assessment must cover the whole accumulated project.
+ * Hosts bind reference IDs and source digests to their authenticated transaction.
+ */
+declare function recordLearningCourseAssessment(course: LearningCourseV1, progress: LearningCourseProgressV1, authority: LearningCourseAssessmentAuthorityV1): LearningCourseProgressV1;
+/**
+ * Advance one verified activity. Acknowledgements alone never earn a mission or
+ * badge. Failed assessments can be inspected, but repair and reward need passing
+ * evidence for the current project. Storage must never accept this proof as-is
+ * from a browser: the host validates each activity before constructing it.
+ */
+declare function completeVerifiedLearningActivity(course: LearningCourseV1, progress: LearningCourseProgressV1, proof: VerifiedLearningActivityV1): LearningCourseProgressV1;
+
 /** Additive contract version for touch-first and spoken contextual help. */
 declare const CONTEXTUAL_HELP_CONTRACT_VERSION_V1: "1.0.0";
 declare const CONTEXTUAL_HELP_KINDS_V1: readonly ["command", "visual-block", "generated-code", "assessment-diagnostic"];
@@ -787,4 +935,4 @@ declare function validateLearningPath(path: LearningPathVersionV1): LearningVali
 /** Fail fast when a path is not safe to publish or consume. */
 declare function assertValidLearningPath(path: LearningPathVersionV1): void;
 
-export { ADVENTURE_MISSION_PLANNER_MISSION_ONE_AUTHORING_V1, type AdventureMissionPlannerSafeRenderV1, type AssessmentCheckResultV1, type AssessmentCriterionV1, type AssessmentDimensionV1, type AssessmentResultV1, type AssessmentRubricV1, type AttemptEvidenceV1, BEACON_BOT_MISSION_ONE_AUTHORING_V1, type BadgeDefinitionV1, CONTEXTUAL_HELP_CONTRACT_VERSION_V1, CONTEXTUAL_HELP_KINDS_V1, CONTEXTUAL_VOICE_INTENTS_V1, CONTEXTUAL_VOICE_SUGGESTED_ACTIONS_V1, CREATURE_CARE_DASHBOARD_MISSION_ONE_AUTHORING_V1, type CanonicalSpokenHelpDescriptorV1, type CommercialStateV1, type ContextualHelpIdentifierV1, type ContextualHelpKindV1, type ContextualVoiceAnswerV1, type ContextualVoiceIntentV1, type ContextualVoiceQuestionMetadataV1, type ContextualVoiceQuestionResultV1, type ContextualVoiceSuggestedActionV1, type CourseMaterialAudienceV1, type CourseMaterialKindV1, type CourseMaterialV1, type CourseMaterialsManifestV1, type CreatureCareDashboardSafeRenderV1, DANCE_ROVER_MISSION_ONE_AUTHORING_V1, EXTERNAL_LEARNING_CONTENT_REFERENCE_VERSION_V1, type ExternalLearningContentReferenceV1, type FacilitatorMissionAuthoringV1, type GuardianAiConsentV1, type GuardianVoiceConsentStateV1, type GuardianVoiceConsentV1, type GuardianVoiceProcessingRouteV1, type HardwareItemV1, type HardwareModeV1, type HardwareRequirementManifestV1, type HardwareVerificationStatusV1, JUNIOR_CODER_MISSION_STAGE_ORDER_V1, JUNIOR_CODER_MODULE_PRICE_V1_1, JUNIOR_CODER_PADDLE_PULSE_V2, JUNIOR_CODER_ROAD_HOPPER_RALLY_V2, JUNIOR_CODER_ROAD_HOPPER_RALLY_V2_1, JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4, type LearnerMissionAuthoringV1, type LearningGoalV1, type LearningModuleVersionV1, type LearningPathVersionV1, type LearningValidationIssueV1, METEOR_SHIELD_MISSION_ONE_AUTHORING_V1, MISSION_AUTHORING_CONTRACT_VERSION_V1, type MissionAccessibilityAlternativeV1, type MissionArtifactKindV1, type MissionArtifactReferenceV1, type MissionAuthoringBundleV1, type MissionAuthoringGoalV1, type MissionAuthoringValidationIssueV1, type MissionBoundedSuggestionV1, type MissionEvidenceKindV1, type MissionEvidenceRequirementV1, type MissionEvidenceRetentionV1, type MissionFunctionParameterV1, type MissionFunctionReferenceV1, type MissionHardwareAcquisitionScopeV1, type MissionHardwareComponentDisclosureV1, type MissionHardwareDisclosureV1, type MissionInteractionModeV1, type MissionInteractionRequirementV1, type MissionPhysicalSafeguardsV1, type MissionReadinessCheckV1, type MissionRewardBindingV1, type MissionSideAdventureV1, type MissionStageCardV1, type MissionStageKindV1, type MissionV1, type ModuleAgentDefinitionV1, type ModuleAgentFeedbackV1, type ModuleAgentRoleV1, type ModuleCategoryV1, type ModuleEntitlementV1, type ModulePricingV1, type ModuleReferencePriceV1, OBSTACLE_EXPLORER_MISSION_ONE_AUTHORING_V1, PADDLE_PULSE_EXTERNAL_CONTENT_V1, PADDLE_PULSE_MISSION_ONE_AUTHORING_V1, PIXEL_TRAIL_CHALLENGE_MISSION_ONE_AUTHORING_V1, type PublishedStaticProjectSnapshotV1, RAINBOW_RESCUE_ROVER_MISSION_ONE_AUTHORING_V1, RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1, ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1, ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V2, ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1, ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1, ROBOT_MISSION_CONTROL_MISSION_ONE_AUTHORING_V1, type RobotMissionControlSafeRenderV1, SERVO_CREATURE_MISSION_ONE_AUTHORING_V1, SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1, STAR_DEFENDER_SQUADRON_MISSION_ONE_AUTHORING_V1, STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1, STATIC_PROJECT_DEFAULT_LIFETIME_DAYS_V1, STATIC_PROJECT_MAX_SOURCE_CHARACTERS_V1, STATIC_PROJECT_PUBLISHING_CONTRACT_VERSION_V1, STATIC_PROJECT_SAFETY_CHECK_IDS_V1, STATIC_PROJECT_SCANNER_VERSION_V1, type ScoreBandV1, type StaticProjectContractIssueV1, type StaticProjectGuardianApprovalV1, type StaticProjectModuleSlugV1, type StaticProjectPublicationV1, type StaticProjectSafeRenderV1, type StaticProjectSafetyCheckIdV1, type StaticProjectSafetyCheckV1, type StaticProjectSafetyScanV1, type StaticProjectSnapshotV1, VIBE_BUG_DETECTIVE_MISSION_ONE_AUTHORING_V1, VIBE_GAME_REMIX_LAB_MISSION_ONE_AUTHORING_V1, VIBE_IDEA_STUDIO_MISSION_ONE_AUTHORING_V1, type VoiceHelpAvailabilityReasonV1, type VoiceHelpAvailabilityV1, assertValidCanonicalSpokenHelpDescriptor, assertValidContextualHelpIdentifier, assertValidContextualVoiceQuestionMetadata, assertValidContextualVoiceQuestionResult, assertValidGuardianVoiceConsent, assertValidLearningPath, assertValidMissionAuthoringBundle, assertValidStaticProjectGuardianApproval, assertValidStaticProjectPublication, assertValidStaticProjectSnapshot, assertValidVoiceHelpAvailability, calculateAssessment, isExternalLearningContentReferenceV1, validateAssessmentRubric, validateLearningPath, validateMissionAuthoringBundle, validateStaticProjectGuardianApproval, validateStaticProjectPublication, validateStaticProjectSnapshot };
+export { ADVENTURE_MISSION_PLANNER_MISSION_ONE_AUTHORING_V1, type AdventureMissionPlannerSafeRenderV1, type AssessmentCheckResultV1, type AssessmentCriterionV1, type AssessmentDimensionV1, type AssessmentResultV1, type AssessmentRubricV1, type AttemptEvidenceV1, BEACON_BOT_MISSION_ONE_AUTHORING_V1, type BadgeDefinitionV1, CONTEXTUAL_HELP_CONTRACT_VERSION_V1, CONTEXTUAL_HELP_KINDS_V1, CONTEXTUAL_VOICE_INTENTS_V1, CONTEXTUAL_VOICE_SUGGESTED_ACTIONS_V1, CREATURE_CARE_DASHBOARD_MISSION_ONE_AUTHORING_V1, type CanonicalSpokenHelpDescriptorV1, type CommercialStateV1, type ContextualHelpIdentifierV1, type ContextualHelpKindV1, type ContextualVoiceAnswerV1, type ContextualVoiceIntentV1, type ContextualVoiceQuestionMetadataV1, type ContextualVoiceQuestionResultV1, type ContextualVoiceSuggestedActionV1, type CourseMaterialAudienceV1, type CourseMaterialKindV1, type CourseMaterialV1, type CourseMaterialsManifestV1, type CreatureCareDashboardSafeRenderV1, DANCE_ROVER_MISSION_ONE_AUTHORING_V1, EXTERNAL_LEARNING_CONTENT_REFERENCE_VERSION_V1, type ExternalLearningContentReferenceV1, type FacilitatorMissionAuthoringV1, type GuardianAiConsentV1, type GuardianVoiceConsentStateV1, type GuardianVoiceConsentV1, type GuardianVoiceProcessingRouteV1, type HardwareItemV1, type HardwareModeV1, type HardwareRequirementManifestV1, type HardwareVerificationStatusV1, JUNIOR_CODER_MISSION_STAGE_ORDER_V1, JUNIOR_CODER_MODULE_PRICE_V1_1, JUNIOR_CODER_PADDLE_PULSE_V2, JUNIOR_CODER_ROAD_HOPPER_RALLY_V2, JUNIOR_CODER_ROAD_HOPPER_RALLY_V2_1, JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4, LEARNING_COURSE_LIMITS, LEARNING_COURSE_STAGE_ORDER, type LearnerMissionAuthoringV1, type LearningCourseAssessmentAuthorityV1, type LearningCourseAssessmentRecordV1, type LearningCourseDraftV1, LearningCourseInputError, type LearningCourseMissionV1, type LearningCourseProgressV1, type LearningCourseStageV1, type LearningCourseV1, type LearningCourseValidationIssueV1, type LearningGoalV1, type LearningModuleVersionV1, type LearningPathVersionV1, type LearningProjectFileV1, type LearningProjectLanguageV1, type LearningProjectV1, type LearningSaveSlotIdV1, type LearningValidationIssueV1, METEOR_SHIELD_MISSION_ONE_AUTHORING_V1, MISSION_AUTHORING_CONTRACT_VERSION_V1, type MissionAccessibilityAlternativeV1, type MissionArtifactKindV1, type MissionArtifactReferenceV1, type MissionAuthoringBundleV1, type MissionAuthoringGoalV1, type MissionAuthoringValidationIssueV1, type MissionBoundedSuggestionV1, type MissionEvidenceKindV1, type MissionEvidenceRequirementV1, type MissionEvidenceRetentionV1, type MissionFunctionParameterV1, type MissionFunctionReferenceV1, type MissionHardwareAcquisitionScopeV1, type MissionHardwareComponentDisclosureV1, type MissionHardwareDisclosureV1, type MissionInteractionModeV1, type MissionInteractionRequirementV1, type MissionPhysicalSafeguardsV1, type MissionReadinessCheckV1, type MissionRewardBindingV1, type MissionSideAdventureV1, type MissionStageCardV1, type MissionStageKindV1, type MissionV1, type ModuleAgentDefinitionV1, type ModuleAgentFeedbackV1, type ModuleAgentRoleV1, type ModuleCategoryV1, type ModuleEntitlementV1, type ModulePricingV1, type ModuleReferencePriceV1, OBSTACLE_EXPLORER_MISSION_ONE_AUTHORING_V1, PADDLE_PULSE_EXTERNAL_CONTENT_V1, PADDLE_PULSE_MISSION_ONE_AUTHORING_V1, PIXEL_TRAIL_CHALLENGE_MISSION_ONE_AUTHORING_V1, type PublishedStaticProjectSnapshotV1, RAINBOW_RESCUE_ROVER_MISSION_ONE_AUTHORING_V1, RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1, ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1, ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V2, ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1, ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1, ROBOT_MISSION_CONTROL_MISSION_ONE_AUTHORING_V1, type RobotMissionControlSafeRenderV1, SERVO_CREATURE_MISSION_ONE_AUTHORING_V1, SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1, STAR_DEFENDER_SQUADRON_MISSION_ONE_AUTHORING_V1, STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1, STATIC_PROJECT_DEFAULT_LIFETIME_DAYS_V1, STATIC_PROJECT_MAX_SOURCE_CHARACTERS_V1, STATIC_PROJECT_PUBLISHING_CONTRACT_VERSION_V1, STATIC_PROJECT_SAFETY_CHECK_IDS_V1, STATIC_PROJECT_SCANNER_VERSION_V1, type ScoreBandV1, type StaticProjectContractIssueV1, type StaticProjectGuardianApprovalV1, type StaticProjectModuleSlugV1, type StaticProjectPublicationV1, type StaticProjectSafeRenderV1, type StaticProjectSafetyCheckIdV1, type StaticProjectSafetyCheckV1, type StaticProjectSafetyScanV1, type StaticProjectSnapshotV1, VIBE_BUG_DETECTIVE_MISSION_ONE_AUTHORING_V1, VIBE_GAME_REMIX_LAB_MISSION_ONE_AUTHORING_V1, VIBE_IDEA_STUDIO_MISSION_ONE_AUTHORING_V1, type VerifiedLearningActivityV1, type VoiceHelpAvailabilityReasonV1, type VoiceHelpAvailabilityV1, assertValidCanonicalSpokenHelpDescriptor, assertValidContextualHelpIdentifier, assertValidContextualVoiceQuestionMetadata, assertValidContextualVoiceQuestionResult, assertValidGuardianVoiceConsent, assertValidLearningPath, assertValidMissionAuthoringBundle, assertValidStaticProjectGuardianApproval, assertValidStaticProjectPublication, assertValidStaticProjectSnapshot, assertValidVoiceHelpAvailability, calculateAssessment, completeVerifiedLearningActivity, createLearningCourseProgress, isExternalLearningContentReferenceV1, parseLearningCourse, parseLearningCourseDraft, parseLearningCourseProgress, parseLearningProject, parseLearningSaveSlotId, recordLearningCourseAssessment, resolveLearningCourseStage, validateAssessmentRubric, validateLearningCourse, validateLearningPath, validateMissionAuthoringBundle, validateStaticProjectGuardianApproval, validateStaticProjectPublication, validateStaticProjectSnapshot };

package/dist/index.d.ts

@@ -481,6 +481,154 @@ declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4: LearningPathVersionV1;
 /** Current pilot catalog for server adapters that intentionally follow releases. */
 declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT: LearningPathVersionV1;
 
+/** Stable activity order for complete courses; legacy authoring remains immutable. */
+declare const LEARNING_COURSE_STAGE_ORDER: readonly ["learn", "predict", "build", "run", "assess", "inspect", "fix", "explain", "reward"];
+declare const LEARNING_COURSE_LIMITS: Readonly<{
+    missions: 6;
+    stagesPerMission: 9;
+    projectFiles: 8;
+    sourceCharactersPerFile: 64000;
+    sourceCharactersPerProject: 96000;
+}>;
+type LearningProjectLanguageV1 = "javascript" | "python" | "cpp" | "html" | "css" | "blocks" | "json";
+interface LearningProjectFileV1 {
+    path: string;
+    source: string;
+}
+interface LearningProjectV1 {
+    files: LearningProjectFileV1[];
+}
+interface LearningCourseStageV1 {
+    id: string;
+    kind: MissionStageKindV1;
+    title: string;
+    instruction: string;
+    help: string;
+}
+interface LearningCourseMissionV1 {
+    id: string;
+    title: string;
+    concepts: string[];
+    estimatedMinutes: number;
+    goals: string[];
+    assessmentId: string;
+    stages: LearningCourseStageV1[];
+    extension: string;
+}
+/** Learner-safe content only. Protected scenarios and solutions are host-owned. */
+interface LearningCourseV1 {
+    schemaVersion: "1";
+    moduleId: string;
+    moduleVersion: string;
+    slug: string;
+    title: string;
+    summary: string;
+    runtimeId: string;
+    category: ModuleCategoryV1;
+    estimatedMinutes: number;
+    completionAssessmentId: string;
+    projectFiles: {
+        path: string;
+        language: LearningProjectLanguageV1;
+        maximumCharacters: number;
+    }[];
+    starterProject: LearningProjectV1;
+    reference: {
+        name: string;
+        signature: string;
+        description: string;
+        example: string;
+    }[];
+    missions: LearningCourseMissionV1[];
+    completionBadge: {
+        id: string;
+        title: string;
+    };
+}
+/** The only learner-owned save inputs. Progress/evidence are never draft authority. */
+interface LearningCourseDraftV1 {
+    schemaVersion: "1";
+    moduleVersion: string;
+    activeStageId: string;
+    project: LearningProjectV1;
+}
+type LearningSaveSlotIdV1 = "auto" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9";
+interface LearningCourseValidationIssueV1 {
+    code: "invalid-manifest" | "mission-count" | "stage-order" | "duplicate-id" | "incomplete-content" | "invalid-project";
+    path: string;
+}
+/** Errors contain no source, learner text or caller-supplied identifiers. */
+declare class LearningCourseInputError extends Error {
+    constructor();
+}
+/** Validate every file against the declared editable set; never preserve extra fields. */
+declare function parseLearningProject(course: Pick<LearningCourseV1, "projectFiles">, value: unknown): LearningProjectV1;
+/** Parse untrusted saves without accepting identity, scores, completion or evidence. */
+declare function parseLearningCourseDraft(course: LearningCourseV1, value: unknown): LearningCourseDraftV1;
+/** An account owns one autosave and nine explicitly managed slots per course version. */
+declare function parseLearningSaveSlotId(value: unknown): LearningSaveSlotIdV1;
+/** Structural publication gate. Working runtime/curriculum acceptance is additional. */
+declare function validateLearningCourse(value: unknown): LearningCourseValidationIssueV1[];
+/** Validate an external learner manifest and detach it from the supplied object. */
+declare function parseLearningCourse(value: unknown): LearningCourseV1;
+
+/** Stored host-issued assessment. No browser-supplied result may construct this authority. */
+interface LearningCourseAssessmentRecordV1 {
+    missionId: string;
+    assessmentId: string;
+    referenceId: string;
+    sourceDigest: string;
+    result: AssessmentResultV1;
+}
+/** Account and timestamps are supplied by the storage adapter, not the contract. */
+interface LearningCourseProgressV1 {
+    schemaVersion: "1";
+    moduleId: string;
+    moduleVersion: string;
+    completedStageIds: string[];
+    completedMissionIds: string[];
+    assessments: LearningCourseAssessmentRecordV1[];
+    completion: {
+        referenceId: string;
+        sourceDigest: string;
+        bestScore: number;
+    } | null;
+}
+/** Construct only after the host validates the activity-specific learner input. */
+interface VerifiedLearningActivityV1 {
+    stageId: string;
+    sourceDigest: string;
+    accepted: boolean;
+}
+/** Rubric and check results come from trusted assessment execution, never a save body. */
+interface LearningCourseAssessmentAuthorityV1 {
+    missionId: string;
+    assessmentId: string;
+    referenceId: string;
+    sourceDigest: string;
+    rubric: AssessmentRubricV1;
+    checks: AssessmentCheckResultV1[];
+}
+/** Parse storage-owned progress. This is not an accepted browser mutation shape. */
+declare function parseLearningCourseProgress(course: LearningCourseV1, value: unknown): LearningCourseProgressV1;
+/** Fresh course progress cannot inherit completion from project files or an old version. */
+declare function createLearningCourseProgress(course: LearningCourseV1): LearningCourseProgressV1;
+/** Saved navigation may revisit earned activities but cannot unlock later activities. */
+declare function resolveLearningCourseStage(course: LearningCourseV1, progress: LearningCourseProgressV1, requestedId: string): string;
+/**
+ * Record checks from a host-owned deterministic runner using the existing rubric
+ * calculator. A final assessment must cover the whole accumulated project.
+ * Hosts bind reference IDs and source digests to their authenticated transaction.
+ */
+declare function recordLearningCourseAssessment(course: LearningCourseV1, progress: LearningCourseProgressV1, authority: LearningCourseAssessmentAuthorityV1): LearningCourseProgressV1;
+/**
+ * Advance one verified activity. Acknowledgements alone never earn a mission or
+ * badge. Failed assessments can be inspected, but repair and reward need passing
+ * evidence for the current project. Storage must never accept this proof as-is
+ * from a browser: the host validates each activity before constructing it.
+ */
+declare function completeVerifiedLearningActivity(course: LearningCourseV1, progress: LearningCourseProgressV1, proof: VerifiedLearningActivityV1): LearningCourseProgressV1;
+
 /** Additive contract version for touch-first and spoken contextual help. */
 declare const CONTEXTUAL_HELP_CONTRACT_VERSION_V1: "1.0.0";
 declare const CONTEXTUAL_HELP_KINDS_V1: readonly ["command", "visual-block", "generated-code", "assessment-diagnostic"];
@@ -787,4 +935,4 @@ declare function validateLearningPath(path: LearningPathVersionV1): LearningVali
 /** Fail fast when a path is not safe to publish or consume. */
 declare function assertValidLearningPath(path: LearningPathVersionV1): void;
 
-export { ADVENTURE_MISSION_PLANNER_MISSION_ONE_AUTHORING_V1, type AdventureMissionPlannerSafeRenderV1, type AssessmentCheckResultV1, type AssessmentCriterionV1, type AssessmentDimensionV1, type AssessmentResultV1, type AssessmentRubricV1, type AttemptEvidenceV1, BEACON_BOT_MISSION_ONE_AUTHORING_V1, type BadgeDefinitionV1, CONTEXTUAL_HELP_CONTRACT_VERSION_V1, CONTEXTUAL_HELP_KINDS_V1, CONTEXTUAL_VOICE_INTENTS_V1, CONTEXTUAL_VOICE_SUGGESTED_ACTIONS_V1, CREATURE_CARE_DASHBOARD_MISSION_ONE_AUTHORING_V1, type CanonicalSpokenHelpDescriptorV1, type CommercialStateV1, type ContextualHelpIdentifierV1, type ContextualHelpKindV1, type ContextualVoiceAnswerV1, type ContextualVoiceIntentV1, type ContextualVoiceQuestionMetadataV1, type ContextualVoiceQuestionResultV1, type ContextualVoiceSuggestedActionV1, type CourseMaterialAudienceV1, type CourseMaterialKindV1, type CourseMaterialV1, type CourseMaterialsManifestV1, type CreatureCareDashboardSafeRenderV1, DANCE_ROVER_MISSION_ONE_AUTHORING_V1, EXTERNAL_LEARNING_CONTENT_REFERENCE_VERSION_V1, type ExternalLearningContentReferenceV1, type FacilitatorMissionAuthoringV1, type GuardianAiConsentV1, type GuardianVoiceConsentStateV1, type GuardianVoiceConsentV1, type GuardianVoiceProcessingRouteV1, type HardwareItemV1, type HardwareModeV1, type HardwareRequirementManifestV1, type HardwareVerificationStatusV1, JUNIOR_CODER_MISSION_STAGE_ORDER_V1, JUNIOR_CODER_MODULE_PRICE_V1_1, JUNIOR_CODER_PADDLE_PULSE_V2, JUNIOR_CODER_ROAD_HOPPER_RALLY_V2, JUNIOR_CODER_ROAD_HOPPER_RALLY_V2_1, JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4, type LearnerMissionAuthoringV1, type LearningGoalV1, type LearningModuleVersionV1, type LearningPathVersionV1, type LearningValidationIssueV1, METEOR_SHIELD_MISSION_ONE_AUTHORING_V1, MISSION_AUTHORING_CONTRACT_VERSION_V1, type MissionAccessibilityAlternativeV1, type MissionArtifactKindV1, type MissionArtifactReferenceV1, type MissionAuthoringBundleV1, type MissionAuthoringGoalV1, type MissionAuthoringValidationIssueV1, type MissionBoundedSuggestionV1, type MissionEvidenceKindV1, type MissionEvidenceRequirementV1, type MissionEvidenceRetentionV1, type MissionFunctionParameterV1, type MissionFunctionReferenceV1, type MissionHardwareAcquisitionScopeV1, type MissionHardwareComponentDisclosureV1, type MissionHardwareDisclosureV1, type MissionInteractionModeV1, type MissionInteractionRequirementV1, type MissionPhysicalSafeguardsV1, type MissionReadinessCheckV1, type MissionRewardBindingV1, type MissionSideAdventureV1, type MissionStageCardV1, type MissionStageKindV1, type MissionV1, type ModuleAgentDefinitionV1, type ModuleAgentFeedbackV1, type ModuleAgentRoleV1, type ModuleCategoryV1, type ModuleEntitlementV1, type ModulePricingV1, type ModuleReferencePriceV1, OBSTACLE_EXPLORER_MISSION_ONE_AUTHORING_V1, PADDLE_PULSE_EXTERNAL_CONTENT_V1, PADDLE_PULSE_MISSION_ONE_AUTHORING_V1, PIXEL_TRAIL_CHALLENGE_MISSION_ONE_AUTHORING_V1, type PublishedStaticProjectSnapshotV1, RAINBOW_RESCUE_ROVER_MISSION_ONE_AUTHORING_V1, RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1, ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1, ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V2, ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1, ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1, ROBOT_MISSION_CONTROL_MISSION_ONE_AUTHORING_V1, type RobotMissionControlSafeRenderV1, SERVO_CREATURE_MISSION_ONE_AUTHORING_V1, SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1, STAR_DEFENDER_SQUADRON_MISSION_ONE_AUTHORING_V1, STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1, STATIC_PROJECT_DEFAULT_LIFETIME_DAYS_V1, STATIC_PROJECT_MAX_SOURCE_CHARACTERS_V1, STATIC_PROJECT_PUBLISHING_CONTRACT_VERSION_V1, STATIC_PROJECT_SAFETY_CHECK_IDS_V1, STATIC_PROJECT_SCANNER_VERSION_V1, type ScoreBandV1, type StaticProjectContractIssueV1, type StaticProjectGuardianApprovalV1, type StaticProjectModuleSlugV1, type StaticProjectPublicationV1, type StaticProjectSafeRenderV1, type StaticProjectSafetyCheckIdV1, type StaticProjectSafetyCheckV1, type StaticProjectSafetyScanV1, type StaticProjectSnapshotV1, VIBE_BUG_DETECTIVE_MISSION_ONE_AUTHORING_V1, VIBE_GAME_REMIX_LAB_MISSION_ONE_AUTHORING_V1, VIBE_IDEA_STUDIO_MISSION_ONE_AUTHORING_V1, type VoiceHelpAvailabilityReasonV1, type VoiceHelpAvailabilityV1, assertValidCanonicalSpokenHelpDescriptor, assertValidContextualHelpIdentifier, assertValidContextualVoiceQuestionMetadata, assertValidContextualVoiceQuestionResult, assertValidGuardianVoiceConsent, assertValidLearningPath, assertValidMissionAuthoringBundle, assertValidStaticProjectGuardianApproval, assertValidStaticProjectPublication, assertValidStaticProjectSnapshot, assertValidVoiceHelpAvailability, calculateAssessment, isExternalLearningContentReferenceV1, validateAssessmentRubric, validateLearningPath, validateMissionAuthoringBundle, validateStaticProjectGuardianApproval, validateStaticProjectPublication, validateStaticProjectSnapshot };
+export { ADVENTURE_MISSION_PLANNER_MISSION_ONE_AUTHORING_V1, type AdventureMissionPlannerSafeRenderV1, type AssessmentCheckResultV1, type AssessmentCriterionV1, type AssessmentDimensionV1, type AssessmentResultV1, type AssessmentRubricV1, type AttemptEvidenceV1, BEACON_BOT_MISSION_ONE_AUTHORING_V1, type BadgeDefinitionV1, CONTEXTUAL_HELP_CONTRACT_VERSION_V1, CONTEXTUAL_HELP_KINDS_V1, CONTEXTUAL_VOICE_INTENTS_V1, CONTEXTUAL_VOICE_SUGGESTED_ACTIONS_V1, CREATURE_CARE_DASHBOARD_MISSION_ONE_AUTHORING_V1, type CanonicalSpokenHelpDescriptorV1, type CommercialStateV1, type ContextualHelpIdentifierV1, type ContextualHelpKindV1, type ContextualVoiceAnswerV1, type ContextualVoiceIntentV1, type ContextualVoiceQuestionMetadataV1, type ContextualVoiceQuestionResultV1, type ContextualVoiceSuggestedActionV1, type CourseMaterialAudienceV1, type CourseMaterialKindV1, type CourseMaterialV1, type CourseMaterialsManifestV1, type CreatureCareDashboardSafeRenderV1, DANCE_ROVER_MISSION_ONE_AUTHORING_V1, EXTERNAL_LEARNING_CONTENT_REFERENCE_VERSION_V1, type ExternalLearningContentReferenceV1, type FacilitatorMissionAuthoringV1, type GuardianAiConsentV1, type GuardianVoiceConsentStateV1, type GuardianVoiceConsentV1, type GuardianVoiceProcessingRouteV1, type HardwareItemV1, type HardwareModeV1, type HardwareRequirementManifestV1, type HardwareVerificationStatusV1, JUNIOR_CODER_MISSION_STAGE_ORDER_V1, JUNIOR_CODER_MODULE_PRICE_V1_1, JUNIOR_CODER_PADDLE_PULSE_V2, JUNIOR_CODER_ROAD_HOPPER_RALLY_V2, JUNIOR_CODER_ROAD_HOPPER_RALLY_V2_1, JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4, LEARNING_COURSE_LIMITS, LEARNING_COURSE_STAGE_ORDER, type LearnerMissionAuthoringV1, type LearningCourseAssessmentAuthorityV1, type LearningCourseAssessmentRecordV1, type LearningCourseDraftV1, LearningCourseInputError, type LearningCourseMissionV1, type LearningCourseProgressV1, type LearningCourseStageV1, type LearningCourseV1, type LearningCourseValidationIssueV1, type LearningGoalV1, type LearningModuleVersionV1, type LearningPathVersionV1, type LearningProjectFileV1, type LearningProjectLanguageV1, type LearningProjectV1, type LearningSaveSlotIdV1, type LearningValidationIssueV1, METEOR_SHIELD_MISSION_ONE_AUTHORING_V1, MISSION_AUTHORING_CONTRACT_VERSION_V1, type MissionAccessibilityAlternativeV1, type MissionArtifactKindV1, type MissionArtifactReferenceV1, type MissionAuthoringBundleV1, type MissionAuthoringGoalV1, type MissionAuthoringValidationIssueV1, type MissionBoundedSuggestionV1, type MissionEvidenceKindV1, type MissionEvidenceRequirementV1, type MissionEvidenceRetentionV1, type MissionFunctionParameterV1, type MissionFunctionReferenceV1, type MissionHardwareAcquisitionScopeV1, type MissionHardwareComponentDisclosureV1, type MissionHardwareDisclosureV1, type MissionInteractionModeV1, type MissionInteractionRequirementV1, type MissionPhysicalSafeguardsV1, type MissionReadinessCheckV1, type MissionRewardBindingV1, type MissionSideAdventureV1, type MissionStageCardV1, type MissionStageKindV1, type MissionV1, type ModuleAgentDefinitionV1, type ModuleAgentFeedbackV1, type ModuleAgentRoleV1, type ModuleCategoryV1, type ModuleEntitlementV1, type ModulePricingV1, type ModuleReferencePriceV1, OBSTACLE_EXPLORER_MISSION_ONE_AUTHORING_V1, PADDLE_PULSE_EXTERNAL_CONTENT_V1, PADDLE_PULSE_MISSION_ONE_AUTHORING_V1, PIXEL_TRAIL_CHALLENGE_MISSION_ONE_AUTHORING_V1, type PublishedStaticProjectSnapshotV1, RAINBOW_RESCUE_ROVER_MISSION_ONE_AUTHORING_V1, RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1, ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1, ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V2, ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1, ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1, ROBOT_MISSION_CONTROL_MISSION_ONE_AUTHORING_V1, type RobotMissionControlSafeRenderV1, SERVO_CREATURE_MISSION_ONE_AUTHORING_V1, SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1, STAR_DEFENDER_SQUADRON_MISSION_ONE_AUTHORING_V1, STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1, STATIC_PROJECT_DEFAULT_LIFETIME_DAYS_V1, STATIC_PROJECT_MAX_SOURCE_CHARACTERS_V1, STATIC_PROJECT_PUBLISHING_CONTRACT_VERSION_V1, STATIC_PROJECT_SAFETY_CHECK_IDS_V1, STATIC_PROJECT_SCANNER_VERSION_V1, type ScoreBandV1, type StaticProjectContractIssueV1, type StaticProjectGuardianApprovalV1, type StaticProjectModuleSlugV1, type StaticProjectPublicationV1, type StaticProjectSafeRenderV1, type StaticProjectSafetyCheckIdV1, type StaticProjectSafetyCheckV1, type StaticProjectSafetyScanV1, type StaticProjectSnapshotV1, VIBE_BUG_DETECTIVE_MISSION_ONE_AUTHORING_V1, VIBE_GAME_REMIX_LAB_MISSION_ONE_AUTHORING_V1, VIBE_IDEA_STUDIO_MISSION_ONE_AUTHORING_V1, type VerifiedLearningActivityV1, type VoiceHelpAvailabilityReasonV1, type VoiceHelpAvailabilityV1, assertValidCanonicalSpokenHelpDescriptor, assertValidContextualHelpIdentifier, assertValidContextualVoiceQuestionMetadata, assertValidContextualVoiceQuestionResult, assertValidGuardianVoiceConsent, assertValidLearningPath, assertValidMissionAuthoringBundle, assertValidStaticProjectGuardianApproval, assertValidStaticProjectPublication, assertValidStaticProjectSnapshot, assertValidVoiceHelpAvailability, calculateAssessment, completeVerifiedLearningActivity, createLearningCourseProgress, isExternalLearningContentReferenceV1, parseLearningCourse, parseLearningCourseDraft, parseLearningCourseProgress, parseLearningProject, parseLearningSaveSlotId, recordLearningCourseAssessment, resolveLearningCourseStage, validateAssessmentRubric, validateLearningCourse, validateLearningPath, validateMissionAuthoringBundle, validateStaticProjectGuardianApproval, validateStaticProjectPublication, validateStaticProjectSnapshot };