@knights-eye-chess/ai-analysis 0.0.0-stage → 0.1.0-dev.14

package/dist/types/chess-reasoning/question-routing.d.ts

@@ -0,0 +1,326 @@
+/** KE-REASON-024: question-only Jev routing contract. */
+export declare const QUESTION_ROUTING_VERSION = "jev-r17-move-classification-20261003";
+export declare const REVIEW_SUBJECTS: readonly ["self", "opponent", "white", "black", "both", "unspecified"];
+export declare const ANSWER_SCOPES: readonly ["move_explanation", "position_analysis", "game_review", "general", "mixed"];
+export type AnswerScope = typeof ANSWER_SCOPES[number];
+export type AnswerScopeAnswer = {
+    type: 'choice';
+    choice: AnswerScope;
+    confidence?: number;
+    probabilities?: Partial<Record<AnswerScope, number>>;
+};
+export type ReviewSubject = typeof REVIEW_SUBJECTS[number];
+export type ReviewSubjectAnswer = {
+    type: 'choice';
+    choice: ReviewSubject;
+    confidence?: number;
+    probabilities?: Partial<Record<ReviewSubject, number>>;
+};
+declare const questions: {
+    readonly independent: {
+        readonly type: "choice";
+        readonly instructions: "Can all active requests be answered using the game record or general knowledge, without knowing which turn the viewer selected?";
+        readonly criteria: {
+            yes: string;
+            no: string;
+        };
+    };
+    readonly independent_noul: {
+        readonly type: "noul";
+        readonly instructions: "Is the user asking only about subjects identifiable independently of the selected move?";
+        readonly criteria: {
+            readonly true: string;
+            readonly false: string;
+        };
+    };
+    readonly board_guard: {
+        readonly type: "choice";
+        readonly instructions: "Does the user actively ask about the board position currently displayed?";
+        readonly criteria: {
+            readonly yes: "An active request for its evaluation, material, threats, legal moves, plans, or another property of the current position. Excluding discussion of the selected move does not exclude the board.";
+            readonly no: "Only game history, phase review, an explicitly numbered historical turn, general knowledge, or discussion/translation of quoted text. No active request about the current board.";
+        };
+    };
+    readonly review_only: {
+        readonly type: "choice";
+        readonly instructions: "Is the user's entire request a review of how they played across a game or a phase of that game?";
+        readonly criteria: {
+            readonly yes: "Assess their play across the opening, middlegame, endgame or whole game. Evaluate performance, identify mistakes or missed chances, or give lessons from that play. No additional request about the selected move, the current board, or what to play next.";
+            readonly no: "A specific move or current position is being discussed, including a mixed request combining a game review with a selected-move explanation, current-position assessment, next move or continuation. General chess advice without reviewing their played game is also no.";
+        };
+    };
+    readonly local_reference: {
+        readonly type: "choice";
+        readonly instructions: "Does answering the user's active question require identifying a move or position referred to without an explicit game move number?";
+        readonly criteria: {
+            readonly yes: "The question asks about this move, this position, here, now, a next move, an unnamed alternative, or a reference to a previous answer. Include mixed requests even if they also mention game history or reviewing the opening. A question like why this is losing needs the referenced position.";
+            readonly no: "Every active request is about the whole game, a game phase, general knowledge, or an explicitly numbered historical move. Mentions of the current board that are quoted or explicitly excluded are not active requests.";
+        };
+    };
+    readonly game_record: {
+        readonly type: "choice";
+        readonly instructions: "Does the user ask what actually happened in this game, including which moves were played?";
+        readonly criteria: {
+            readonly yes: "The user asks for actual game events, actual subsequent play, or whether/when a move was played.";
+            readonly no: "The user is not asking to retrieve actual game events or played moves.";
+        };
+    };
+    readonly game_context: {
+        readonly type: "choice";
+        readonly instructions: "Does answering the user require their recorded game, beyond the selected move and its immediately surrounding positions?";
+        readonly criteria: {
+            readonly yes: "The answer depends on played game history: actual events or later play, review of a game or phase, an explicitly numbered historical move, or advice and variations specific to the opening played in this game. Include coaching requests grounded in their game even when they do not explicitly ask to retrieve moves.";
+            readonly no: "The current position or selected move alone is sufficient, or the request is general chess knowledge, translation, or unrelated to the played game. A named opening alone without a reference to their game does not require game history. Comparing possible moves in the selected position is a local question, unless another part of the request needs game history.";
+        };
+    };
+    readonly game_review: {
+        readonly type: "choice";
+        readonly instructions: "Is a review of play across the game or a phase explicitly requested?";
+        readonly criteria: {
+            readonly yes: "Review multiple decisions, find mistakes across a phase or the game, or recommend lessons from that play. An explicit question about how an earlier phase went still counts when paired with next-move advice. A comprehensive review of the full game counts even without mentioning mistakes or personal performance.";
+            readonly no: "No broad review is requested. Mentioning past mistakes while asking what to do now, or asking about just one move, is not a broad review. Retrieving facts, statistics or played moves without evaluating decisions is not a review. Evaluating only one hypothetical alternative is not a phase review. Opening identification or general planning advice without assessing played decisions is not a review.";
+        };
+    };
+    readonly selected_anchor: {
+        readonly type: "choice";
+        readonly instructions: "Is any part of the request about the currently selected chess position or an unidentified local move? Classify the active request, not quoted or explicitly excluded text.";
+        readonly criteria: {
+            readonly yes: "The displayed board, this move, an unnumbered move judged against the engine, an unnamed alternative, what to play from here, or an unresolved reference to previous analysis. General advice alongside a local question still counts.";
+            readonly no: "Only a whole game, a game phase, a move identified by its turn number, actual game events, or a self-contained general topic. A numbered move anchors its consequences and replies too. This includes numbered historical moves written with non-English piece notation.";
+        };
+    };
+    readonly numbered_move_target: {
+        readonly type: "choice";
+        readonly instructions: "Is an actual game turn number attached to the target move, separately from its destination square? Ignore quoted or excluded requests.";
+        readonly criteria: {
+            readonly yes: "A turn number precedes a period and move, as in 5.Nxe5 or 12...Nd4, or prose explicitly says bishop move on turn twelve. The user asks about that identified move, its alternatives or consequences.";
+            readonly no: "A square rank is NOT a turn number: Ne6, Na5, a5 and d4 are unnumbered moves. Quantities of plies and ranges of turns are not numbered target moves. Numbered text merely quoted for translation does not count.";
+        };
+    };
+    readonly played_opening: {
+        readonly type: "choice";
+        readonly instructions: "Does the user actively ask to identify or teach the opening system or sequence played in their game? Ignore quoted or excluded requests.";
+        readonly criteria: {
+            readonly yes: "Identify the played opening, teach this opening or our opening, give its overall main lines, or coach the opening phase of their game. The request must actually refer to an opening or opening phase.";
+            readonly no: "Only current-position advice, best replies or continuations from the current point. An opening name merely framing a particular move is insufficient. Generic named-opening theory, or opening words inside text being translated, also do not count.";
+        };
+    };
+    readonly retrospective_review: {
+        readonly type: "choice";
+        readonly instructions: "Does the user request feedback on how they played across a game or a phase? Classify the active request, not quoted or explicitly excluded text.";
+        readonly criteria: {
+            readonly yes: "Review actual play, diagnose recurring mistakes, or explain how their decisions across the opening, middlegame, endgame or game could have been better. This can be part of a mixed request.";
+            readonly no: "Only one move or position; theory, prospective continuations, hypothetical traps or typical future mistakes. A walkthrough of possible replies is not feedback on played decisions.";
+        };
+    };
+};
+export declare const CLASSIFICATION_REFERENCES: readonly ["selection_relative", "named_move", "other_relative", "none"];
+export type ClassificationReference = typeof CLASSIFICATION_REFERENCES[number];
+export type ClassificationReferenceAnswer = {
+    type: 'choice';
+    choice: ClassificationReference;
+    confidence?: number;
+    probabilities?: Partial<Record<ClassificationReference, number>>;
+};
+/** Saved r16 responses remain readable; these legacy heads are never requested or used. */
+export declare const CLASSIFICATION_TARGETS: readonly ["selected_move", "other_move", "none"];
+export type ClassificationTarget = typeof CLASSIFICATION_TARGETS[number];
+export type ClassificationTargetAnswer = {
+    type: 'choice';
+    choice: ClassificationTarget;
+    confidence?: number;
+    probabilities?: Partial<Record<ClassificationTarget, number>>;
+};
+export type QuestionRoutingAnswer = {
+    type: "choice";
+    choice: "yes" | "no";
+    confidence?: number;
+    probabilities?: Partial<Record<"yes" | "no", number>>;
+} | {
+    type: "noul";
+    noul: number;
+};
+export type QuestionRoutingAnswers = Record<keyof typeof questions, QuestionRoutingAnswer> & {
+    review_subject?: ReviewSubjectAnswer;
+    answer_scope?: AnswerScopeAnswer;
+    current_classification?: QuestionRoutingAnswer;
+    classification_target?: ClassificationTargetAnswer;
+    move_classification?: QuestionRoutingAnswer;
+    classification_reference?: ClassificationReferenceAnswer;
+};
+export type QuestionRoutingDecision = {
+    version: string;
+    status: "classified" | "fallback";
+    omitSelectedContext: boolean;
+    includeGameRecord: boolean;
+    gameRecordTrigger?: 'starting-position';
+    reviewGame: boolean;
+    reviewSubject?: ReviewSubject;
+    reason?: string;
+    answers?: QuestionRoutingAnswers;
+    usage?: {
+        cost?: number | null;
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        total_tokens?: number;
+        input_tokens?: number;
+        output_tokens?: number;
+    };
+    providerLatencyMs?: number;
+};
+export declare function makeQuestionRoutingRequest(question: string): {
+    model: string;
+    state: {
+        question: string;
+    };
+    questions: {
+        review_subject: {
+            readonly type: "choice";
+            readonly instructions: "Whose play is the user asking to assess across a game or phase? Find the subject of that assessment, even if expressed as past decisions to improve rather than the word review. Ignore separate local-position requests and quoted or excluded instructions. Ownership of a game alone is not a player restriction. If the question explicitly identifies the reviewed player's color, choose white or black rather than self or opponent. Conflicting active review subjects must not select one player.";
+            readonly criteria: {
+                readonly self: "Assessment of the user's own performance or decisions: their errors, what they did wrong, or what they should have done differently across the game. This personal assessment can accompany a request to go through their game. No assessment of the other player's decisions is requested, and the question does not explicitly identify the user's color.";
+                readonly opponent: "The user asks to assess their opponent's play, mistakes or decisions, without requesting review of their own play. The question does not explicitly identify which color that opponent played.";
+                readonly white: "The requested review concerns White's decisions only, whether named directly or identified as the user/opponent by an explicit statement of who played which color. Color mentions that merely describe the opponent or another local question do not count.";
+                readonly black: "The requested review concerns Black's decisions only, whether named directly or identified as the user/opponent by an explicit statement of who played which color. Color mentions that merely describe the opponent or another local question do not count.";
+                readonly both: "The across-game/phase review explicitly covers both players, or contains conflicting review subjects that cannot be resolved to one player. A separate question about a single move or piece does not add a player to this review's scope.";
+                readonly unspecified: "No assessment across multiple played decisions is requested, or no player's decisions are singled out. An overall review of the game, my game or our opening alone has no player restriction. An additional request to assess the user's own decisions DOES specify self instead.";
+            };
+        };
+        answer_scope: {
+            readonly type: "choice";
+            readonly instructions: "What is the main task of the user's active request? Classify its requested answer, not the selected board, available game history, routing needs, or quoted/excluded text. A move explanation requires a specific move actually played, including an identified historical game move; a hypothetical candidate from the current position is position analysis. Choose mixed if a move explanation is combined with a substantial whole-game, position, or other independent task.";
+            readonly criteria: {
+                readonly move_explanation: "Explain or evaluate one specific played move, selected now or identified from the recorded game, and its pertinent alternatives or continuations.";
+                readonly position_analysis: "Assess a current or starting position, legal candidates, plans or next moves without a specific played target move.";
+                readonly game_review: "Review decisions or play across the whole recorded game or a phase, even when a selected move happens to be available.";
+                readonly general: "Answer a factual, rules, opening theory, translation or other question that is not a played-move explanation, position analysis or game review.";
+                readonly mixed: "Multiple substantial tasks have different scopes; do not force one played-move structure over the complete answer.";
+            };
+        };
+        move_classification: {
+            readonly type: "choice";
+            readonly instructions: "Does ANY active part of the question ask to explain, justify, challenge or reassess the quality classification of a PLAYED move? Include mixed questions and played moves identified by SAN, game move number, this move, or previous move. You have only the question: do not infer whether a named or numbered move is selected now or historical. Ignore quoted or expressly excluded requests.";
+            readonly criteria: {
+                readonly yes: "At least one active request asks why or whether a played move deserves a quality label: forced, brilliant, great, interesting, best, good, okay, dubious, mistake, missed opportunity or blunder. Why is this the best move in this position, why is 14.Qg4 great, and why was my opponent's previous move a blunder all count. The request can be one part of a mixed question.";
+                readonly no: "No active played-move quality-classification request. Only move intention, plans, threats, position evaluation, prospective hypothetical candidates, opening lines, general label definitions, translation of quoted classification questions, expressly excluded label explanations, or a label mentioned merely as background.";
+            };
+        };
+        classification_reference: {
+            readonly type: "choice";
+            readonly instructions: "How is the target of the ACTIVE PLAYED-MOVE CLASSIFICATION request expressed? Describe only the wording, not game facts or which move is selected. Examine classification requests separately from unrelated requests in a mixed question. If ANY active classification request explicitly refers to this/current/selected move or an unnamed local played move, choose selection_relative even alongside named-move questions. Unrelated local plans or next-move requests do not count as selection-relative classification requests. Ignore quoted and expressly excluded text.";
+            readonly criteria: {
+                readonly selection_relative: "An active classification request says this move, the current/selected move, this was a mistake, or otherwise concerns an unnamed local played move. Takes precedence if there is also a named or previous-move classification request. Compare 14.Qg4 with 14.Qh5, and explain why this selected move is marked a mistake is selection_relative.";
+                readonly named_move: "Active played-move classification requests name a move by SAN, optionally with a game move number, and no separate selection-relative classification request exists. Why is 14.Qg4 great, and what should I play next here is named_move: only the plans request is local. The number does not tell you whether that move is currently selected.";
+                readonly other_relative: "Active played-move classification requests identify a previous move, opponent's last move or another relative played move without explicit SAN, with no selection-relative or named-move classification request. This describes the reference wording, not its resolved game position.";
+                readonly none: "No active played-move classification request: only definitions, quoted or excluded label questions, prospective hypothetical moves, move intention, position evaluation, plans, opening lines or labels mentioned as background.";
+            };
+        };
+        independent: {
+            readonly type: "choice";
+            readonly instructions: "Can all active requests be answered using the game record or general knowledge, without knowing which turn the viewer selected?";
+            readonly criteria: {
+                yes: string;
+                no: string;
+            };
+        };
+        independent_noul: {
+            readonly type: "noul";
+            readonly instructions: "Is the user asking only about subjects identifiable independently of the selected move?";
+            readonly criteria: {
+                readonly true: string;
+                readonly false: string;
+            };
+        };
+        board_guard: {
+            readonly type: "choice";
+            readonly instructions: "Does the user actively ask about the board position currently displayed?";
+            readonly criteria: {
+                readonly yes: "An active request for its evaluation, material, threats, legal moves, plans, or another property of the current position. Excluding discussion of the selected move does not exclude the board.";
+                readonly no: "Only game history, phase review, an explicitly numbered historical turn, general knowledge, or discussion/translation of quoted text. No active request about the current board.";
+            };
+        };
+        review_only: {
+            readonly type: "choice";
+            readonly instructions: "Is the user's entire request a review of how they played across a game or a phase of that game?";
+            readonly criteria: {
+                readonly yes: "Assess their play across the opening, middlegame, endgame or whole game. Evaluate performance, identify mistakes or missed chances, or give lessons from that play. No additional request about the selected move, the current board, or what to play next.";
+                readonly no: "A specific move or current position is being discussed, including a mixed request combining a game review with a selected-move explanation, current-position assessment, next move or continuation. General chess advice without reviewing their played game is also no.";
+            };
+        };
+        local_reference: {
+            readonly type: "choice";
+            readonly instructions: "Does answering the user's active question require identifying a move or position referred to without an explicit game move number?";
+            readonly criteria: {
+                readonly yes: "The question asks about this move, this position, here, now, a next move, an unnamed alternative, or a reference to a previous answer. Include mixed requests even if they also mention game history or reviewing the opening. A question like why this is losing needs the referenced position.";
+                readonly no: "Every active request is about the whole game, a game phase, general knowledge, or an explicitly numbered historical move. Mentions of the current board that are quoted or explicitly excluded are not active requests.";
+            };
+        };
+        game_record: {
+            readonly type: "choice";
+            readonly instructions: "Does the user ask what actually happened in this game, including which moves were played?";
+            readonly criteria: {
+                readonly yes: "The user asks for actual game events, actual subsequent play, or whether/when a move was played.";
+                readonly no: "The user is not asking to retrieve actual game events or played moves.";
+            };
+        };
+        game_context: {
+            readonly type: "choice";
+            readonly instructions: "Does answering the user require their recorded game, beyond the selected move and its immediately surrounding positions?";
+            readonly criteria: {
+                readonly yes: "The answer depends on played game history: actual events or later play, review of a game or phase, an explicitly numbered historical move, or advice and variations specific to the opening played in this game. Include coaching requests grounded in their game even when they do not explicitly ask to retrieve moves.";
+                readonly no: "The current position or selected move alone is sufficient, or the request is general chess knowledge, translation, or unrelated to the played game. A named opening alone without a reference to their game does not require game history. Comparing possible moves in the selected position is a local question, unless another part of the request needs game history.";
+            };
+        };
+        game_review: {
+            readonly type: "choice";
+            readonly instructions: "Is a review of play across the game or a phase explicitly requested?";
+            readonly criteria: {
+                readonly yes: "Review multiple decisions, find mistakes across a phase or the game, or recommend lessons from that play. An explicit question about how an earlier phase went still counts when paired with next-move advice. A comprehensive review of the full game counts even without mentioning mistakes or personal performance.";
+                readonly no: "No broad review is requested. Mentioning past mistakes while asking what to do now, or asking about just one move, is not a broad review. Retrieving facts, statistics or played moves without evaluating decisions is not a review. Evaluating only one hypothetical alternative is not a phase review. Opening identification or general planning advice without assessing played decisions is not a review.";
+            };
+        };
+        selected_anchor: {
+            readonly type: "choice";
+            readonly instructions: "Is any part of the request about the currently selected chess position or an unidentified local move? Classify the active request, not quoted or explicitly excluded text.";
+            readonly criteria: {
+                readonly yes: "The displayed board, this move, an unnumbered move judged against the engine, an unnamed alternative, what to play from here, or an unresolved reference to previous analysis. General advice alongside a local question still counts.";
+                readonly no: "Only a whole game, a game phase, a move identified by its turn number, actual game events, or a self-contained general topic. A numbered move anchors its consequences and replies too. This includes numbered historical moves written with non-English piece notation.";
+            };
+        };
+        numbered_move_target: {
+            readonly type: "choice";
+            readonly instructions: "Is an actual game turn number attached to the target move, separately from its destination square? Ignore quoted or excluded requests.";
+            readonly criteria: {
+                readonly yes: "A turn number precedes a period and move, as in 5.Nxe5 or 12...Nd4, or prose explicitly says bishop move on turn twelve. The user asks about that identified move, its alternatives or consequences.";
+                readonly no: "A square rank is NOT a turn number: Ne6, Na5, a5 and d4 are unnumbered moves. Quantities of plies and ranges of turns are not numbered target moves. Numbered text merely quoted for translation does not count.";
+            };
+        };
+        played_opening: {
+            readonly type: "choice";
+            readonly instructions: "Does the user actively ask to identify or teach the opening system or sequence played in their game? Ignore quoted or excluded requests.";
+            readonly criteria: {
+                readonly yes: "Identify the played opening, teach this opening or our opening, give its overall main lines, or coach the opening phase of their game. The request must actually refer to an opening or opening phase.";
+                readonly no: "Only current-position advice, best replies or continuations from the current point. An opening name merely framing a particular move is insufficient. Generic named-opening theory, or opening words inside text being translated, also do not count.";
+            };
+        };
+        retrospective_review: {
+            readonly type: "choice";
+            readonly instructions: "Does the user request feedback on how they played across a game or a phase? Classify the active request, not quoted or explicitly excluded text.";
+            readonly criteria: {
+                readonly yes: "Review actual play, diagnose recurring mistakes, or explain how their decisions across the opening, middlegame, endgame or game could have been better. This can be part of a mixed request.";
+                readonly no: "Only one move or position; theory, prospective continuations, hypothetical traps or typical future mistakes. A walkthrough of possible replies is not feedback on played decisions.";
+            };
+        };
+    };
+};
+/** Preserve validated legacy heads even if the additive subject head is unavailable. */
+export declare function parseQuestionRoutingAnswers(value: unknown): QuestionRoutingAnswers | null;
+/** Unmeasured, ambiguous, legacy and fallback routes never enable the move-only suffix. */
+export declare function moveSectionScope(decision: QuestionRoutingDecision): 'move-explanation' | 'none';
+export declare function classifyReviewSubject(answers: QuestionRoutingAnswers): ReviewSubject;
+export declare function classifyQuestionRoutingAnswers(answers: QuestionRoutingAnswers): Pick<QuestionRoutingDecision, "omitSelectedContext" | "includeGameRecord" | "reviewGame">;
+/** KE-REASON-024: question-only intent; callers resolve the move using frozen context. */
+export declare function hasMoveClassificationQuestion(decision: QuestionRoutingDecision): boolean;
+/** Transitional alias: this indicates intent, not whether its target is the selected move. */
+export declare const shouldInspectCurrentClassification: typeof hasMoveClassificationQuestion;
+export {};

