@plasius/learning 0.2.20 → 0.2.22

package/dist/index.d.cts

@@ -142,6 +142,20 @@ interface BadgeDefinitionV1 {
     tradeable: false;
     tokenConvertible: false;
 }
+/** Immutable package export selected by the catalog without importing it. */
+declare const EXTERNAL_LEARNING_CONTENT_REFERENCE_VERSION_V1: "1";
+interface ExternalLearningContentReferenceV1 {
+    /** Exact public package name; ranges and aliases are not permitted. */
+    packageName: string;
+    /** Exact semantic version without a range operator. */
+    packageVersion: string;
+    /** Named ESM/CJS export containing the immutable content manifest. */
+    exportName: string;
+    /** Exact schema version declared by the referenced exported manifest. */
+    schemaVersion: string;
+    /** Lower-case SHA-256 of the canonical exported manifest JSON. */
+    sha256: string;
+}
 /** One immutable, independently sellable module version. */
 interface LearningModuleVersionV1 {
     id: string;
@@ -163,6 +177,8 @@ interface LearningModuleVersionV1 {
     assessment: AssessmentRubricV1;
     agents: ModuleAgentDefinitionV1[];
     badges: BadgeDefinitionV1[];
+    /** Optional separately released content implementation pinned by digest. */
+    externalContent?: ExternalLearningContentReferenceV1;
 }
 /** A versioned path is a recommendation and never a paid prerequisite chain. */
 interface LearningPathVersionV1 {
@@ -389,7 +405,7 @@ interface MissionAuthoringValidationIssueV1 {
     path: string;
 }
 interface LearningValidationIssueV1 {
-    code: "duplicate-module-id" | "duplicate-module-slug" | "module-not-self-contained" | "paid-prerequisite" | "missing-materials" | "facilitator-material-leak" | "learner-material-leak" | "invalid-token-subunits" | "invalid-reference-price" | "rubric-total" | "rubric-dimension-total" | "duplicate-criterion-id" | "missing-mandatory-safety" | "missing-hardware-items" | "invalid-agent-authority" | "missing-missions";
+    code: "duplicate-module-id" | "duplicate-module-slug" | "module-not-self-contained" | "paid-prerequisite" | "missing-materials" | "facilitator-material-leak" | "learner-material-leak" | "invalid-token-subunits" | "invalid-reference-price" | "rubric-total" | "rubric-dimension-total" | "duplicate-criterion-id" | "missing-mandatory-safety" | "missing-hardware-items" | "invalid-agent-authority" | "missing-missions" | "invalid-external-content-reference";
     message: string;
     moduleId?: string;
     path: string;
@@ -426,9 +442,136 @@ declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_V1: LearningPathVersionV1;
  * without altering previously published records.
  */
 declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1: LearningPathVersionV1;
+/** Digest-pinned content package for the independently released 54-stage course. */
+declare const ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1: Readonly<{
+    packageName: "@plasius/learning-road-hopper-rally";
+    packageVersion: "1.0.0";
+    exportName: "ROAD_HOPPER_RALLY_COURSE_V2";
+    schemaVersion: "2";
+    sha256: "1a20741beba028004e0be527d05aae2b2881082d3b578e0d62308a59bf1323f0";
+}>;
+/** Road Hopper Rally 2.0 catalog record; course data stays in the referenced package. */
+declare const JUNIOR_CODER_ROAD_HOPPER_RALLY_V2: LearningModuleVersionV1;
+/** Mixed-version successor: Road Hopper 2.0 plus every other immutable 1.1 module. */
+declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2: LearningPathVersionV1;
+/** Digest-pinned Paddle Pulse 2.0 reference-module content. */
+declare const PADDLE_PULSE_EXTERNAL_CONTENT_V1: Readonly<{
+    packageName: "@plasius/learning-paddle-pulse";
+    packageVersion: "0.1.0";
+    exportName: "PADDLE_PULSE_MODULE_V2";
+    schemaVersion: "2";
+    sha256: "19f3666bdb523a3faf069341b0bc748996b3db282f89171e3c9f0a373a8c8f7e";
+}>;
+/** Paddle Pulse 2.0 catalog record; executable content stays in its package. */
+declare const JUNIOR_CODER_PADDLE_PULSE_V2: LearningModuleVersionV1;
+/** Mixed-version successor adding Paddle Pulse 2.0 without mutating v1.1. */
+declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3: LearningPathVersionV1;
 /** Current pilot catalog for server adapters that intentionally follow releases. */
 declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT: LearningPathVersionV1;
 
+/** 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"];
+type ContextualHelpKindV1 = (typeof CONTEXTUAL_HELP_KINDS_V1)[number];
+/**
+ * Opaque, manifest-bound identifier. It contains no source, transcript,
+ * learner identity or arbitrary synthesis text.
+ */
+interface ContextualHelpIdentifierV1 {
+    readonly schemaVersion: "1";
+    readonly contractVersion: typeof CONTEXTUAL_HELP_CONTRACT_VERSION_V1;
+    readonly kind: ContextualHelpKindV1;
+    readonly moduleId: string;
+    readonly moduleVersion: string;
+    readonly manifestVersion: string;
+    readonly helpId: string;
+}
+type GuardianVoiceConsentStateV1 = "granted" | "withdrawn";
+type GuardianVoiceProcessingRouteV1 = "private-edge-only";
+/** Voice consent is deliberately separate from general AI consent. */
+interface GuardianVoiceConsentV1 {
+    readonly schemaVersion: "1";
+    readonly actorAccountId: string;
+    readonly subjectAccountId: string;
+    readonly policyVersion: string;
+    readonly state: GuardianVoiceConsentStateV1;
+    readonly permittedProcessingRoute: GuardianVoiceProcessingRouteV1;
+    readonly recordedAt: string;
+}
+type VoiceHelpAvailabilityReasonV1 = "available" | "module-access-required" | "guardian-consent-required" | "guardian-consent-withdrawn" | "age-or-safeguarding-gate" | "capability-disabled" | "rollout-disabled" | "private-edge-unavailable";
+/** Read-aloud and microphone availability are evaluated independently. */
+interface VoiceHelpAvailabilityV1 {
+    readonly schemaVersion: "1";
+    readonly readAloudAvailable: boolean;
+    readonly microphoneAvailable: boolean;
+    readonly microphoneReason: VoiceHelpAvailabilityReasonV1;
+    readonly questionProcessingRoute: GuardianVoiceProcessingRouteV1;
+    readonly guardianVoiceConsentRequired: true;
+    readonly maximumRecordingDurationMs: 10_000;
+    readonly maximumAudioBytes: 2_097_152;
+    readonly rawAudioRetention: "request-memory-only";
+    readonly transcriptRetention: "request-memory-only";
+}
+/** Metadata accepted beside an authenticated multipart audio upload. */
+interface ContextualVoiceQuestionMetadataV1 {
+    readonly schemaVersion: "1";
+    readonly help: ContextualHelpIdentifierV1;
+    readonly locale: string;
+    readonly mediaType: string;
+    readonly durationMs: number;
+    readonly audioBytes: number;
+    readonly assessmentEvidenceId?: string;
+}
+declare const CONTEXTUAL_VOICE_INTENTS_V1: readonly ["describe-command", "describe-inputs", "show-example", "explain-assessment-failure", "suggest-next-experiment", "repeat", "stop", "unresolved"];
+type ContextualVoiceIntentV1 = (typeof CONTEXTUAL_VOICE_INTENTS_V1)[number];
+type ContextualVoiceSuggestedActionV1 = "open-help" | "insert-example" | "show-inputs" | "show-assessment-evidence" | "try-next-experiment" | "repeat" | "stop" | "type-question";
+declare const CONTEXTUAL_VOICE_SUGGESTED_ACTIONS_V1: readonly ["open-help", "insert-example", "show-inputs", "show-assessment-evidence", "try-next-experiment", "repeat", "stop", "type-question"];
+interface ContextualVoiceAnswerV1 {
+    readonly helpId: string;
+    readonly source: "module-documentation" | "assessment-evidence" | "authored-fallback";
+    /** Server-resolved visible answer; never a model-authored open response. */
+    readonly text: string;
+}
+/**
+ * The transcript is returned only so the learner can verify recognition. The
+ * request boundary must use no-store and discard it after the current view.
+ */
+interface ContextualVoiceQuestionResultV1 {
+    readonly schemaVersion: "1";
+    readonly help: ContextualHelpIdentifierV1;
+    readonly intent: ContextualVoiceIntentV1;
+    readonly status: "resolved" | "suggestions" | "stopped";
+    readonly transientTranscript: string;
+    readonly transcriptRetention: "request-memory-only";
+    readonly answer?: ContextualVoiceAnswerV1;
+    readonly suggestedActions: ContextualVoiceSuggestedActionV1[];
+    readonly mayAssignScore: false;
+    readonly mayAwardReward: false;
+    readonly mayPublish: false;
+    readonly mayControlHardware: false;
+}
+/** Canonical audio lookup metadata. Authoritative speech text stays server-side. */
+interface CanonicalSpokenHelpDescriptorV1 {
+    readonly schemaVersion: "1";
+    readonly help: ContextualHelpIdentifierV1;
+    readonly canonicalTextId: string;
+    readonly authoritativeTextDigest: `sha256:${string}`;
+    readonly locale: string;
+    readonly voiceProfile: string;
+    readonly pronunciationVersion: string;
+    readonly utteranceClass: "system-generic";
+    readonly sharingScope: "global";
+    readonly reuse: "exact-only";
+    readonly containsPersonalData: false;
+    readonly containsLearnerContent: false;
+}
+declare function assertValidContextualHelpIdentifier(value: ContextualHelpIdentifierV1): void;
+declare function assertValidGuardianVoiceConsent(value: GuardianVoiceConsentV1): void;
+declare function assertValidContextualVoiceQuestionMetadata(value: ContextualVoiceQuestionMetadataV1): void;
+declare function assertValidVoiceHelpAvailability(value: VoiceHelpAvailabilityV1): void;
+declare function assertValidCanonicalSpokenHelpDescriptor(value: CanonicalSpokenHelpDescriptorV1): void;
+declare function assertValidContextualVoiceQuestionResult(value: ContextualVoiceQuestionResultV1): void;
+
 /** Versioned, infrastructure-neutral contracts for Guardian-approved static projects. */
 declare const STATIC_PROJECT_PUBLISHING_CONTRACT_VERSION_V1: "1.0.0";
 declare const STATIC_PROJECT_SCANNER_VERSION_V1: "junior-coder-static-scan-v1";
@@ -625,9 +768,11 @@ declare const ROBOT_MISSION_CONTROL_MISSION_ONE_AUTHORING_V1: MissionAuthoringBu
 declare const ADVENTURE_MISSION_PLANNER_MISSION_ONE_AUTHORING_V1: MissionAuthoringBundleV1;
 declare const ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1: MissionAuthoringBundleV1;
 
+/** Runtime guard for digest-pinned external learning content references. */
+declare function isExternalLearningContentReferenceV1(value: unknown): value is ExternalLearningContentReferenceV1;
 /** Return every catalog issue without throwing, suitable for authoring tools. */
 declare function validateLearningPath(path: LearningPathVersionV1): LearningValidationIssueV1[];
 /** 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, CREATURE_CARE_DASHBOARD_MISSION_ONE_AUTHORING_V1, type CommercialStateV1, type CourseMaterialAudienceV1, type CourseMaterialKindV1, type CourseMaterialV1, type CourseMaterialsManifestV1, type CreatureCareDashboardSafeRenderV1, DANCE_ROVER_MISSION_ONE_AUTHORING_V1, type FacilitatorMissionAuthoringV1, type GuardianAiConsentV1, type HardwareItemV1, type HardwareModeV1, type HardwareRequirementManifestV1, type HardwareVerificationStatusV1, JUNIOR_CODER_MISSION_STAGE_ORDER_V1, JUNIOR_CODER_MODULE_PRICE_V1_1, JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1, 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_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_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, assertValidLearningPath, assertValidMissionAuthoringBundle, assertValidStaticProjectGuardianApproval, assertValidStaticProjectPublication, assertValidStaticProjectSnapshot, calculateAssessment, 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_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, 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_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 };

package/dist/index.d.ts

@@ -142,6 +142,20 @@ interface BadgeDefinitionV1 {
     tradeable: false;
     tokenConvertible: false;
 }
+/** Immutable package export selected by the catalog without importing it. */
+declare const EXTERNAL_LEARNING_CONTENT_REFERENCE_VERSION_V1: "1";
+interface ExternalLearningContentReferenceV1 {
+    /** Exact public package name; ranges and aliases are not permitted. */
+    packageName: string;
+    /** Exact semantic version without a range operator. */
+    packageVersion: string;
+    /** Named ESM/CJS export containing the immutable content manifest. */
+    exportName: string;
+    /** Exact schema version declared by the referenced exported manifest. */
+    schemaVersion: string;
+    /** Lower-case SHA-256 of the canonical exported manifest JSON. */
+    sha256: string;
+}
 /** One immutable, independently sellable module version. */
 interface LearningModuleVersionV1 {
     id: string;
@@ -163,6 +177,8 @@ interface LearningModuleVersionV1 {
     assessment: AssessmentRubricV1;
     agents: ModuleAgentDefinitionV1[];
     badges: BadgeDefinitionV1[];
+    /** Optional separately released content implementation pinned by digest. */
+    externalContent?: ExternalLearningContentReferenceV1;
 }
 /** A versioned path is a recommendation and never a paid prerequisite chain. */
 interface LearningPathVersionV1 {
@@ -389,7 +405,7 @@ interface MissionAuthoringValidationIssueV1 {
     path: string;
 }
 interface LearningValidationIssueV1 {
-    code: "duplicate-module-id" | "duplicate-module-slug" | "module-not-self-contained" | "paid-prerequisite" | "missing-materials" | "facilitator-material-leak" | "learner-material-leak" | "invalid-token-subunits" | "invalid-reference-price" | "rubric-total" | "rubric-dimension-total" | "duplicate-criterion-id" | "missing-mandatory-safety" | "missing-hardware-items" | "invalid-agent-authority" | "missing-missions";
+    code: "duplicate-module-id" | "duplicate-module-slug" | "module-not-self-contained" | "paid-prerequisite" | "missing-materials" | "facilitator-material-leak" | "learner-material-leak" | "invalid-token-subunits" | "invalid-reference-price" | "rubric-total" | "rubric-dimension-total" | "duplicate-criterion-id" | "missing-mandatory-safety" | "missing-hardware-items" | "invalid-agent-authority" | "missing-missions" | "invalid-external-content-reference";
     message: string;
     moduleId?: string;
     path: string;
@@ -426,9 +442,136 @@ declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_V1: LearningPathVersionV1;
  * without altering previously published records.
  */
 declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1: LearningPathVersionV1;
+/** Digest-pinned content package for the independently released 54-stage course. */
+declare const ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1: Readonly<{
+    packageName: "@plasius/learning-road-hopper-rally";
+    packageVersion: "1.0.0";
+    exportName: "ROAD_HOPPER_RALLY_COURSE_V2";
+    schemaVersion: "2";
+    sha256: "1a20741beba028004e0be527d05aae2b2881082d3b578e0d62308a59bf1323f0";
+}>;
+/** Road Hopper Rally 2.0 catalog record; course data stays in the referenced package. */
+declare const JUNIOR_CODER_ROAD_HOPPER_RALLY_V2: LearningModuleVersionV1;
+/** Mixed-version successor: Road Hopper 2.0 plus every other immutable 1.1 module. */
+declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2: LearningPathVersionV1;
+/** Digest-pinned Paddle Pulse 2.0 reference-module content. */
+declare const PADDLE_PULSE_EXTERNAL_CONTENT_V1: Readonly<{
+    packageName: "@plasius/learning-paddle-pulse";
+    packageVersion: "0.1.0";
+    exportName: "PADDLE_PULSE_MODULE_V2";
+    schemaVersion: "2";
+    sha256: "19f3666bdb523a3faf069341b0bc748996b3db282f89171e3c9f0a373a8c8f7e";
+}>;
+/** Paddle Pulse 2.0 catalog record; executable content stays in its package. */
+declare const JUNIOR_CODER_PADDLE_PULSE_V2: LearningModuleVersionV1;
+/** Mixed-version successor adding Paddle Pulse 2.0 without mutating v1.1. */
+declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3: LearningPathVersionV1;
 /** Current pilot catalog for server adapters that intentionally follow releases. */
 declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT: LearningPathVersionV1;
 
+/** 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"];
+type ContextualHelpKindV1 = (typeof CONTEXTUAL_HELP_KINDS_V1)[number];
+/**
+ * Opaque, manifest-bound identifier. It contains no source, transcript,
+ * learner identity or arbitrary synthesis text.
+ */
+interface ContextualHelpIdentifierV1 {
+    readonly schemaVersion: "1";
+    readonly contractVersion: typeof CONTEXTUAL_HELP_CONTRACT_VERSION_V1;
+    readonly kind: ContextualHelpKindV1;
+    readonly moduleId: string;
+    readonly moduleVersion: string;
+    readonly manifestVersion: string;
+    readonly helpId: string;
+}
+type GuardianVoiceConsentStateV1 = "granted" | "withdrawn";
+type GuardianVoiceProcessingRouteV1 = "private-edge-only";
+/** Voice consent is deliberately separate from general AI consent. */
+interface GuardianVoiceConsentV1 {
+    readonly schemaVersion: "1";
+    readonly actorAccountId: string;
+    readonly subjectAccountId: string;
+    readonly policyVersion: string;
+    readonly state: GuardianVoiceConsentStateV1;
+    readonly permittedProcessingRoute: GuardianVoiceProcessingRouteV1;
+    readonly recordedAt: string;
+}
+type VoiceHelpAvailabilityReasonV1 = "available" | "module-access-required" | "guardian-consent-required" | "guardian-consent-withdrawn" | "age-or-safeguarding-gate" | "capability-disabled" | "rollout-disabled" | "private-edge-unavailable";
+/** Read-aloud and microphone availability are evaluated independently. */
+interface VoiceHelpAvailabilityV1 {
+    readonly schemaVersion: "1";
+    readonly readAloudAvailable: boolean;
+    readonly microphoneAvailable: boolean;
+    readonly microphoneReason: VoiceHelpAvailabilityReasonV1;
+    readonly questionProcessingRoute: GuardianVoiceProcessingRouteV1;
+    readonly guardianVoiceConsentRequired: true;
+    readonly maximumRecordingDurationMs: 10_000;
+    readonly maximumAudioBytes: 2_097_152;
+    readonly rawAudioRetention: "request-memory-only";
+    readonly transcriptRetention: "request-memory-only";
+}
+/** Metadata accepted beside an authenticated multipart audio upload. */
+interface ContextualVoiceQuestionMetadataV1 {
+    readonly schemaVersion: "1";
+    readonly help: ContextualHelpIdentifierV1;
+    readonly locale: string;
+    readonly mediaType: string;
+    readonly durationMs: number;
+    readonly audioBytes: number;
+    readonly assessmentEvidenceId?: string;
+}
+declare const CONTEXTUAL_VOICE_INTENTS_V1: readonly ["describe-command", "describe-inputs", "show-example", "explain-assessment-failure", "suggest-next-experiment", "repeat", "stop", "unresolved"];
+type ContextualVoiceIntentV1 = (typeof CONTEXTUAL_VOICE_INTENTS_V1)[number];
+type ContextualVoiceSuggestedActionV1 = "open-help" | "insert-example" | "show-inputs" | "show-assessment-evidence" | "try-next-experiment" | "repeat" | "stop" | "type-question";
+declare const CONTEXTUAL_VOICE_SUGGESTED_ACTIONS_V1: readonly ["open-help", "insert-example", "show-inputs", "show-assessment-evidence", "try-next-experiment", "repeat", "stop", "type-question"];
+interface ContextualVoiceAnswerV1 {
+    readonly helpId: string;
+    readonly source: "module-documentation" | "assessment-evidence" | "authored-fallback";
+    /** Server-resolved visible answer; never a model-authored open response. */
+    readonly text: string;
+}
+/**
+ * The transcript is returned only so the learner can verify recognition. The
+ * request boundary must use no-store and discard it after the current view.
+ */
+interface ContextualVoiceQuestionResultV1 {
+    readonly schemaVersion: "1";
+    readonly help: ContextualHelpIdentifierV1;
+    readonly intent: ContextualVoiceIntentV1;
+    readonly status: "resolved" | "suggestions" | "stopped";
+    readonly transientTranscript: string;
+    readonly transcriptRetention: "request-memory-only";
+    readonly answer?: ContextualVoiceAnswerV1;
+    readonly suggestedActions: ContextualVoiceSuggestedActionV1[];
+    readonly mayAssignScore: false;
+    readonly mayAwardReward: false;
+    readonly mayPublish: false;
+    readonly mayControlHardware: false;
+}
+/** Canonical audio lookup metadata. Authoritative speech text stays server-side. */
+interface CanonicalSpokenHelpDescriptorV1 {
+    readonly schemaVersion: "1";
+    readonly help: ContextualHelpIdentifierV1;
+    readonly canonicalTextId: string;
+    readonly authoritativeTextDigest: `sha256:${string}`;
+    readonly locale: string;
+    readonly voiceProfile: string;
+    readonly pronunciationVersion: string;
+    readonly utteranceClass: "system-generic";
+    readonly sharingScope: "global";
+    readonly reuse: "exact-only";
+    readonly containsPersonalData: false;
+    readonly containsLearnerContent: false;
+}
+declare function assertValidContextualHelpIdentifier(value: ContextualHelpIdentifierV1): void;
+declare function assertValidGuardianVoiceConsent(value: GuardianVoiceConsentV1): void;
+declare function assertValidContextualVoiceQuestionMetadata(value: ContextualVoiceQuestionMetadataV1): void;
+declare function assertValidVoiceHelpAvailability(value: VoiceHelpAvailabilityV1): void;
+declare function assertValidCanonicalSpokenHelpDescriptor(value: CanonicalSpokenHelpDescriptorV1): void;
+declare function assertValidContextualVoiceQuestionResult(value: ContextualVoiceQuestionResultV1): void;
+
 /** Versioned, infrastructure-neutral contracts for Guardian-approved static projects. */
 declare const STATIC_PROJECT_PUBLISHING_CONTRACT_VERSION_V1: "1.0.0";
 declare const STATIC_PROJECT_SCANNER_VERSION_V1: "junior-coder-static-scan-v1";
@@ -625,9 +768,11 @@ declare const ROBOT_MISSION_CONTROL_MISSION_ONE_AUTHORING_V1: MissionAuthoringBu
 declare const ADVENTURE_MISSION_PLANNER_MISSION_ONE_AUTHORING_V1: MissionAuthoringBundleV1;
 declare const ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1: MissionAuthoringBundleV1;
 
+/** Runtime guard for digest-pinned external learning content references. */
+declare function isExternalLearningContentReferenceV1(value: unknown): value is ExternalLearningContentReferenceV1;
 /** Return every catalog issue without throwing, suitable for authoring tools. */
 declare function validateLearningPath(path: LearningPathVersionV1): LearningValidationIssueV1[];
 /** 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, CREATURE_CARE_DASHBOARD_MISSION_ONE_AUTHORING_V1, type CommercialStateV1, type CourseMaterialAudienceV1, type CourseMaterialKindV1, type CourseMaterialV1, type CourseMaterialsManifestV1, type CreatureCareDashboardSafeRenderV1, DANCE_ROVER_MISSION_ONE_AUTHORING_V1, type FacilitatorMissionAuthoringV1, type GuardianAiConsentV1, type HardwareItemV1, type HardwareModeV1, type HardwareRequirementManifestV1, type HardwareVerificationStatusV1, JUNIOR_CODER_MISSION_STAGE_ORDER_V1, JUNIOR_CODER_MODULE_PRICE_V1_1, JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1, JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1, 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_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_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, assertValidLearningPath, assertValidMissionAuthoringBundle, assertValidStaticProjectGuardianApproval, assertValidStaticProjectPublication, assertValidStaticProjectSnapshot, calculateAssessment, 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_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, 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_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 };