poke-crucible 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Public API for the poke-crucible evaluation harness.
+ *
+ * The single seam is {@link evaluate}; everything else (Team I/O, the Pilot, the
+ * runner, the Gauntlet loader) is reached through it. Later slices — the Critic,
+ * then the Designer — build on this stable entry point rather than the CLI.
+ */
+export { evaluate } from './evaluate.js';
+export type { EvaluateRuntimeOptions } from './evaluate.js';
+export { loadGauntlet, knownGauntletVersions, DEFAULT_GAUNTLET_VERSION, GAUNTLET_VERSION, type Gauntlet, type GauntletMember, } from './gauntlet/gauntlet.js';
+export * from './types.js';
+export { critique, critiqueTeam, type CritiqueTeamOptions } from './critic/critique.js';
+export { StubCritiqueModel, type CritiqueModel } from './critic/llm.js';
+export { AgentSdkCritiqueModel, DEFAULT_CRITIC_MODEL, type AgentSdkModelOptions, } from './critic/agent-sdk-model.js';
+export { CritiqueParseError } from './critic/parse.js';
+export type { Critique, CritiqueInput, CritiqueWeakness, CritiqueFix, Severity, } from './critic/types.js';
+export type { CritiqueContext } from './critic/evidence.js';
+export { buildContext } from './critic/evidence.js';
+export { buildPrompt, PILOT_CAVEAT, type CritiquePrompt } from './critic/prompt.js';
+export { design, PILOT_ID } from './designer/design.js';
+export { StubDesignerModel } from './designer/model.js';
+export { AgentSdkDesignerModel, DEFAULT_DESIGNER_MODEL, type AgentSdkDesignerOptions, } from './designer/agent-sdk-model.js';
+export { composite, fitnessParts, robustnessFloor, DEFAULT_WEIGHTS } from './designer/fitness.js';
+export { buildGenePool, buildMovePool, mutate, crossover, isLegal } from './designer/mutate.js';
+export type { DesignInput, DesignResult, DesignedTeam, DesignBudget, DesignerModel, FitnessWeights, FitnessParts, Lineage, Origin, } from './designer/types.js';

package/dist/index.js

@@ -0,0 +1,24 @@
+/**
+ * Public API for the poke-crucible evaluation harness.
+ *
+ * The single seam is {@link evaluate}; everything else (Team I/O, the Pilot, the
+ * runner, the Gauntlet loader) is reached through it. Later slices — the Critic,
+ * then the Designer — build on this stable entry point rather than the CLI.
+ */
+export { evaluate } from './evaluate.js';
+export { loadGauntlet, knownGauntletVersions, DEFAULT_GAUNTLET_VERSION, GAUNTLET_VERSION, } from './gauntlet/gauntlet.js';
+export * from './types.js';
+// Slice 2 — the Critic (LLM behind the CritiqueModel seam).
+export { critique, critiqueTeam } from './critic/critique.js';
+export { StubCritiqueModel } from './critic/llm.js';
+export { AgentSdkCritiqueModel, DEFAULT_CRITIC_MODEL, } from './critic/agent-sdk-model.js';
+export { CritiqueParseError } from './critic/parse.js';
+export { buildContext } from './critic/evidence.js';
+export { buildPrompt, PILOT_CAVEAT } from './critic/prompt.js';
+// Slice 3 — the Designer (evolutionary discovery over the evaluate() seam).
+export { design, PILOT_ID } from './designer/design.js';
+export { StubDesignerModel } from './designer/model.js';
+export { AgentSdkDesignerModel, DEFAULT_DESIGNER_MODEL, } from './designer/agent-sdk-model.js';
+export { composite, fitnessParts, robustnessFloor, DEFAULT_WEIGHTS } from './designer/fitness.js';
+export { buildGenePool, buildMovePool, mutate, crossover, isLegal } from './designer/mutate.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,GAGjB,MAAM,wBAAwB,CAAC;AAChC,cAAc,YAAY,CAAC;AAE3B,4DAA4D;AAC5D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAA4B,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAsB,MAAM,iBAAiB,CAAC;AACxE,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GAErB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AASvD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAuB,MAAM,oBAAoB,CAAC;AAEpF,4EAA4E;AAC5E,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GAEvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAClG,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/llm/agent-query.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared Claude Agent SDK call — one place both the Critic and the Designer
+ * reach the LLM. Runs `query()` once, headless: our system prompt replaces the
+ * default, all built-in tools are disabled and denied, `.claude` config is
+ * ignored, and there's a wall-clock guard so it can't hang.
+ *
+ * AUTH: the Claude Code OAuth credential (`claude` login or `CLAUDE_CODE_OAUTH_TOKEN`),
+ * billing the maintainer's subscription. `ANTHROPIC_API_KEY` shadows it and
+ * reverts to pay-per-token — a one-time warning fires before any billable call.
+ */
+export type Effort = 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+export interface AgentQueryOptions {
+    model: string;
+    /** Default `low` — a single-pass generation needs no deep thinking, and Claude
+     *  Code otherwise defaults to high effort (minute-plus of thinking). */
+    effort?: Effort;
+    /** Wall-clock cap; the query is interrupted past this. Default 90s. */
+    timeoutMs?: number;
+}
+/** Run one headless Agent-SDK query and return the model's text. */
+export declare function runAgentQuery(system: string, user: string, options: AgentQueryOptions): Promise<string>;