package/dist/types/chess-reasoning/recorded-main-line.d.ts

@@ -0,0 +1,37 @@
+import type { RecordedMainLine } from "./answer-host-contracts.js";
+import { type ReasoningPositionContext, type ReasoningEvidenceRecord } from "./poc-contracts.js";
+export declare function recordedMainLineResult(line: RecordedMainLine, context: ReasoningPositionContext): {
+    contextHash: string;
+    evidence: ReasoningEvidenceRecord[];
+    recordedAnalysis: {
+        source: string;
+        authority: string;
+        scorePerspective: string;
+        units: string;
+        coverage: {
+            analyzedPlies: number;
+            totalPlies: number;
+            complete: boolean;
+        };
+        columns: string[];
+        rows: [number, string, number, number, number, string, number | null, number | null, number | null, number | null, number | null][];
+        limitations: string[];
+    };
+    recordedMainLine: {
+        source: string;
+        startFen: string;
+        moves: {
+            uci: string;
+            san: string;
+            moveNumber: number;
+            color: import("chess.js").Color;
+        }[];
+        selectedIndex: number;
+        selectedAtStart: boolean;
+        selectedOnMainLine: boolean;
+        totalPlies: number;
+        truncated: boolean;
+        pgn: string;
+    };
+    limitations: string[];
+};

