@plasius/learning 0.2.19 → 0.2.21

package/dist/index.d.cts

@@ -429,6 +429,214 @@ declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1: 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";
+declare const STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1: "guardian-static-publication-v1";
+declare const STATIC_PROJECT_DEFAULT_LIFETIME_DAYS_V1: 90;
+declare const STATIC_PROJECT_MAX_SOURCE_CHARACTERS_V1: 8000;
+declare const STATIC_PROJECT_SAFETY_CHECK_IDS_V1: readonly ["allow-listed-source", "no-personal-details", "no-external-network", "no-executable-markup", "no-transmitting-forms", "no-uploads-or-embeds", "no-trackers-or-advertising", "no-account-identifiers"];
+type StaticProjectSafetyCheckIdV1 = (typeof STATIC_PROJECT_SAFETY_CHECK_IDS_V1)[number];
+type StaticProjectModuleSlugV1 = "adventure-mission-planner" | "creature-care-dashboard" | "robot-mission-control";
+interface StaticProjectSafetyCheckV1 {
+    id: StaticProjectSafetyCheckIdV1;
+    passed: true;
+}
+/** Evidence emitted by the deterministic scanner before adult review. */
+interface StaticProjectSafetyScanV1 {
+    schemaVersion: "1";
+    scannerVersion: typeof STATIC_PROJECT_SCANNER_VERSION_V1;
+    passed: true;
+    checks: StaticProjectSafetyCheckV1[];
+}
+interface AdventureMissionPlannerSafeRenderV1 {
+    kind: "adventure-mission-planner";
+    heading: "Moonbase Missions" | "Forest Rescue Plans" | "Ocean Quest Board";
+    missions: {
+        title: "Find the moon crystal" | "Guide the lost firefly" | "Map the coral garden";
+        day: "Saturday" | "Sunday" | "School holiday";
+    }[];
+    validationMessage: "Choose a day" | "Add a mission title" | "Mission ready!";
+    savedAcrossRestart: true;
+    accessibleSummaryEnabled: true;
+}
+interface CreatureCareDashboardSafeRenderV1 {
+    kind: "creature-care-dashboard";
+    creature: "Moon Moth" | "Cloud Cat" | "Pebble Dragon";
+    status: "Resting" | "Ready to play" | "Snack time";
+    timerSeconds: 5 | 10 | 15;
+    layout: "single" | "cosy-grid" | "wide-grid";
+    reducedMotion: true;
+}
+interface RobotMissionControlSafeRenderV1 {
+    kind: "robot-mission-control";
+    command: "scan" | "hold-position" | "return-to-base";
+    safetyConfirmed: true;
+    telemetryRate: 1 | 2 | 4;
+    chartMode: "line" | "bars" | "text-only";
+    serialSimulation: true;
+    state: "SCANNING" | "HOLDING" | "RETURNING";
+}
+/** The complete public render allow-list. Learner source is never a render model. */
+type StaticProjectSafeRenderV1 = AdventureMissionPlannerSafeRenderV1 | CreatureCareDashboardSafeRenderV1 | RobotMissionControlSafeRenderV1;
+/** Immutable private snapshot awaiting an adult's exact-hash approval. */
+interface StaticProjectSnapshotV1 {
+    schemaVersion: "1";
+    contractVersion: typeof STATIC_PROJECT_PUBLISHING_CONTRACT_VERSION_V1;
+    snapshotId: string;
+    subjectAccountId: string;
+    moduleId: string;
+    moduleSlug: StaticProjectModuleSlugV1;
+    moduleVersion: string;
+    missionId: string;
+    sourceDigest: string;
+    snapshotDigest: string;
+    sourceCharacterCount: number;
+    assessmentScore: number;
+    mandatorySafetyPassed: true;
+    scan: StaticProjectSafetyScanV1;
+    renderModel: StaticProjectSafeRenderV1;
+    state: "pending-review";
+    createdAt: string;
+}
+/** Adult approval is evidence only and cannot mutate the reviewed snapshot. */
+interface StaticProjectGuardianApprovalV1 {
+    schemaVersion: "1";
+    approvalId: string;
+    snapshotId: string;
+    snapshotDigest: string;
+    guardianActorAccountId: string;
+    statementVersion: typeof STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1;
+    approvedAt: string;
+}
+/** An unlisted public pointer whose lifecycle never changes the source snapshot. */
+interface StaticProjectPublicationV1 {
+    schemaVersion: "1";
+    publicationId: string;
+    snapshotId: string;
+    snapshotDigest: string;
+    approvalId: string;
+    randomSlug: string;
+    publicUrl: string;
+    state: "published" | "expired" | "unpublished";
+    publishedAt: string;
+    expiresAt: string;
+    renewedAt?: string;
+    unpublishedAt?: string;
+}
+type StaticProjectContractIssueV1 = "invalid-schema-version" | "invalid-contract-version" | "invalid-identifier" | "invalid-module" | "invalid-version" | "invalid-source-digest" | "invalid-snapshot-digest" | "invalid-source-size" | "assessment-score-incomplete" | "mandatory-safety-missing" | "scan-not-passed" | "scan-checks-incomplete" | "module-render-model-mismatch" | "unsafe-render-model" | "invalid-created-at" | "invalid-approval-statement" | "invalid-approved-at" | "invalid-random-slug" | "invalid-public-url" | "public-url-slug-mismatch" | "published-state-required" | "invalid-published-at" | "invalid-publication-expiry" | "invalid-lifecycle-timestamp";
+/** Validate a snapshot without throwing so authoring and adapters can show every issue. */
+declare function validateStaticProjectSnapshot(value: StaticProjectSnapshotV1): StaticProjectContractIssueV1[];
+/** Fail closed when a persistence or publishing adapter constructs an invalid snapshot. */
+declare function assertValidStaticProjectSnapshot(value: StaticProjectSnapshotV1): void;
+declare function validateStaticProjectGuardianApproval(value: StaticProjectGuardianApprovalV1): StaticProjectContractIssueV1[];
+declare function assertValidStaticProjectGuardianApproval(value: StaticProjectGuardianApprovalV1): void;
+declare function validateStaticProjectPublication(value: StaticProjectPublicationV1): StaticProjectContractIssueV1[];
+declare function assertValidStaticProjectPublication(value: StaticProjectPublicationV1): void;
+
 /** Validate the deterministic 20/50/20/10 assessment authority. */
 declare function validateAssessmentRubric(rubric: AssessmentRubricV1, path?: string, moduleId?: string): LearningValidationIssueV1[];
 