package/dist/llm/agent-query.js

@@ -0,0 +1,70 @@
+const NO_TOOLS = 'You have no tools available. Do not attempt to call any tool, read any file, ' +
+    'or run any command. Respond with ONLY what is asked and nothing else.';
+let apiKeyWarningShown = false;
+function warnIfApiKeyShadows() {
+    if (!apiKeyWarningShown && process.env['ANTHROPIC_API_KEY']) {
+        apiKeyWarningShown = true;
+        process.stderr.write('poke-crucible: ANTHROPIC_API_KEY is set — LLM calls will bill pay-per-token, ' +
+            'not your Claude subscription. Unset it to use the subscription.\n');
+    }
+}
+/** Run one headless Agent-SDK query and return the model's text. */
+export async function runAgentQuery(system, user, options) {
+    warnIfApiKeyShadows();
+    const { query } = await import('@anthropic-ai/claude-agent-sdk');
+    const timeoutMs = options.timeoutMs ?? 90_000;
+    const stream = query({
+        prompt: user,
+        options: {
+            systemPrompt: `${NO_TOOLS}\n\n${system}`,
+            model: options.model,
+            effort: options.effort ?? 'low',
+            allowedTools: [],
+            permissionMode: 'dontAsk', // headless auto-deny instead of blocking on approval
+            settingSources: [],
+            maxTurns: 6,
+        },
+    });
+    let timedOut = false;
+    const timer = setTimeout(() => {
+        timedOut = true;
+        try {
+            stream.interrupt?.();
+        }
+        catch {
+            /* best effort */
+        }
+    }, timeoutMs);
+    let assistantText = '';
+    let resultText;
+    try {
+        for await (const message of stream) {
+            if (message['type'] === 'assistant') {
+                const inner = message['message'];
+                const blocks = Array.isArray(inner?.content) ? inner.content : [];
+                for (const b of blocks) {
+                    const block = b;
+                    if (block.type === 'text' && typeof block.text === 'string')
+                        assistantText += block.text;
+                }
+            }
+            else if (message['type'] === 'result') {
+                const result = message['result'];
+                if (typeof result === 'string')
+                    resultText = result;
+            }
+        }
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    const text = (resultText ?? assistantText).trim();
+    if (!text) {
+        if (timedOut)
+            throw new Error(`Agent SDK timed out after ${timeoutMs}ms with no output.`);
+        throw new Error('Agent SDK returned no text. Check auth: log in with `claude`, and ensure ' +
+            'ANTHROPIC_API_KEY is unset (it shadows the subscription OAuth token).');
+    }
+    return text;
+}
+//# sourceMappingURL=agent-query.js.map

package/dist/llm/agent-query.js.map

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

package/dist/pilot/damage.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Damage and type-matchup estimation for the Pilot.
+ *
+ * These are *heuristic* estimates, not the sim's exact damage calc: enough to
+ * rank moves, judge KOs, and weigh switch-ins for competent greedy play. Gen 3
+ * specifics baked in here: a move's Physical/Special category follows its
+ * TYPE (the sim's gen3 dex already reflects this), STAB is 1.5x, and the
+ * effectiveness multiplier is `2 ** dex.getEffectiveness(...)`.
+ */
+import type { Battle, Pokemon } from '@pkmn/sim';
+export interface ResolvedMove {
+    id: string;
+    name: string;
+    type: string;
+    category: 'Physical' | 'Special' | 'Status';
+    basePower: number;
+    /** Accuracy as a probability in [0, 1] (a never-miss move is 1). */
+    accuracy: number;
+}
+/** Resolve a move by its set name (so `Hidden Power Bug` gets its real type/power). */
+export declare function resolveMove(battle: Battle, name: string): ResolvedMove;
+/**
+ * Type-effectiveness multiplier of `moveType` against a defender, accounting
+ * for the ability-based immunities that matter for Gen 3 OU switching.
+ */
+export declare function typeMultiplier(battle: Battle, moveType: string, defender: Pokemon): number;
+/**
+ * Estimated damage as a fraction of the defender's max HP if the move hits.
+ * Uses the Gen 3 damage formula at level 100 with an average roll; folds in
+ * STAB, type effectiveness, burn, and Choice Band.
+ */
+export declare function estimateDamageFraction(battle: Battle, attacker: Pokemon, defender: Pokemon, move: ResolvedMove): number;
+/** The single move (across all of `attacker`'s slots) that hits `defender` hardest. */
+export declare function bestDamageFraction(battle: Battle, attacker: Pokemon, defender: Pokemon): number;

package/dist/pilot/damage.js

@@ -0,0 +1,75 @@
+/** Resolve a move by its set name (so `Hidden Power Bug` gets its real type/power). */
+export function resolveMove(battle, name) {
+    const m = battle.dex.moves.get(name);
+    const accuracy = m.accuracy === true ? 1 : m.accuracy / 100;
+    return {
+        id: m.id,
+        name: m.name,
+        type: m.type,
+        category: m.category,
+        basePower: m.basePower,
+        accuracy,
+    };
+}
+/**
+ * Type-effectiveness multiplier of `moveType` against a defender, accounting
+ * for the ability-based immunities that matter for Gen 3 OU switching.
+ */
+export function typeMultiplier(battle, moveType, defender) {
+    const ability = defender.ability;
+    if (ability === 'levitate' && moveType === 'Ground')
+        return 0;
+    if (ability === 'flashfire' && moveType === 'Fire')
+        return 0;
+    if (ability === 'waterabsorb' && moveType === 'Water')
+        return 0;
+    if (ability === 'voltabsorb' && moveType === 'Electric')
+        return 0;
+    const types = defender.types;
+    if (!battle.dex.getImmunity(moveType, types))
+        return 0;
+    let mult = Math.pow(2, battle.dex.getEffectiveness(moveType, types));
+    if (ability === 'thickfat' && (moveType === 'Fire' || moveType === 'Ice'))
+        mult *= 0.5;
+    // Wonder Guard (Shedinja): only super-effective hits land.
+    if (ability === 'wonderguard' && mult <= 1)
+        return 0;
+    return mult;
+}
+/**
+ * Estimated damage as a fraction of the defender's max HP if the move hits.
+ * Uses the Gen 3 damage formula at level 100 with an average roll; folds in
+ * STAB, type effectiveness, burn, and Choice Band.
+ */
+export function estimateDamageFraction(battle, attacker, defender, move) {
+    if (move.category === 'Status' || move.basePower <= 0)
+        return 0;
+    const mult = typeMultiplier(battle, move.type, defender);
+    if (mult === 0)
+        return 0;
+    const physical = move.category === 'Physical';
+    const atk = attacker.getStat(physical ? 'atk' : 'spa');
+    const def = Math.max(1, defender.getStat(physical ? 'def' : 'spd'));
+    const stab = attacker.types.includes(move.type) ? 1.5 : 1;
+    const level = attacker.level || 100;
+    let power = move.basePower;
+    if (physical && attacker.item === 'choiceband')
+        power *= 1.5;
+    let damage = ((((2 * level) / 5 + 2) * power * atk) / def / 50 + 2) * stab * mult;
+    damage *= 0.925; // average of the 0.85–1.00 damage roll
+    if (physical && attacker.status === 'brn')
+        damage *= 0.5;
+    return damage / Math.max(1, defender.maxhp);
+}
+/** The single move (across all of `attacker`'s slots) that hits `defender` hardest. */
+export function bestDamageFraction(battle, attacker, defender) {
+    let best = 0;
+    attacker.moveSlots.forEach((slot, i) => {
+        const name = attacker.set?.moves?.[i] ?? slot.id;
+        const f = estimateDamageFraction(battle, attacker, defender, resolveMove(battle, name));
+        if (f > best)
+            best = f;
+    });
+    return best;
+}
+//# sourceMappingURL=damage.js.map

package/dist/pilot/damage.js.map

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

package/dist/pilot/eval-pilot.d.ts

@@ -0,0 +1,39 @@
+/**
+ * EXPERIMENT (ADR 0004): a positional-evaluation Pilot. Instead of "pick max
+ * immediate damage", it scores each candidate action by a 1-ply *heuristic*
+ * estimate of the resulting position (no sim clone — real-sim forking is
+ * infeasible) and picks the best. The evaluation rewards the assets stall
+ * accrues: HP and material, foe status (attrition), hazards, boosts.
+ *
+ * Swapped in via POKE_PILOT=eval for A/B measurement on the archetype ladder.
+ * Throwaway until the ladder shows it helps; see ADR 0004.
+ */
+import type { Battle } from '@pkmn/sim';
+type SideID = 'p1' | 'p2';
+interface RM {
+    move: string;
+    id: string;
+    pp?: number;
+    disabled?: boolean | string;
+}
+interface RA {
+    moves: RM[];
+    trapped?: boolean;
+    maybeTrapped?: boolean;
+}
+interface RP {
+    ident: string;
+    details: string;
+    condition: string;
+    active?: boolean;
+}
+interface Req {
+    active?: RA[];
+    side: {
+        pokemon: RP[];
+    };
+    forceSwitch?: boolean[];
+    wait?: boolean;
+}
+export declare function chooseActionEval(battle: Battle, sideID: SideID, request: Req): string;
+export {};

package/dist/pilot/eval-pilot.js

@@ -0,0 +1,161 @@
+import { bestDamageFraction, estimateDamageFraction, resolveMove } from './damage.js';
+const RECOVERY = new Set([
+    'recover', 'softboiled', 'milkdrink', 'slackoff', 'moonlight', 'morningsun', 'synthesis', 'rest', 'wish',
+]);
+const SETUP = {
+    swordsdance: { stat: 'atk', cap: 2 }, dragondance: { stat: 'atk', cap: 2 }, bulkup: { stat: 'atk', cap: 2 },
+    curse: { stat: 'atk', cap: 2 }, calmmind: { stat: 'spa', cap: 3 }, agility: { stat: 'spe', cap: 2 },
+};
+const PARALYZE = new Set(['thunderwave', 'stunspore', 'glare']);
+const BURN = new Set(['willowisp']);
+const PHAZE = new Set(['roar', 'whirlwind']);
+const hpFrac = (p) => (p.maxhp > 0 ? p.hp / p.maxhp : 0);
+function effSpeed(p) { let s = p.getStat('spe'); if (p.status === 'par')
+    s = Math.floor(s * 0.25); return s; }
+function spikes(side) { const c = side.sideConditions?.['spikes']; return c ? (typeof c.layers === 'number' ? c.layers : 1) : 0; }
+const isFainted = (rp) => rp.condition.includes('fnt');
+function battleMon(team, rp) { const sp = (rp.details.split(',')[0] ?? '').trim(); return team.find((m) => m && m.species && m.species.name === sp) ?? null; }
+function statusVal(status) {
+    switch (status) {
+        case 'tox': return 0.4;
+        case 'brn': return 0.25;
+        case 'psn': return 0.2;
+        case 'par': return 0.2;
+        case 'slp': return 0.3;
+        case 'frz': return 0.5;
+        default: return 0;
+    }
+}
+function sideTotals(side) { let hp = 0, alive = 0; for (const p of side.pokemon)
+    if (p.hp > 0) {
+        alive++;
+        hp += p.hp / p.maxhp;
+    } return { hp, alive }; }
+const canToxic = (foe) => !foe.types.includes('Steel') && !foe.types.includes('Poison') && foe.ability !== 'immunity';
+const canBurn = (foe) => !foe.types.includes('Fire') && foe.ability !== 'waterveil';
+function classify(m) {
+    if (RECOVERY.has(m.id))
+        return 'recover';
+    if (m.id === 'spikes')
+        return 'spikes';
+    if (m.id === 'rapidspin')
+        return 'spin';
+    if (m.id === 'toxic')
+        return 'toxic';
+    if (BURN.has(m.id))
+        return 'wisp';
+    if (PARALYZE.has(m.id))
+        return 'para';
+    if (PHAZE.has(m.id))
+        return 'phaze';
+    if (SETUP[m.id])
+        return 'setup';
+    if (m.category !== 'Status' && m.basePower > 0)
+        return 'damage';
+    return 'other';
+}
+// Weighted position score (my perspective) from post-turn scalar estimates.
+function score(myHp, foeHp, myAlive, foeAlive, foeStatus, myStatus, foeSpikes, mySpikes, boost) {
+    return (myHp - foeHp) + 0.8 * (myAlive - foeAlive) + (foeStatus - myStatus)
+        + 0.15 * (foeSpikes - mySpikes) + 0.3 * boost;
+}
+/** Estimate the position score after I use `move` this turn and the foe replies. */
+function scoreMove(battle, myIdx, move) {
+    const me = battle.sides[myIdx], foe = battle.sides[1 - myIdx];
+    const ma = me.active[0], fa = foe.active[0];
+    const mt = sideTotals(me), ft = sideTotals(foe);
+    const kind = classify(move);
+    let myActive = hpFrac(ma), foeActive = hpFrac(fa);
+    let foeStatus = statusVal(fa.status), myStatus = statusVal(ma.status);
+    let fSpikes = spikes(foe), mSpikes = spikes(me), boost = 0;
+    const myDmg = estimateDamageFraction(battle, ma, fa, move) * (move.accuracy || 1);
+    const foeDmg = bestDamageFraction(battle, fa, ma);
+    const iFaster = effSpeed(ma) > effSpeed(fa);
+    if (kind === 'recover')
+        myActive = Math.min(1, myActive + Math.min(0.5, 1 - myActive));
+    if (kind === 'spikes' && fSpikes < 3)
+        fSpikes += 1;
+    if (kind === 'spin')
+        mSpikes = 0;
+    if (kind === 'toxic' && fa.status === '' && canToxic(fa))
+        foeStatus = statusVal('tox');
+    if (kind === 'wisp' && fa.status === '' && canBurn(fa))
+        foeStatus = statusVal('brn');
+    if (kind === 'para' && fa.status === '')
+        foeStatus = statusVal('par');
+    if (kind === 'setup') {
+        const s = SETUP[move.id];
+        if (ma.boosts[s.stat] < s.cap)
+            boost = 1;
+    }
+    // Resolve the HP exchange with speed / KO ordering.
+    if (iFaster) {
+        foeActive -= myDmg;
+        if (foeActive > 0)
+            myActive -= foeDmg;
+    }
+    else {
+        myActive -= foeDmg;
+        if (myActive > 0)
+            foeActive -= myDmg;
+    }
+    const myFaint = myActive <= 0, foeFaint = foeActive <= 0;
+    const myHpTot = mt.hp - hpFrac(ma) + Math.max(0, myActive);
+    const foeHpTot = ft.hp - hpFrac(fa) + Math.max(0, foeActive);
+    return score(myHpTot, foeHpTot, mt.alive - (myFaint ? 1 : 0), ft.alive - (foeFaint ? 1 : 0), foeFaint ? 0 : foeStatus, myFaint ? 0 : myStatus, fSpikes, mSpikes, boost);
+}
+/** Estimate the position score after I switch to `c` and the foe hits it. */
+function scoreSwitch(battle, myIdx, c) {
+    const me = battle.sides[myIdx], foe = battle.sides[1 - myIdx];
+    const fa = foe.active[0];
+    const mt = sideTotals(me), ft = sideTotals(foe);
+    const foeDmg = bestDamageFraction(battle, fa, c);
+    const cAfter = hpFrac(c) - foeDmg;
+    const myFaint = cAfter <= 0;
+    const myHpTot = mt.hp - hpFrac(c) + Math.max(0, cAfter);
+    return score(myHpTot, ft.hp, mt.alive - (myFaint ? 1 : 0), ft.alive, statusVal(fa.status), myFaint ? 0 : statusVal(c.status), spikes(foe), spikes(me), 0);
+}
+export function chooseActionEval(battle, sideID, request) {
+    const myIdx = sideID === 'p1' ? 0 : 1;
+    const me = battle.sides[myIdx];
+    const foe = battle.sides[1 - myIdx];
+    const team = me?.pokemon ?? [];
+    // Enumerate switch candidates once.
+    const switches = [];
+    request.side.pokemon.forEach((rp, i) => {
+        if (rp.active || isFainted(rp))
+            return;
+        const c = battleMon(team, rp);
+        if (c && foe?.active[0])
+            switches.push({ choiceIndex: i + 1, value: scoreSwitch(battle, myIdx, c) });
+    });
+    if (request.forceSwitch?.[0]) {
+        const best = switches.sort((a, b) => b.value - a.value)[0];
+        return best ? `switch ${best.choiceIndex}` : 'pass';
+    }
+    const active = request.active?.[0];
+    if (!active || !me?.active[0] || !foe?.active[0])
+        return 'default';
+    let best = null;
+    active.moves.forEach((rm, i) => {
+        if (rm.disabled)
+            return;
+        if (typeof rm.pp === 'number' && rm.pp <= 0)
+            return;
+        const name = me.active[0].set?.moves?.[i] ?? rm.move ?? rm.id;
+        const value = scoreMove(battle, myIdx, resolveMove(battle, name));
+        if (!best || value > best.value)
+            best = { kind: 'move', index: i, value };
+    });
+    const trapped = active.trapped || active.maybeTrapped;
+    if (!trapped) {
+        for (const sw of switches) {
+            if (!best || sw.value > best.value)
+                best = { kind: 'switch', index: sw.choiceIndex, value: sw.value };
+        }
+    }
+    if (!best)
+        return 'default';
+    return best.kind === 'move' ? `move ${best.index + 1}` : `switch ${best.index}`;
+}
+//# sourceMappingURL=eval-pilot.js.map

package/dist/pilot/eval-pilot.js.map

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

package/dist/pilot/pilot.d.ts

@@ -0,0 +1,71 @@
+/**
+ * The Pilot — one competent Gen 3 heuristic policy, identical on both sides
+ * (ADR 0002). Given the omniscient battle state and the current request, it
+ * returns a Showdown choice string.
+ *
+ * Competence is layered as an ordered decision tree; each layer only fires when
+ * the earlier, higher-priority ones decline:
+ *   1. secure a KO we can safely land          (max-damage core)
+ *   2. pivot out of a losing matchup           (matchup switching)
+ *   3. heal when worn down and safe            (recovery / stall)
+ *   4. lay Spikes / spin them away             (hazards)
+ *   5. spread status on a fresh target         (Toxic / paralysis / burn)
+ *   6. set up when the foe can't pressure us   (Dragon Dance, Calm Mind, ...)
+ *   7. otherwise hit as hard as possible       (max-damage fallback)
+ *
+ * Per ADR 0002 / the PRD, the Pilot is never asserted move-by-move: its
+ * competence is judged only through outcome thresholds at the `evaluate` seam.
+ */
+import { BattleStreams } from '@pkmn/sim';
+import type { Battle } from '@pkmn/sim';
+export type SideID = 'p1' | 'p2';
+type PlayerStream = ConstructorParameters<typeof BattleStreams.BattlePlayer>[0];
+interface RequestMove {
+    move: string;
+    id: string;
+    pp?: number;
+    disabled?: boolean | string;
+}
+interface RequestActive {
+    moves: RequestMove[];
+    /** Known trap (e.g. Arena Trap / Magnet Pull): switching is forbidden. */
+    trapped?: boolean;
+    /** Possible trap: switching may be rejected, so we treat it as forbidden. */
+    maybeTrapped?: boolean;
+}
+interface RequestPokemon {
+    ident: string;
+    details: string;
+    condition: string;
+    active?: boolean;
+}
+interface PlayerRequest {
+    active?: RequestActive[];
+    side: {
+        pokemon: RequestPokemon[];
+    };
+    forceSwitch?: boolean[];
+    wait?: boolean;
+    teamPreview?: boolean;
+}
+export declare function chooseAction(battle: Battle, sideID: SideID, request: PlayerRequest): string;
+/**
+ * A player that drives one side of a BattleStream with the heuristic Pilot.
+ * It reads the shared omniscient {@link Battle} through `getBattle` (both sides
+ * see the same information, so the contest stays fair).
+ */
+export declare class PilotPlayer extends BattleStreams.BattlePlayer {
+    private readonly getBattle;
+    private readonly sideID;
+    /** Guards against re-entrant recovery within a single stuck decision. */
+    private recovering;
+    constructor(playerStream: PlayerStream, getBattle: () => Battle | null, sideID: SideID);
+    receiveRequest(request: PlayerRequest): void;
+    /**
+     * Safety net: if the heuristic ever produces an illegal choice (e.g. an
+     * uncertain trap it mis-read), fall back to the safest legal action instead
+     * of aborting the whole evaluation. Any other error still propagates.
+     */
+    receiveError(error: Error): void;
+}
+export {};