getcompetitive 5.0.0 → 6.1.0

package/dist/tools/scout.js

@@ -0,0 +1,135 @@
+/**
+ * Scouting: replay → normalized battle observations → set inference → rematch
+ * preparation, one deterministic pipeline. The player pastes their team (the
+ * sets the replay cannot contain), the log, and the opponent species to
+ * scout; this extracts what the log proves about it (Speed relations against
+ * known members, damage it took from them, item and ability reveals) and runs
+ * the shared SetInferenceEngine. The model explains the result;
+ * getcompetitive proved it.
+ */
+import { z } from 'zod';
+import { toID } from '../dex.js';
+import { runInference } from '../inference.js';
+import { ok, wrap, READ_ONLY_ANNOTATIONS } from '../result.js';
+import { parseReplay } from './replay.js';
+import { parsedSetSchema, resolveMembers } from './team.js';
+export function registerScoutTool(server) {
+    server.registerTool('scout_opponent', {
+        title: 'Scout an opponent from a replay',
+        description: 'One deterministic pipeline: replay → battle observations → set inference → rematch preparation. Paste the battle log, your team with its real sets (the log cannot contain them), and the opponent species to scout; the tool extracts what the log proves about it — Speed relations against your known members, the damage it took from them, and any item or ability the log revealed — and runs the same SetInferenceEngine the "infer" mode uses, so the surviving candidate sets come with the narrowing shown. The rematch note points the result at `prepare_matchup`. A log proves only what it contains: every extracted observation is restated so the scouting is auditable. Read-only and offline.',
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            log: z.string().describe('The battle log text, exactly as exported (lines beginning with |).'),
+            team: z
+                .array(parsedSetSchema)
+                .min(1)
+                .max(6)
+                .describe('Your team with its real sets — the Speed reference and the attackers\u2019 damage math need them.'),
+            species: z.string().describe('The opponent species to scout, e.g. "Sneasler"; must appear on the opposing side of the log.'),
+            regulation: z.string().optional().describe('Regulation id, e.g. "m-c"; scopes the meta prior for the inference.'),
+        },
+        outputSchema: {
+            target: z.string().describe('The scouted species as resolved.'),
+            observations: z.array(z.string()).describe('Every battle observation the log yielded, restated in order.'),
+            observedMoves: z.array(z.string()).optional().describe('Moves the log shows the target using; present when it used any.'),
+            inference: z
+                .object({
+                species: z.string().describe('The species as resolved.'),
+                priorSets: z.number().int().describe('Candidate sets considered before any observation.'),
+                survivingSets: z.number().int().describe('Candidates still possible after the last observation.'),
+                constraints: z.array(z.object({ observation: z.string(), before: z.number().int(), after: z.number().int(), eliminated: z.number().int() })).describe('The narrowing, shown.'),
+                candidates: z
+                    .array(z.object({
+                    item: z.string().optional(),
+                    ability: z.string(),
+                    nature: z.string(),
+                    evs: z.record(z.string(), z.number()),
+                    speed: z.number().int(),
+                    probability: z.number(),
+                }))
+                    .describe('The surviving sets, most likely first.'),
+                note: z.string().describe('The engine\u2019s assumptions.'),
+            })
+                .describe('The set inference over the extracted observations.'),
+            rematch: z.object({ note: z.string().describe('How to feed the result into prepare_matchup for the rematch.') }),
+        },
+    }, wrap(async (args) => {
+        const { members } = resolveMembers(args.team);
+        const replay = parseReplay(args.log);
+        const memberByName = new Map(members.map((m) => [toID(m.species), m]));
+        const ourSide = ['p1', 'p2'].find((side) => replay.teams[side].some((name) => memberByName.has(toID(name)))) ?? 'p1';
+        const theirSide = ourSide === 'p1' ? 'p2' : 'p1';
+        const targetKey = toID(args.species);
+        if (!replay.teams[theirSide].some((name) => toID(name) === targetKey)) {
+            throw new Error(`"${args.species}" was not seen on the opposing side (${replay.teams[theirSide].join(', ')}); your side resolved to ${ourSide}.`);
+        }
+        const targetName = replay.teams[theirSide].find((name) => toID(name) === targetKey);
+        const observations = [];
+        const observedMoves = new Set();
+        for (const s of replay.speed) {
+            if (observations.filter((o) => o.kind === 'speed').length >= 4)
+                break;
+            const fasterName = (s.faster.split(':')[1] ?? '').trim();
+            const slowerName = (s.slower.split(':')[1] ?? '').trim();
+            const fasterIsTarget = toID(fasterName) === targetKey;
+            const slowerIsTarget = toID(slowerName) === targetKey;
+            const ours = fasterIsTarget ? memberByName.get(toID(slowerName)) : slowerIsTarget ? memberByName.get(toID(fasterName)) : undefined;
+            if (!ours)
+                continue;
+            observations.push(fasterIsTarget
+                ? { kind: 'speed', referenceSpeed: ours.speed, relation: 'outsped' }
+                : { kind: 'speed', referenceSpeed: ours.speed, relation: 'outspeeds' });
+        }
+        for (const d of replay.damage) {
+            if (observations.filter((o) => o.kind === 'damageTaken').length >= 4)
+                break;
+            const defenderName = (d.defender.split(':')[1] ?? '').trim();
+            if (toID(defenderName) !== targetKey)
+                continue;
+            const attackerName = (d.attacker.split(':')[1] ?? '').trim();
+            const ours = memberByName.get(toID(attackerName));
+            if (!ours)
+                continue;
+            observations.push({
+                kind: 'damageTaken',
+                move: d.move,
+                attacker: {
+                    species: ours.species,
+                    ...(ours.set.nature ? { nature: ours.set.nature } : {}),
+                    ...(ours.set.evs ? { evs: ours.set.evs } : {}),
+                    ...(ours.set.championsPoints ? { championsPoints: ours.set.championsPoints } : {}),
+                    ...(ours.set.item ? { item: ours.set.item } : {}),
+                    ...(ours.set.ability ? { ability: ours.set.ability } : {}),
+                },
+                // The log reports cumulative HP; the observation needs the per-hit share.
+                percentTaken: d.taken,
+            });
+        }
+        for (const [posKey, name] of Object.entries(replay.positions)) {
+            if (toID(name) !== targetKey)
+                continue;
+            const item = replay.itemReveals[posKey];
+            if (item && !observations.some((o) => o.kind === 'item'))
+                observations.push({ kind: 'item', item });
+            const ability = replay.abilityReveals[posKey];
+            if (ability && !observations.some((o) => o.kind === 'ability'))
+                observations.push({ kind: 'ability', ability });
+            for (const move of replay.movesByPos[posKey] ?? [])
+                observedMoves.add(move);
+        }
+        if (!observations.length) {
+            throw new Error(`The log contains no usable observations about ${targetName}: no Speed relations against your members, no damage it took from them, and no reveals.`);
+        }
+        const inference = runInference(targetName, observations.slice(0, 8), args.regulation);
+        return ok({
+            target: inference.species,
+            observations: inference.constraints.map((c) => c.observation),
+            ...(observedMoves.size ? { observedMoves: [...observedMoves] } : {}),
+            inference,
+            rematch: {
+                note: 'Feed the surviving candidates into prepare_matchup as the opponent\u2019s sets — the top candidate is the set to prepare for, the spread across candidates is the uncertainty to respect.',
+            },
+        });
+    }));
+}
+//# sourceMappingURL=scout.js.map

package/dist/tools/scout.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "getcompetitive",
-  "version": "5.0.0",
+  "version": "6.1.0",
   "description": "MCP server exposing competitive Pokemon data and battle mechanics for team building and decision making",
   "type": "module",
   "bin": {