@@ -525,4 +733,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 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, 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, SERVO_CREATURE_MISSION_ONE_AUTHORING_V1, SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1, STAR_DEFENDER_SQUADRON_MISSION_ONE_AUTHORING_V1, type ScoreBandV1, VIBE_BUG_DETECTIVE_MISSION_ONE_AUTHORING_V1, VIBE_GAME_REMIX_LAB_MISSION_ONE_AUTHORING_V1, VIBE_IDEA_STUDIO_MISSION_ONE_AUTHORING_V1, assertValidLearningPath, assertValidMissionAuthoringBundle, calculateAssessment, validateAssessmentRubric, validateLearningPath, validateMissionAuthoringBundle };
+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, 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_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, type VoiceHelpAvailabilityReasonV1, type VoiceHelpAvailabilityV1, assertValidCanonicalSpokenHelpDescriptor, assertValidContextualHelpIdentifier, assertValidContextualVoiceQuestionMetadata, assertValidContextualVoiceQuestionResult, assertValidGuardianVoiceConsent, assertValidLearningPath, assertValidMissionAuthoringBundle, assertValidStaticProjectGuardianApproval, assertValidStaticProjectPublication, assertValidStaticProjectSnapshot, assertValidVoiceHelpAvailability, calculateAssessment, validateAssessmentRubric, validateLearningPath, validateMissionAuthoringBundle, validateStaticProjectGuardianApproval, validateStaticProjectPublication, validateStaticProjectSnapshot };

package/dist/index.d.ts

