jev-chess 1.0.0

package/dist/moveEvaluator.js

@@ -0,0 +1,103 @@
+import { choice, getTypeSafeClient, noul, score } from "./typeSafeClient.js";
+const SHARPNESS_RUBRIC = [
+    "Quiet, solid, or prophylactic maneuver with minimal immediate confrontation",
+    "Normal central development or positional consolidation",
+    "Sharp or provocative move with direct tactical tension",
+    "High-risk sacrifice or explosive tactical clash",
+];
+const STRATEGIC_THEMES = {
+    pawn_break: "Advances a pawn to challenge or dissolve opponent pawn structure",
+    piece_activation: "Develops or repositions a piece to an active central or attacking square",
+    prophylaxis: "Prevents opponent's plan, stabilizes position, or secures king safety",
+    tactical_strike: "Direct capture, check, fork, pin, or tactic to win material or mate",
+    king_hunt: "Advances pieces or pawns directly against the enemy king",
+    simplification: "Trades pieces to consolidate advantage or clarify position",
+};
+/**
+ * Multi-dimensional qualitative evaluator for chess moves using TypeSafe AI.
+ * Pattern: Parallel Atomic Judgments + Code-Controlled Badge Synthesis.
+ */
+export class MoveEvaluator {
+    get client() {
+        return getTypeSafeClient();
+    }
+    async evaluateMove(engine, move) {
+        const boardContext = engine.getBoardContext();
+        const state = {
+            evaluated_move: {
+                san: move.san,
+                description: move.description,
+                is_capture: move.isCapture,
+                is_check: move.isCheck,
+                piece: move.piece,
+            },
+            board_context: {
+                fen: boardContext.fen,
+                turn: boardContext.turn,
+                game_phase: boardContext.gamePhase,
+                material: boardContext.materialBalance.description,
+                recent_history: boardContext.recentHistory,
+            },
+        };
+        // Parallel atomic evaluation in a single round-trip
+        const response = await this.client.systemOne({
+            state,
+            questions: {
+                tactical_sharpness: score("How sharp, tactical, or double-edged is the move `evaluated_move.san` in this position?", SHARPNESS_RUBRIC),
+                strategic_theme: choice("Which primary strategic or tactical theme best characterizes `evaluated_move.san`?", STRATEGIC_THEMES),
+                king_attack: noul("Does `evaluated_move.san` initiate or advance a direct attack against the enemy king?"),
+                psychological_pressure: noul("Is `evaluated_move.san` a provocative or high-pressure move that challenges the opponent mentally?"),
+            },
+        });
+        const sharpnessAnswer = response.answers.tactical_sharpness;
+        const themeAnswer = response.answers.strategic_theme;
+        const kingAnswer = response.answers.king_attack;
+        const pressureAnswer = response.answers.psychological_pressure;
+        const sharpnessScore = sharpnessAnswer.score;
+        const sharpnessLevel = SHARPNESS_RUBRIC[Math.min(SHARPNESS_RUBRIC.length - 1, Math.round(sharpnessScore))] ??
+            "Standard move";
+        // Determine commentary badge in deterministic code (clean, professional text)
+        let commentaryBadge = "Standard Move";
+        if (sharpnessScore >= 2.2) {
+            commentaryBadge = "Sharp Tactical Clash";
+        }
+        else if (kingAnswer.noul >= 0.7) {
+            commentaryBadge = "King Assault Initiated";
+        }
+        else if (themeAnswer.choice === "prophylaxis") {
+            commentaryBadge = "Prophylactic Squeeze";
+        }
+        else if (themeAnswer.choice === "pawn_break") {
+            commentaryBadge = "Central Pawn Break";
+        }
+        else if (themeAnswer.choice === "simplification") {
+            commentaryBadge = "Positional Simplification";
+        }
+        else if (sharpnessScore <= 0.6) {
+            commentaryBadge = "Calm Positional Maneuver";
+        }
+        else {
+            commentaryBadge = "Piece Activation";
+        }
+        return {
+            san: move.san,
+            tacticalSharpness: {
+                score: sharpnessScore,
+                level: sharpnessLevel,
+                confidence: sharpnessAnswer.confidence,
+            },
+            strategicTheme: {
+                theme: themeAnswer.choice,
+                confidence: themeAnswer.confidence,
+            },
+            kingAttackRisk: {
+                probability: kingAnswer.noul,
+            },
+            psychologicalPressure: {
+                probability: pressureAnswer.noul,
+            },
+            commentaryBadge,
+        };
+    }
+}
+//# sourceMappingURL=moveEvaluator.js.map