package/dist/types/chess-reasoning/recorded-position-tools.d.ts

@@ -0,0 +1,11 @@
+import type { RecordedMainLine } from './answer-host-contracts.js';
+import { type PocToolHostOptions } from './poc-tools.js';
+import { type ReasoningPositionContext, type ReasoningToolDescriptor, type ReasoningToolSet } from './poc-contracts.js';
+export declare const RECORDED_POSITION_TOOLS: readonly ["analyze_game_position", "test_game_line"];
+export declare const isRecordedPositionTool: (name: string) => boolean;
+export declare const RECORDED_POSITION_DESCRIPTORS: ReasoningToolDescriptor[];
+/** No caller supplied FEN. Every root is an exact occurrence in the frozen record. */
+export declare function recordedPositionContext(line: RecordedMainLine, ply: number): ReasoningPositionContext;
+export declare function withRecordedPositionTools(selected: ReasoningPositionContext, base: ReasoningToolSet, options: PocToolHostOptions, getLine: (signal?: AbortSignal) => Promise<RecordedMainLine>): ReasoningToolSet;
+/** Request-local exact successful result reuse, including automatically prepared searches. */
+export declare function memoizeToolResults(host: ReasoningToolSet): ReasoningToolSet;

package/dist/types/chess-reasoning/recorded-reference-context.d.ts

