Press n or j to go to the next uncovered block, b, p or k for the previous block.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 | 548x 24x | import type { TutorAnswerRating, TutorDialogTurn, TutorDifficulty } from "@shared/tutor";
import type { TutorCapability } from "../course-content/course-content-loader";
import type { ExampleTutorAnnotation } from "../course-content/embedded-tutor-annotation";
import type { EffectiveTutorStrategy, StrategyResolution } from "./strategy/effective-tutor-strategy";
import type { TutorProgressionState, DidacticPhase, ProgressionBlockedReason } from "./curriculum/progression-state";
export interface TutorPlanningContentContext {
readonly revision: string;
readonly tutor?: TutorCapability;
readonly exampleId?: string;
readonly exampleTutorAnnotation?: ExampleTutorAnnotation;
readonly progressionState?: TutorProgressionState;
}
/** Normalized, implementation-independent plan data consumed by TutorService. */
export interface TutorPlan {
readonly topicId: string;
readonly topicTitle: string;
readonly conceptId: string;
readonly conceptTitle: string;
readonly objective: string;
readonly questionId: string;
readonly questionKind: "recall" | "concept" | "application" | "prediction" | "transfer";
readonly indicatorId: string;
readonly indicator: string;
readonly question: string;
readonly misconceptions: readonly { id: string; description: string }[];
readonly strategyId?: string;
readonly strategySource?: "built-in" | "repository";
/** Internal normalized strategy used to build the provider prompt for this plan. */
readonly effectiveStrategy?: EffectiveTutorStrategy;
readonly scaffold?: { readonly id: string; readonly strategy: string; readonly hint: string };
readonly contentRevision: string;
readonly learningPhase?: DidacticPhase;
readonly activeTopicId?: string;
readonly masteredTopicIds?: readonly string[];
readonly progressionBlockedReason?: ProgressionBlockedReason;
readonly extensionTargetTopicId?: string;
readonly expansionBrief?: TutorExpansionBrief;
}
/** Application-owned, normalized guidance for one EXPAND transition. */
export interface TutorExpansionBrief {
readonly sourceTopicId: string;
readonly targetTopicId: string;
readonly objective: string;
}
export interface TutorPlanningBlocked {
readonly kind: "blocked";
readonly progressionBlockedReason: ProgressionBlockedReason;
readonly contentRevision: string;
readonly learningPhase: DidacticPhase;
readonly activeTopicId?: string;
readonly masteredTopicIds: readonly string[];
readonly strategyId: string;
readonly strategySource: "built-in" | "repository";
readonly effectiveStrategy?: EffectiveTutorStrategy;
}
export interface TutorPlanningTransition {
readonly kind: "transition";
readonly contentRevision: string;
readonly learningPhase: DidacticPhase;
readonly activeTopicId?: string;
readonly masteredTopicIds: readonly string[];
readonly strategyId: string;
readonly strategySource: "built-in" | "repository";
readonly effectiveStrategy?: EffectiveTutorStrategy;
}
export type TutorPlanningResult = TutorPlan | TutorPlanningBlocked | TutorPlanningTransition;
export function isTutorPlan(result: TutorPlanningResult | null): result is TutorPlan {
return result !== null && !("kind" in result);
}
export function isTutorPlanningBlocked(result: TutorPlanningResult | null): result is TutorPlanningBlocked {
return result !== null && "kind" in result && result.kind === "blocked";
}
export interface TutorPlanningExtension {
resolveStrategy?(input: { readonly code?: string; readonly courseContent?: TutorPlanningContentContext }): Promise<StrategyResolution>;
planInitial(input: { readonly code: string; readonly history: readonly TutorDialogTurn[]; readonly difficulty: TutorDifficulty; readonly exampleId?: string; readonly courseContent?: TutorPlanningContentContext }): Promise<TutorPlanningResult | null>;
/**
* Resolves the didactic context of the question the learner is currently answering, for the
* dialog prompt. It never plans or reserves a new question and leaves the progression state
* unchanged; an unresolvable question yields null. Without this method the dialog prompt
* carries no didactic context.
*/
planAnswered?(input: {
readonly code: string;
readonly history: readonly TutorDialogTurn[];
readonly currentQuestion: string;
readonly difficulty: TutorDifficulty;
readonly exampleId?: string;
readonly courseContent?: TutorPlanningContentContext;
}): Promise<TutorPlanningResult | null>;
planFollowup(input: {
readonly code: string;
readonly history: readonly TutorDialogTurn[];
readonly currentQuestion: string;
readonly rating: TutorAnswerRating;
readonly difficulty: TutorDifficulty;
readonly exampleId?: string;
readonly courseContent?: TutorPlanningContentContext;
}): Promise<TutorPlanningResult | null>;
}
|