@@ -429,6 +429,214 @@ declare const JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1: 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";
+declare const STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1: "guardian-static-publication-v1";
+declare const STATIC_PROJECT_DEFAULT_LIFETIME_DAYS_V1: 90;
+declare const STATIC_PROJECT_MAX_SOURCE_CHARACTERS_V1: 8000;
+declare const STATIC_PROJECT_SAFETY_CHECK_IDS_V1: readonly ["allow-listed-source", "no-personal-details", "no-external-network", "no-executable-markup", "no-transmitting-forms", "no-uploads-or-embeds", "no-trackers-or-advertising", "no-account-identifiers"];
+type StaticProjectSafetyCheckIdV1 = (typeof STATIC_PROJECT_SAFETY_CHECK_IDS_V1)[number];
+type StaticProjectModuleSlugV1 = "adventure-mission-planner" | "creature-care-dashboard" | "robot-mission-control";
+interface StaticProjectSafetyCheckV1 {
+    id: StaticProjectSafetyCheckIdV1;
+    passed: true;
+}
+/** Evidence emitted by the deterministic scanner before adult review. */
+interface StaticProjectSafetyScanV1 {
+    schemaVersion: "1";
+    scannerVersion: typeof STATIC_PROJECT_SCANNER_VERSION_V1;
+    passed: true;
+    checks: StaticProjectSafetyCheckV1[];
+}
+interface AdventureMissionPlannerSafeRenderV1 {
+    kind: "adventure-mission-planner";
+    heading: "Moonbase Missions" | "Forest Rescue Plans" | "Ocean Quest Board";
+    missions: {
+        title: "Find the moon crystal" | "Guide the lost firefly" | "Map the coral garden";
+        day: "Saturday" | "Sunday" | "School holiday";
+    }[];
+    validationMessage: "Choose a day" | "Add a mission title" | "Mission ready!";
+    savedAcrossRestart: true;
+    accessibleSummaryEnabled: true;
+}
+interface CreatureCareDashboardSafeRenderV1 {
+    kind: "creature-care-dashboard";
+    creature: "Moon Moth" | "Cloud Cat" | "Pebble Dragon";
+    status: "Resting" | "Ready to play" | "Snack time";
+    timerSeconds: 5 | 10 | 15;
+    layout: "single" | "cosy-grid" | "wide-grid";
+    reducedMotion: true;
+}
+interface RobotMissionControlSafeRenderV1 {
+    kind: "robot-mission-control";
+    command: "scan" | "hold-position" | "return-to-base";
+    safetyConfirmed: true;
+    telemetryRate: 1 | 2 | 4;
+    chartMode: "line" | "bars" | "text-only";
+    serialSimulation: true;
+    state: "SCANNING" | "HOLDING" | "RETURNING";
+}
+/** The complete public render allow-list. Learner source is never a render model. */
+type StaticProjectSafeRenderV1 = AdventureMissionPlannerSafeRenderV1 | CreatureCareDashboardSafeRenderV1 | RobotMissionControlSafeRenderV1;
+/** Immutable private snapshot awaiting an adult's exact-hash approval. */
+interface StaticProjectSnapshotV1 {
+    schemaVersion: "1";
+    contractVersion: typeof STATIC_PROJECT_PUBLISHING_CONTRACT_VERSION_V1;
+    snapshotId: string;
+    subjectAccountId: string;
+    moduleId: string;
+    moduleSlug: StaticProjectModuleSlugV1;
+    moduleVersion: string;
+    missionId: string;
+    sourceDigest: string;
+    snapshotDigest: string;
+    sourceCharacterCount: number;
+    assessmentScore: number;
+    mandatorySafetyPassed: true;
+    scan: StaticProjectSafetyScanV1;
+    renderModel: StaticProjectSafeRenderV1;
+    state: "pending-review";
+    createdAt: string;
+}
+/** Adult approval is evidence only and cannot mutate the reviewed snapshot. */
+interface StaticProjectGuardianApprovalV1 {
+    schemaVersion: "1";
+    approvalId: string;
+    snapshotId: string;
+    snapshotDigest: string;
+    guardianActorAccountId: string;
+    statementVersion: typeof STATIC_PROJECT_APPROVAL_STATEMENT_VERSION_V1;
+    approvedAt: string;
+}
+/** An unlisted public pointer whose lifecycle never changes the source snapshot. */
+interface StaticProjectPublicationV1 {
+    schemaVersion: "1";
+    publicationId: string;
+    snapshotId: string;
+    snapshotDigest: string;
+    approvalId: string;
+    randomSlug: string;
+    publicUrl: string;
+    state: "published" | "expired" | "unpublished";
+    publishedAt: string;
+    expiresAt: string;
+    renewedAt?: string;
+    unpublishedAt?: string;
+}
+type StaticProjectContractIssueV1 = "invalid-schema-version" | "invalid-contract-version" | "invalid-identifier" | "invalid-module" | "invalid-version" | "invalid-source-digest" | "invalid-snapshot-digest" | "invalid-source-size" | "assessment-score-incomplete" | "mandatory-safety-missing" | "scan-not-passed" | "scan-checks-incomplete" | "module-render-model-mismatch" | "unsafe-render-model" | "invalid-created-at" | "invalid-approval-statement" | "invalid-approved-at" | "invalid-random-slug" | "invalid-public-url" | "public-url-slug-mismatch" | "published-state-required" | "invalid-published-at" | "invalid-publication-expiry" | "invalid-lifecycle-timestamp";
+/** Validate a snapshot without throwing so authoring and adapters can show every issue. */
+declare function validateStaticProjectSnapshot(value: StaticProjectSnapshotV1): StaticProjectContractIssueV1[];
+/** Fail closed when a persistence or publishing adapter constructs an invalid snapshot. */
+declare function assertValidStaticProjectSnapshot(value: StaticProjectSnapshotV1): void;
+declare function validateStaticProjectGuardianApproval(value: StaticProjectGuardianApprovalV1): StaticProjectContractIssueV1[];
+declare function assertValidStaticProjectGuardianApproval(value: StaticProjectGuardianApprovalV1): void;
+declare function validateStaticProjectPublication(value: StaticProjectPublicationV1): StaticProjectContractIssueV1[];
+declare function assertValidStaticProjectPublication(value: StaticProjectPublicationV1): void;
+
 /** Validate the deterministic 20/50/20/10 assessment authority. */
 declare function validateAssessmentRubric(rubric: AssessmentRubricV1, path?: string, moduleId?: string): LearningValidationIssueV1[];
 
