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

package/dist/types/chess-reasoning/opening-source-contracts.d.ts

@@ -0,0 +1,54 @@
+export type WikibooksTarget = {
+    title: string;
+    relation: 'current' | 'before' | 'continuation';
+};
+export type WikibooksPage = {
+    title: string;
+    relation: WikibooksTarget['relation'] | 'ancestor';
+    matchedTargets?: Array<{
+        requestedTitle: string;
+        relation: WikibooksTarget['relation'];
+        ancestorPlies: number;
+        transposition: boolean;
+    }>;
+    requestedTitle?: string;
+    ancestorPlies?: number;
+    transposition?: boolean;
+    positionFen: string;
+    revisionId: number;
+    revisionTimestamp: string;
+    url: string;
+    authorHistoryUrl: string;
+    attribution: string;
+    license: 'CC BY-SA 4.0';
+    licenseUrl: string;
+    prose: string;
+};
+export type WikibooksContextResult = {
+    status: 'available' | 'outside-scope' | 'unavailable' | 'invalid-context' | 'aborted';
+    contextHash: string | null;
+    scope?: 'game-review';
+    pages: WikibooksPage[];
+    /** Local usable-prose catalog title candidates checked during this lookup. */
+    localIndexCandidateCount: number;
+    /** Recorded-game positions checked against the local catalog before title selection. */
+    localIndexPositionCheckCount: number;
+    /** Distinct catalog titles selected for possible live revision retrieval. */
+    localIndexSelectedTitleCount: number;
+    /** Selected titles already present in this answer's transport cache. */
+    cacheHitTitleCount: number;
+    /** Actual MediaWiki fetch attempts, retained alongside requestCount for clarity. */
+    networkRequestCount: number;
+    /** Exact titles sent in those fetch attempts, including redirects and continuations. */
+    networkRequestedTitles: string[];
+    requestCount: number;
+    timingMs: number;
+    limitations: string[];
+};
+export type WikibooksPlan = {
+    status: 'in-scope' | 'outside-scope' | 'invalid-context';
+    rootTitle: string;
+    beforeTitle: string | null;
+    currentTitle: string | null;
+    currentFen: string | null;
+};

package/dist/types/chess-reasoning/opening-source-credits.d.ts

@@ -0,0 +1,16 @@
+import type { WikibooksPage } from './opening-source-contracts.js';
+export type OpeningSourceCredit = {
+    title: string;
+    revisionId: number;
+};
+export declare const OPENING_SOURCE_LICENSE_URL = "https://creativecommons.org/licenses/by-sa/4.0/";
+export declare function openingSourceLinks(source: OpeningSourceCredit): {
+    revision: string;
+    history: string;
+};
+/** Persist only bounded attribution metadata, never fetched prose or model data. */
+export declare function parseOpeningSourceCredits(value: unknown): OpeningSourceCredit[];
+/** Match actual prompt packets against accepted fetched prose. Never credit a
+ * lookup merely because it completed: tools may run on the last allowed call. */
+export declare function openingSourcesInMessages(messages: unknown, known: ReadonlyMap<string, WikibooksPage>): OpeningSourceCredit[];
+export declare const openingSourceKey: (page: OpeningSourceCredit) => string;

package/dist/types/chess-reasoning/opponent-threat-preparation.d.ts

@@ -0,0 +1,7 @@
+import type { ReasoningPositionContext } from "./poc-contracts.js";
+import type { PositionAnalysisProvider } from "./poc-tools.js";
+import { type SimpleEvidencePreparation } from "./simple-evidence-preparation.js";
+/** Cheap engine acquisition only. These leads do not register evidence or UI witnesses. */
+export declare function prepareOpponentThreats(context: ReasoningPositionContext, engine: PositionAnalysisProvider, signal?: AbortSignal, onProgress?: (message: string) => void, options?: {
+    parallel?: boolean;
+}): Promise<SimpleEvidencePreparation | undefined>;

package/dist/types/chess-reasoning/piece-identities.d.ts

@@ -0,0 +1,11 @@
+import { type BranchId, type IdentityState, type MoveIdentityDelta } from "./types.js";
+export declare function createIdentityState(fen?: string, branchId?: BranchId, ply?: number): IdentityState;
+export declare function forkIdentityState(state: IdentityState, branchId: BranchId): IdentityState;
+export declare function applyIdentityMove(state: IdentityState, moveInput: string | {
+    from: string;
+    to: string;
+    promotion?: string;
+}): {
+    state: IdentityState;
+    delta: MoveIdentityDelta;
+};