package/dist/moveEvaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moveEvaluator.js","sourceRoot":"","sources":["../src/moveEvaluator.ts"],"names":[],"mappings":"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"}

package/dist/moveResolver.d.ts

@@ -0,0 +1,15 @@
+import type { ChessEngine } from "./chessEngine.js";
+import type { MoveIntentResult } from "./types.js";
+/**
+ * Resolves natural language user commands into exact legal chess moves using TypeSafe Choice.
+ * Pattern: Select Instead of Generate + Confidence-Gated Ambiguity Resolution.
+ */
+export declare class MoveResolver {
+    private get client();
+    /**
+     * Resolves natural language intent (e.g. "push my e-pawn two squares", "castle kingside")
+     * into a verified legal move.
+     */
+    resolveIntent(engine: ChessEngine, userQuery: string, confidenceThreshold?: number): Promise<MoveIntentResult>;
+}
+//# sourceMappingURL=moveResolver.d.ts.map

package/dist/moveResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moveResolver.d.ts","sourceRoot":"","sources":["../src/moveResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAiB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAElE;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,KAAK,MAAM,GAEjB;IAED;;;OAGG;IACU,aAAa,CACxB,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,EACjB,mBAAmB,SAAO,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAiG3B;CACF"}

package/dist/moveResolver.js

@@ -0,0 +1,97 @@
+import { choice, getTypeSafeClient } from "./typeSafeClient.js";
+/**
+ * Resolves natural language user commands into exact legal chess moves using TypeSafe Choice.
+ * Pattern: Select Instead of Generate + Confidence-Gated Ambiguity Resolution.
+ */
+export class MoveResolver {
+    get client() {
+        return getTypeSafeClient();
+    }
+    /**
+     * Resolves natural language intent (e.g. "push my e-pawn two squares", "castle kingside")
+     * into a verified legal move.
+     */
+    async resolveIntent(engine, userQuery, confidenceThreshold = 0.55) {
+        const candidates = engine.getAnnotatedMoves();
+        if (candidates.length === 0) {
+            return {
+                query: userQuery,
+                matchedMove: null,
+                san: "none",
+                confidence: 1.0,
+                probabilities: {},
+                clarificationNeeded: false,
+                alternativeCandidates: [],
+            };
+        }
+        // Direct exact match fast-path (e.g. user literally typed "e4" or "Nf3")
+        const exactMatch = candidates.find((m) => m.san.toLowerCase() === userQuery.trim().toLowerCase() ||
+            `${m.from}${m.to}`.toLowerCase() === userQuery.trim().toLowerCase());
+        if (exactMatch) {
+            return {
+                query: userQuery,
+                matchedMove: exactMatch,
+                san: exactMatch.san,
+                confidence: 1.0,
+                probabilities: { [exactMatch.san]: 1.0 },
+                clarificationNeeded: false,
+                alternativeCandidates: [],
+            };
+        }
+        // Build Choice criteria from legal moves
+        const criteria = {};
+        for (const c of candidates) {
+            criteria[c.san] = c.description;
+        }
+        criteria["none"] = "No legal candidate move matches what the player requested";
+        const state = {
+            user_intent: userQuery,
+            board: {
+                turn: engine.turn(),
+                in_check: engine.isCheck(),
+                fen: engine.fen(),
+            },
+            legal_moves: candidates.map((c) => ({
+                san: c.san,
+                description: c.description,
+            })),
+        };
+        const response = await this.client.systemOne({
+            state,
+            questions: {
+                matched_move: choice("Which legal chess move in `legal_moves` best fulfills the player's command in `user_intent`?", criteria),
+            },
+        });
+        const answer = response.answers.matched_move;
+        const selectedSan = answer.choice;
+        const confidence = answer.confidence;
+        const probabilities = answer.probabilities;
+        // Sort alternatives by probability
+        const sortedOptions = Object.entries(probabilities)
+            .filter(([k]) => k !== "none" && k !== selectedSan)
+            .sort((a, b) => b[1] - a[1])
+            .map(([k]) => k);
+        if (selectedSan === "none" || confidence < confidenceThreshold) {
+            return {
+                query: userQuery,
+                matchedMove: null,
+                san: selectedSan,
+                confidence,
+                probabilities,
+                clarificationNeeded: true,
+                alternativeCandidates: sortedOptions.slice(0, 3),
+            };
+        }
+        const matched = candidates.find((c) => c.san === selectedSan) ?? null;
+        return {
+            query: userQuery,
+            matchedMove: matched,
+            san: selectedSan,
+            confidence,
+            probabilities,
+            clarificationNeeded: false,
+            alternativeCandidates: sortedOptions.slice(0, 2),
+        };
+    }
+}
+//# sourceMappingURL=moveResolver.js.map