@@ -525,4 +733,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 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, 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, SERVO_CREATURE_MISSION_ONE_AUTHORING_V1, SKYWING_SPRINT_MISSION_ONE_AUTHORING_V1, STAR_DEFENDER_SQUADRON_MISSION_ONE_AUTHORING_V1, type ScoreBandV1, VIBE_BUG_DETECTIVE_MISSION_ONE_AUTHORING_V1, VIBE_GAME_REMIX_LAB_MISSION_ONE_AUTHORING_V1, VIBE_IDEA_STUDIO_MISSION_ONE_AUTHORING_V1, assertValidLearningPath, assertValidMissionAuthoringBundle, calculateAssessment, validateAssessmentRubric, validateLearningPath, validateMissionAuthoringBundle };
+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, 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_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, type VoiceHelpAvailabilityReasonV1, type VoiceHelpAvailabilityV1, assertValidCanonicalSpokenHelpDescriptor, assertValidContextualHelpIdentifier, assertValidContextualVoiceQuestionMetadata, assertValidContextualVoiceQuestionResult, assertValidGuardianVoiceConsent, assertValidLearningPath, assertValidMissionAuthoringBundle, assertValidStaticProjectGuardianApproval, assertValidStaticProjectPublication, assertValidStaticProjectSnapshot, assertValidVoiceHelpAvailability, calculateAssessment, validateAssessmentRubric, validateLearningPath, validateMissionAuthoringBundle, validateStaticProjectGuardianApproval, validateStaticProjectPublication, validateStaticProjectSnapshot };