@@ -0,0 +1,13 @@
+import { type ReasoningPositionContext } from './poc-contracts.js';
+/** Reconstruct an occurrence from its ordered history, never from a FEN guess. */
+export declare function historyPositionContext(startFen: string, history: string[]): ReasoningPositionContext;
+export declare function recordedEvidenceContext(selected: ReasoningPositionContext, value: unknown): ReasoningPositionContext;
+export declare function recordedNavigation(context: ReasoningPositionContext, recorded?: ReasoningPositionContext): {
+    anchorEdgeId: string;
+    context: ReasoningPositionContext;
+} | {
+    context: ReasoningPositionContext;
+    anchorEdgeId?: undefined;
+};
+/** Reject contradictory engine scope before promoting its paths to navigation/theory. */
+export declare function recordedDetailsMatch(root: ReasoningPositionContext, value: unknown): boolean;

package/dist/types/chess-reasoning/recorded-selected-classification.d.ts

@@ -0,0 +1,36 @@
+import type { RecordedMainLine } from './answer-host-contracts.js';
+import { type ReasoningPositionContext, type ReasoningEvidenceRecord } from './poc-contracts.js';
+/** A historical badge is not a refreshed board analysis or a new classification. */
+export declare function recordedSelectedClassification(context: ReasoningPositionContext, line: RecordedMainLine | undefined): {
+    record: ReasoningEvidenceRecord;
+    snapshot: {
+        evidenceId: string;
+        version: "recorded-selected-classification/1";
+        authority: string;
+        source: string;
+        position: {
+            fenBefore: string;
+            fenAfter: string;
+            moveUci: string;
+            moveSan: string;
+            ply: number;
+        };
+        classification: string;
+        classifierVersion: number;
+        engine: string;
+        reportedDepth: number;
+        recordedRequestedDepth: number;
+        freshlyRecomputed: boolean;
+        savedEvaluation: {
+            perspective: string;
+            units: string;
+            beforeCp: number | null;
+            afterCp: number | null;
+            lossCp: number | null;
+            mateBefore: number | null;
+            mateAfter: number | null;
+        };
+        limitations: string[];
+    };
+} | undefined;
+export type RecordedSelectedClassification = ReturnType<typeof recordedSelectedClassification>;

package/dist/types/chess-reasoning/reference-limits.d.ts

@@ -0,0 +1,2 @@
+/** Shared producer, reference-admission and saved-answer path bound. */
+export declare const MAX_INTERACTIVE_LINE_PLIES = 32;