package/dist/moveResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moveResolver.js","sourceRoot":"","sources":["../src/moveResolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGhE;;;GAGG;AACH,MAAM,OAAO,YAAY;IACvB,IAAY,MAAM;QAChB,OAAO,iBAAiB,EAAE,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,aAAa,CACxB,MAAmB,EACnB,SAAiB,EACjB,mBAAmB,GAAG,IAAI;QAE1B,MAAM,UAAU,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAE9C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO;gBACL,KAAK,EAAE,SAAS;gBAChB,WAAW,EAAE,IAAI;gBACjB,GAAG,EAAE,MAAM;gBACX,UAAU,EAAE,GAAG;gBACf,aAAa,EAAE,EAAE;gBACjB,mBAAmB,EAAE,KAAK;gBAC1B,qBAAqB,EAAE,EAAE;aAC1B,CAAC;QACJ,CAAC;QAED,yEAAyE;QACzE,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAChC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;YACtD,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CACtE,CAAC;QACF,IAAI,UAAU,EAAE,CAAC;YACf,OAAO;gBACL,KAAK,EAAE,SAAS;gBAChB,WAAW,EAAE,UAAU;gBACvB,GAAG,EAAE,UAAU,CAAC,GAAG;gBACnB,UAAU,EAAE,GAAG;gBACf,aAAa,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE;gBACxC,mBAAmB,EAAE,KAAK;gBAC1B,qBAAqB,EAAE,EAAE;aAC1B,CAAC;QACJ,CAAC;QAED,yCAAyC;QACzC,MAAM,QAAQ,GAA2B,EAAE,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;QAClC,CAAC;QACD,QAAQ,CAAC,MAAM,CAAC,GAAG,2DAA2D,CAAC;QAE/E,MAAM,KAAK,GAAG;YACZ,WAAW,EAAE,SAAS;YACtB,KAAK,EAAE;gBACL,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;gBACnB,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE;gBAC1B,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE;aAClB;YACD,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAClC,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,WAAW,EAAE,CAAC,CAAC,WAAW;aAC3B,CAAC,CAAC;SACJ,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;YAC3C,KAAK;YACL,SAAS,EAAE;gBACT,YAAY,EAAE,MAAM,CAClB,8FAA8F,EAC9F,QAAQ,CACT;aACF;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC;QAC7C,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;QAClC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACrC,MAAM,aAAa,GAAG,MAAM,CAAC,aAAuC,CAAC;QAErE,mCAAmC;QACnC,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC;aAChD,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,WAAW,CAAC;aAClD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aAC3B,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAEnB,IAAI,WAAW,KAAK,MAAM,IAAI,UAAU,GAAG,mBAAmB,EAAE,CAAC;YAC/D,OAAO;gBACL,KAAK,EAAE,SAAS;gBAChB,WAAW,EAAE,IAAI;gBACjB,GAAG,EAAE,WAAW;gBAChB,UAAU;gBACV,aAAa;gBACb,mBAAmB,EAAE,IAAI;gBACzB,qBAAqB,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACjD,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,WAAW,CAAC,IAAI,IAAI,CAAC;QAEtE,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,OAAO;YACpB,GAAG,EAAE,WAAW;YAChB,UAAU;YACV,aAAa;YACb,mBAAmB,EAAE,KAAK;YAC1B,qBAAqB,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACjD,CAAC;IACJ,CAAC;CACF"}

package/dist/personaEngine.d.ts

@@ -0,0 +1,15 @@
+import type { ChessEngine } from "./chessEngine.js";
+import type { PersonaDecision, PersonaId, PersonaProfile } from "./types.js";
+export declare const CHESS_PERSONAS: Record<PersonaId, PersonaProfile>;
+/**
+ * AI Opponent decision engine powered by TypeSafe Composite Scoring.
+ * Pattern: Atomic Multi-Dimensional Scoring + Client-Side Persona Weights.
+ */
+export declare class PersonaEngine {
+    private get client();
+    /**
+     * Scores candidate moves and selects the top move according to the persona's style.
+     */
+    selectMove(engine: ChessEngine, personaId: PersonaId, candidateLimit?: number): Promise<PersonaDecision>;
+}
+//# sourceMappingURL=personaEngine.d.ts.map

package/dist/personaEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personaEngine.d.ts","sourceRoot":"","sources":["../src/personaEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAGV,eAAe,EACf,SAAS,EACT,cAAc,EAEf,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE,cAAc,CAmD5D,CAAC;AAuBF;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,KAAK,MAAM,GAEjB;IAED;;OAEG;IACU,UAAU,CACrB,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,SAAS,EACpB,cAAc,SAAI,GACjB,OAAO,CAAC,eAAe,CAAC,CA0F1B;CACF"}

package/dist/personaEngine.js

@@ -0,0 +1,151 @@
+import { getTypeSafeClient, noul, score } from "./typeSafeClient.js";
+export const CHESS_PERSONAS = {
+    tal: {
+        id: "tal",
+        name: "Mikhail Tal",
+        title: "The Magician from Riga",
+        quote: "You must take your opponent into a deep dark forest where 2+2=5, and the path leading out is only wide enough for one.",
+        weights: {
+            aggression: 0.45,
+            prophylaxis: -0.15,
+            complexity: 0.5,
+            materialGreed: -0.2,
+        },
+    },
+    petrosian: {
+        id: "petrosian",
+        name: "Tigran Petrosian",
+        title: "Iron Tigran",
+        quote: "Nothing can be done against me; my position is so solid.",
+        weights: {
+            aggression: 0.05,
+            prophylaxis: 0.65,
+            complexity: -0.3,
+            materialGreed: 0.2,
+        },
+    },
+    capablanca: {
+        id: "capablanca",
+        name: "José Raúl Capablanca",
+        title: "The Chess Machine",
+        quote: "A master plays simple chess, puts pieces where they belong, and simplifies into a clean endgame.",
+        weights: {
+            aggression: 0.2,
+            prophylaxis: 0.35,
+            complexity: -0.4,
+            materialGreed: 0.45,
+        },
+    },
+    coffeehouse: {
+        id: "coffeehouse",
+        name: "Coffeehouse Gambiteer",
+        title: "Romantic Hustler",
+        quote: "Checks are free, pawn storms are mandatory, and danger lurks on every rank.",
+        weights: {
+            aggression: 0.55,
+            prophylaxis: -0.35,
+            complexity: 0.4,
+            materialGreed: -0.1,
+        },
+    },
+};
+const AGGRESSION_RUBRIC = [
+    "Passive retreat, backward consolidation, or defensive block",
+    "Neutral developing maneuver or quiet regrouping",
+    "Forward thrust, central pressure, or active threat creation",
+    "Direct sacrifice, attack on the king, or fierce tactical challenge",
+];
+const PROPHYLAXIS_RUBRIC = [
+    "Completely ignores king safety and opponent counterplay",
+    "Standard move with ordinary tactical exposure",
+    "Solid, patient reinforcement of weaknesses or squares",
+    "Deep prophylactic suppression of opponent counter-ideas",
+];
+const COMPLEXITY_RUBRIC = [
+    "Clarifies position, forces trades, or liquidates tension",
+    "Steady, orderly position with clear structural goals",
+    "Introduces sharp asymmetry, unbalances, and multiple branches",
+    "Maximum chaos: highly volatile tactical minefield",
+];
+/**
+ * AI Opponent decision engine powered by TypeSafe Composite Scoring.
+ * Pattern: Atomic Multi-Dimensional Scoring + Client-Side Persona Weights.
+ */
+export class PersonaEngine {
+    get client() {
+        return getTypeSafeClient();
+    }
+    /**
+     * Scores candidate moves and selects the top move according to the persona's style.
+     */
+    async selectMove(engine, personaId, candidateLimit = 5) {
+        const persona = CHESS_PERSONAS[personaId];
+        const allMoves = engine.getAnnotatedMoves();
+        if (allMoves.length === 0) {
+            throw new Error("No legal moves available in current position.");
+        }
+        // Candidate selection: curate a diverse pool representing varied styles
+        // (tactical strikes, prophylactic castle/pawn moves, central development)
+        const tacticalMoves = allMoves.filter((m) => m.isCheck || m.isCapture);
+        const quietMoves = allMoves.filter((m) => !m.isCheck && !m.isCapture);
+        const pool = [];
+        if (tacticalMoves.length > 0)
+            pool.push(...tacticalMoves.slice(0, 2));
+        if (quietMoves.length > 0)
+            pool.push(...quietMoves.slice(0, Math.max(2, candidateLimit - pool.length)));
+        const candidates = pool.slice(0, candidateLimit);
+        const scoredCandidates = [];
+        // Evaluate each candidate move across atomic dimensions
+        for (const move of candidates) {
+            const state = {
+                candidate_move: {
+                    san: move.san,
+                    description: move.description,
+                    is_capture: move.isCapture,
+                    is_check: move.isCheck,
+                },
+                board: {
+                    turn: engine.turn(),
+                    fen: engine.fen(),
+                    material: engine.getMaterialBalance().description,
+                },
+            };
+            const response = await this.client.systemOne({
+                state,
+                questions: {
+                    aggression: score("How aggressive and attacking is `candidate_move.san`?", AGGRESSION_RUBRIC),
+                    prophylaxis: score("How well does `candidate_move.san` ensure safety and stifle opponent counterplay?", PROPHYLAXIS_RUBRIC),
+                    complexity: score("How much tactical tension and complexity does `candidate_move.san` inject into the board?", COMPLEXITY_RUBRIC),
+                    material_greed: noul("Is the move `candidate_move.san` primarily motivated by winning or defending material?"),
+                },
+            });
+            const dimScores = {
+                aggression: response.answers.aggression.score,
+                prophylaxis: response.answers.prophylaxis.score,
+                complexity: response.answers.complexity.score,
+                materialGreed: response.answers.material_greed.noul,
+            };
+            // Composite scoring formula in code
+            const compositeScore = persona.weights.aggression * dimScores.aggression +
+                persona.weights.prophylaxis * dimScores.prophylaxis +
+                persona.weights.complexity * dimScores.complexity +
+                persona.weights.materialGreed * dimScores.materialGreed;
+            scoredCandidates.push({
+                move,
+                compositeScore: Math.round(compositeScore * 1000) / 1000,
+                dimensionScores: dimScores,
+            });
+        }
+        // Sort by composite score descending
+        scoredCandidates.sort((a, b) => b.compositeScore - a.compositeScore);
+        const best = scoredCandidates[0];
+        const rationale = `${persona.name} (${persona.title}) selected ${best.move.san} with composite score ${best.compositeScore} (Aggression: ${best.dimensionScores.aggression.toFixed(1)}, Prophylaxis: ${best.dimensionScores.prophylaxis.toFixed(1)}, Complexity: ${best.dimensionScores.complexity.toFixed(1)}, Greed: ${best.dimensionScores.materialGreed.toFixed(2)}).`;
+        return {
+            persona,
+            selectedMove: best.move,
+            rankedCandidates: scoredCandidates,
+            rationale,
+        };
+    }
+}
+//# sourceMappingURL=personaEngine.js.map

package/dist/personaEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"personaEngine.js","sourceRoot":"","sources":["../src/personaEngine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAUrE,MAAM,CAAC,MAAM,cAAc,GAAsC;IAC/D,GAAG,EAAE;QACH,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,wBAAwB;QAC/B,KAAK,EACH,wHAAwH;QAC1H,OAAO,EAAE;YACP,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,CAAC,IAAI;YAClB,UAAU,EAAE,GAAG;YACf,aAAa,EAAE,CAAC,GAAG;SACpB;KACF;IACD,SAAS,EAAE;QACT,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE,0DAA0D;QACjE,OAAO,EAAE;YACP,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,CAAC,GAAG;YAChB,aAAa,EAAE,GAAG;SACnB;KACF;IACD,UAAU,EAAE;QACV,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,mBAAmB;QAC1B,KAAK,EACH,kGAAkG;QACpG,OAAO,EAAE;YACP,UAAU,EAAE,GAAG;YACf,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,CAAC,GAAG;YAChB,aAAa,EAAE,IAAI;SACpB;KACF;IACD,WAAW,EAAE;QACX,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,uBAAuB;QAC7B,KAAK,EAAE,kBAAkB;QACzB,KAAK,EAAE,6EAA6E;QACpF,OAAO,EAAE;YACP,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,CAAC,IAAI;YAClB,UAAU,EAAE,GAAG;YACf,aAAa,EAAE,CAAC,GAAG;SACpB;KACF;CACF,CAAC;AAEF,MAAM,iBAAiB,GAAG;IACxB,6DAA6D;IAC7D,iDAAiD;IACjD,6DAA6D;IAC7D,oEAAoE;CAC5D,CAAC;AAEX,MAAM,kBAAkB,GAAG;IACzB,yDAAyD;IACzD,+CAA+C;IAC/C,uDAAuD;IACvD,yDAAyD;CACjD,CAAC;AAEX,MAAM,iBAAiB,GAAG;IACxB,0DAA0D;IAC1D,sDAAsD;IACtD,+DAA+D;IAC/D,mDAAmD;CAC3C,CAAC;AAEX;;;GAGG;AACH,MAAM,OAAO,aAAa;IACxB,IAAY,MAAM;QAChB,OAAO,iBAAiB,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,UAAU,CACrB,MAAmB,EACnB,SAAoB,EACpB,cAAc,GAAG,CAAC;QAElB,MAAM,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAE5C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,wEAAwE;QACxE,0EAA0E;QAC1E,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC;QACvE,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAEtE,MAAM,IAAI,GAAoB,EAAE,CAAC;QACjC,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACtE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAExG,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;QACjD,MAAM,gBAAgB,GAAwB,EAAE,CAAC;QAEjD,wDAAwD;QACxD,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG;gBACZ,cAAc,EAAE;oBACd,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,UAAU,EAAE,IAAI,CAAC,SAAS;oBAC1B,QAAQ,EAAE,IAAI,CAAC,OAAO;iBACvB;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;oBACnB,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE;oBACjB,QAAQ,EAAE,MAAM,CAAC,kBAAkB,EAAE,CAAC,WAAW;iBAClD;aACF,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;gBAC3C,KAAK;gBACL,SAAS,EAAE;oBACT,UAAU,EAAE,KAAK,CACf,uDAAuD,EACvD,iBAAiB,CAClB;oBACD,WAAW,EAAE,KAAK,CAChB,mFAAmF,EACnF,kBAAkB,CACnB;oBACD,UAAU,EAAE,KAAK,CACf,2FAA2F,EAC3F,iBAAiB,CAClB;oBACD,cAAc,EAAE,IAAI,CAClB,wFAAwF,CACzF;iBACF;aACF,CAAC,CAAC;YAEH,MAAM,SAAS,GAAoB;gBACjC,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK;gBAC7C,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK;gBAC/C,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK;gBAC7C,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI;aACpD,CAAC;YAEF,oCAAoC;YACpC,MAAM,cAAc,GAClB,OAAO,CAAC,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU;gBACjD,OAAO,CAAC,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,WAAW;gBACnD,OAAO,CAAC,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU;gBACjD,OAAO,CAAC,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;YAE1D,gBAAgB,CAAC,IAAI,CAAC;gBACpB,IAAI;gBACJ,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,IAAI;gBACxD,eAAe,EAAE,SAAS;aAC3B,CAAC,CAAC;QACL,CAAC;QAED,qCAAqC;QACrC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC;QAErE,MAAM,IAAI,GAAG,gBAAgB,CAAC,CAAC,CAAE,CAAC;QAClC,MAAM,SAAS,GAAG,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,KAAK,cAAc,IAAI,CAAC,IAAI,CAAC,GAAG,yBAAyB,IAAI,CAAC,cAAc,iBAAiB,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAE3W,OAAO;YACL,OAAO;YACP,YAAY,EAAE,IAAI,CAAC,IAAI;YACvB,gBAAgB,EAAE,gBAAgB;YAClC,SAAS;SACV,CAAC;IACJ,CAAC;CACF"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}