@maka/maka-cli 5.3.17 → 5.5.0

package/bundle/typescript/src/commands/game/sideQuest/utilities/combat-exchange.d.ts

@@ -0,0 +1,145 @@
+import { Player } from '../models/player.js';
+import { NPC } from '../models/npc.js';
+import { Scene } from '../models/scene.js';
+import { Logger } from './logger.js';
+/**
+ * What one directed strike looks like mechanically -- defaults come from
+ * the attacker's equipped weapon (see weaponProfile()), but a spell attack
+ * supplies its own: a casting pool instead of Agility+skill, and a soak
+ * pool that ignores armor (magic's whole niche -- see commands/cast.ts).
+ */
+export interface IStrikeProfile {
+    /** e.g. "with Ares Light Fire 75", "with a manabolt" */
+    label: string;
+    pool: number;
+    damageBase: number;
+    soakPool: number;
+    /** The physical weapon behind the strike, when there is one -- lets
+     * resolveStrike() spend a round of its ammunition. */
+    weaponItem?: import('../models/item.js').Item;
+    /** Subdual (see subdue.ts): damage lands on the STUN track instead of
+     * physical -- knockouts, not kills (though stun overflow still bleeds
+     * into the body). */
+    dealStun?: boolean;
+}
+/**
+ * The shared combat-exchange engine, extracted from AttackCommand so spell
+ * combat (cast.ts) rides the exact same rails: progressive block-by-block
+ * narration with beats, opposed strike resolution, death handling through
+ * the flows that already exist (removeActor for NPCs, endGame for the
+ * player), and the NPC follow-up pause that gives the player a window to
+ * act between an NPC's exchanges. See AttackCommand's class doc for the
+ * full rationale on pacing and self-announcement -- all of it lives here
+ * now, unchanged in behavior.
+ */
+export declare class CombatExchange {
+    private scene;
+    private logger;
+    private actor;
+    /** Pause between narration blocks so a fight reads as a fight. */
+    static readonly BEAT_MS = 900;
+    /**
+     * Extra breathing room tacked onto the END of an NPC-initiated exchange,
+     * before the command returns to the NPC's AI reflect loop (which awaits
+     * it, so delaying the return directly throttles its next swing). This is
+     * the player's window to heal or flee. Player-typed actions skip it.
+     */
+    static readonly NPC_FOLLOWUP_PAUSE_MS = 2500;
+    constructor(scene: Scene, logger: Logger, actor: Player | NPC);
+    /**
+     * Call once combat is actually joined (gates passed, target resolved).
+     * While an exchange involving the player is resolving, the player can't
+     * "go" (see go.ts) -- you don't get to walk out from between an
+     * attacker's narration beats mid-exchange. finishExchange() releases the
+     * lock BEFORE the between-exchanges pause, which remains the legitimate
+     * window to flee or heal. Safe to call for NPC-vs-NPC fights too: the
+     * lock only engages when the player is one of the combatants.
+     */
+    private _combatants;
+    beginExchange(target: Player | NPC, opts?: {
+        aggressorDraws?: boolean;
+    }): string[];
+    /** Clears the per-combatant serialization flags. Safe to call twice. */
+    releaseExchange(): void;
+    /**
+     * Parks an NPC-driven action until every listed combatant's in-flight
+     * exchange settles, so the action fires in the lull instead of being
+     * discarded. Without this, an NPC's whole turn evaporated: its AI reacts
+     * to the player's attack within a second or two -- always mid-exchange --
+     * so every counterattack AND every wounded-NPC flee attempt was refused
+     * into its private history. Two real sessions of Krow talking trash while
+     * never once shooting back or making the door he was trying to flee
+     * through, which read to the player as the game stalling out.
+     *
+     * Resolves true when the flags clear (caller must revalidate everything:
+     * the waiter or its target may have died in the very exchange it sat
+     * out); false on timeout, meaning something is stuck and the caller
+     * should fall back to a plain refusal.
+     */
+    static waitForLull(combatants: (Player | NPC)[], timeoutMs?: number): Promise<boolean>;
+    /**
+     * The initiative roll-off that opens an exchange: Reaction + Intuition
+     * (+ live commlink AR bonus, see Player.getInitiativePool). The winner
+     * acts first -- attacking someone faster than you means eating their
+     * strike before yours lands -- with ties going to the aggressor. Winning
+     * by 3+ net hits earns an INITIATIVE PASS: one extra strike at the end
+     * of the exchange (the wired-reflexes speed fantasy, without a full
+     * action-economy system).
+     */
+    rollInitiative(aggressor: Player | NPC, defender: Player | NPC): {
+        first: Player | NPC;
+        second: Player | NPC;
+        extraStriker: Player | NPC | null;
+        lines: string[];
+    };
+    /**
+     * The player should see a fight's blow-by-blow only when they're actually
+     * there for it -- as a combatant or as a bystander in the same room. A
+     * brawl between two NPCs elsewhere in the scene stays off-screen, and
+     * skips the narration beats entirely.
+     */
+    playerWitnesses(): boolean;
+    /**
+     * Pushes one narration block to the player's screen (when they're present
+     * for it) and holds a beat before whatever happens next. Only results of
+     * commands the PLAYER typed flow through ui.ts's response pipeline; an
+     * NPC's command result goes solely into that NPC's own AI history, so
+     * without self-announcing here the player would never see the dice of a
+     * fight an NPC started. The status box refreshes with every block so the
+     * condition monitor visibly ticks as damage lands.
+     */
+    announce(lines: string[]): Promise<void>;
+    /**
+     * The default, weapon-based strike profile. A firearm with a dry
+     * magazine automatically falls back to bare fists -- this covers the
+     * involuntary strikes (retaliation) where refusing to swing at all would
+     * make no sense; a deliberately INITIATED attack with a dry gun is
+     * blocked with a reload prompt before ever reaching here (attack.ts).
+     */
+    weaponProfile(attacker: Player | NPC, defender: Player | NPC): IStrikeProfile;
+    /** One directed strike: attack vs defense, then soak. Mutates the defender. */
+    resolveStrike(attacker: Player | NPC, defender: Player | NPC, profile?: IStrikeProfile): string[];
+    /**
+     * Death/knockout narration is announced BEFORE the removal side effects
+     * run -- removeActor() fires the "drops what they carried" observer line
+     * straight to the screen, so running it first would put the gear hitting
+     * the floor before the kill itself. `fallLine`/`gameOverLine` let a caller replace
+     * the default gunned-down flavor; `fatal: false` marks a knockout (a
+     * full STUN track -- see cast.ts drain) rather than a death: same
+     * out-of-the-run consequences, honestly narrated as unconsciousness.
+     */
+    resolveDeath(fallen: Player | NPC, killer: Player | NPC, opts?: {
+        fallLine?: string;
+        gameOverLine?: string;
+        fatal?: boolean;
+    }): Promise<string[]>;
+    /**
+     * The screen already got everything block-by-block, so the player-typed
+     * path returns '' (ui.ts prints the return value -- a second copy would
+     * double-display). An NPC actor gets the full report back instead: that
+     * return value is what lands in the NPC's AI history, which is how it
+     * knows how its own fight went -- but only after the follow-up pause,
+     * which is the player's window to act before the NPC's next exchange.
+     */
+    finishExchange(report: string[]): Promise<string>;
+}

package/bundle/typescript/src/commands/game/sideQuest/utilities/combat-exchange.js

@@ -0,0 +1,354 @@
+import { rollPool, formatRoll } from './dice.js';
+import { leaveMatrix } from './planes.js';
+/**
+ * The shared combat-exchange engine, extracted from AttackCommand so spell
+ * combat (cast.ts) rides the exact same rails: progressive block-by-block
+ * narration with beats, opposed strike resolution, death handling through
+ * the flows that already exist (removeActor for NPCs, endGame for the
+ * player), and the NPC follow-up pause that gives the player a window to
+ * act between an NPC's exchanges. See AttackCommand's class doc for the
+ * full rationale on pacing and self-announcement -- all of it lives here
+ * now, unchanged in behavior.
+ */
+export class CombatExchange {
+    scene;
+    logger;
+    actor;
+    /** Pause between narration blocks so a fight reads as a fight. */
+    static BEAT_MS = 900;
+    /**
+     * Extra breathing room tacked onto the END of an NPC-initiated exchange,
+     * before the command returns to the NPC's AI reflect loop (which awaits
+     * it, so delaying the return directly throttles its next swing). This is
+     * the player's window to heal or flee. Player-typed actions skip it.
+     */
+    static NPC_FOLLOWUP_PAUSE_MS = 2500;
+    constructor(scene, logger, actor) {
+        this.scene = scene;
+        this.logger = logger;
+        this.actor = actor;
+    }
+    /**
+     * Call once combat is actually joined (gates passed, target resolved).
+     * While an exchange involving the player is resolving, the player can't
+     * "go" (see go.ts) -- you don't get to walk out from between an
+     * attacker's narration beats mid-exchange. finishExchange() releases the
+     * lock BEFORE the between-exchanges pause, which remains the legitimate
+     * window to flee or heal. Safe to call for NPC-vs-NPC fights too: the
+     * lock only engages when the player is one of the combatants.
+     */
+    _combatants = [];
+    beginExchange(target, opts = {}) {
+        const player = this.scene.getPlayer();
+        if (this.actor === player || target === player) {
+            this.scene.beginPlayerExchange();
+        }
+        // Fight or flight: holstered steel comes OUT when an exchange opens
+        // (see Player.weaponDrawn) -- the defender's counter is always their
+        // lethal weapon, and the aggressor's default profile is theirs, so
+        // neither side should ever punch because they forgot to "brandish".
+        // The aggressor skips the draw when their attack isn't weapon-driven
+        // (a subdual hold, a spell) -- their hands are already busy.
+        const drawLines = [];
+        const shouldDraw = (c) => c.plane === 'meat' && (c !== this.actor || opts.aggressorDraws !== false);
+        for (const combatant of [this.actor, target]) {
+            if (!shouldDraw(combatant))
+                continue;
+            const drawn = combatant.drawWeapon();
+            if (drawn) {
+                this.logger.write(`${combatant.name} draws ${drawn.name} as the exchange opens.`);
+                drawLines.push(`${combatant.name} draws ${drawn.name}.`);
+            }
+        }
+        // Serialize combat per combatant (see Player.inExchange) -- callers
+        // gate on these flags BEFORE calling beginExchange.
+        this._combatants = [this.actor, target];
+        this.actor.inExchange = true;
+        target.inExchange = true;
+        // Initiating violence revokes your own surrender -- hands up means
+        // hands up (see commands/surrender.ts). The TARGET's surrender flag
+        // stays: being attacked while surrendered doesn't un-surrender you.
+        this.actor.surrendered = false;
+        // Both sides remember the fight -- this is what a parting shot keys
+        // off when either of them tries to walk away (see go.ts).
+        const now = Date.now();
+        this.actor.combatOpponent = target;
+        this.actor.lastExchangeAt = now;
+        target.combatOpponent = this.actor;
+        target.lastExchangeAt = now;
+        return drawLines;
+    }
+    /** Clears the per-combatant serialization flags. Safe to call twice. */
+    releaseExchange() {
+        for (const combatant of this._combatants) {
+            combatant.inExchange = false;
+        }
+    }
+    /**
+     * Parks an NPC-driven action until every listed combatant's in-flight
+     * exchange settles, so the action fires in the lull instead of being
+     * discarded. Without this, an NPC's whole turn evaporated: its AI reacts
+     * to the player's attack within a second or two -- always mid-exchange --
+     * so every counterattack AND every wounded-NPC flee attempt was refused
+     * into its private history. Two real sessions of Krow talking trash while
+     * never once shooting back or making the door he was trying to flee
+     * through, which read to the player as the game stalling out.
+     *
+     * Resolves true when the flags clear (caller must revalidate everything:
+     * the waiter or its target may have died in the very exchange it sat
+     * out); false on timeout, meaning something is stuck and the caller
+     * should fall back to a plain refusal.
+     */
+    static async waitForLull(combatants, timeoutMs = 15000) {
+        const busy = () => combatants.some(c => c.inExchange);
+        const deadline = Date.now() + timeoutMs;
+        while (busy()) {
+            if (Date.now() >= deadline)
+                return false;
+            await new Promise(resolve => setTimeout(resolve, 250));
+        }
+        return true;
+    }
+    /**
+     * The initiative roll-off that opens an exchange: Reaction + Intuition
+     * (+ live commlink AR bonus, see Player.getInitiativePool). The winner
+     * acts first -- attacking someone faster than you means eating their
+     * strike before yours lands -- with ties going to the aggressor. Winning
+     * by 3+ net hits earns an INITIATIVE PASS: one extra strike at the end
+     * of the exchange (the wired-reflexes speed fantasy, without a full
+     * action-economy system).
+     */
+    rollInitiative(aggressor, defender) {
+        const aggRoll = rollPool(aggressor.getInitiativePool());
+        const defRoll = rollPool(defender.getInitiativePool());
+        const aggressorFirst = aggRoll.hits >= defRoll.hits;
+        const first = aggressorFirst ? aggressor : defender;
+        const second = aggressorFirst ? defender : aggressor;
+        const net = Math.abs(aggRoll.hits - defRoll.hits);
+        const extraStriker = net >= 3 ? first : null;
+        this.logger.write(`Initiative: ${aggressor.name} ${aggRoll.hits} vs ${defender.name} ${defRoll.hits} -- ${first.name} first${extraStriker ? ' with an extra strike' : ''}.`);
+        const lines = [
+            `Initiative: ${aggressor.name} ${formatRoll(aggRoll)}  vs  ${defender.name} ${formatRoll(defRoll)}`,
+            `  ${first.name} moves first.${extraStriker ? ` And they're FAST -- an extra strike this exchange.` : ''}`,
+        ];
+        return { first, second, extraStriker, lines };
+    }
+    /**
+     * The player should see a fight's blow-by-blow only when they're actually
+     * there for it -- as a combatant or as a bystander in the same room. A
+     * brawl between two NPCs elsewhere in the scene stays off-screen, and
+     * skips the narration beats entirely.
+     */
+    playerWitnesses() {
+        // Same room AND perceivable plane (see Player.canPerceive): a Matrix
+        // brawl is invisible static to a meat bystander in the same room; an
+        // astral observer sees a meat fight below, dimly.
+        const player = this.scene.getPlayer();
+        return player.currentLocation === this.actor.currentLocation && player.canPerceive(this.actor);
+    }
+    /**
+     * Pushes one narration block to the player's screen (when they're present
+     * for it) and holds a beat before whatever happens next. Only results of
+     * commands the PLAYER typed flow through ui.ts's response pipeline; an
+     * NPC's command result goes solely into that NPC's own AI history, so
+     * without self-announcing here the player would never see the dice of a
+     * fight an NPC started. The status box refreshes with every block so the
+     * condition monitor visibly ticks as damage lands.
+     */
+    async announce(lines) {
+        if (lines.length === 0 || !this.playerWitnesses())
+            return;
+        this.logger.log(lines.join('\n'));
+        this.scene.updateStatus();
+        await new Promise(resolve => setTimeout(resolve, CombatExchange.BEAT_MS));
+    }
+    /**
+     * The default, weapon-based strike profile. A firearm with a dry
+     * magazine automatically falls back to bare fists -- this covers the
+     * involuntary strikes (retaliation) where refusing to swing at all would
+     * make no sense; a deliberately INITIATED attack with a dry gun is
+     * blocked with a reload prompt before ever reaching here (attack.ts).
+     */
+    weaponProfile(attacker, defender) {
+        const weapon = attacker.getWeaponProfile();
+        // The physical weapon only backs a MEAT-plane strike by someone who
+        // has it DRAWN (see Player.weaponDrawn) -- a holstered gun never
+        // speaks (or spends ammo), and off-plane strikes are attack programs /
+        // astral will, so a dry or jammed meat-side gun must not degrade them
+        // to "bare fists" nor burn rounds. In practice beginExchange has
+        // already drawn for every meat combatant.
+        const weaponItem = (attacker.plane === 'meat' && attacker.weaponDrawn)
+            ? attacker.equipment.rightHand?.weapon ?? attacker.equipment.leftHand?.weapon ?? undefined
+            : undefined;
+        // An armed edge boost (see edge.ts) lands on whichever strike this
+        // builds -- the attacker's next swing.
+        const edgeBoost = attacker.consumeEdgeBoost();
+        if (weaponItem?.isFirearm() && (weaponItem.ammo <= 0 || weaponItem.jammed)) {
+            return {
+                label: `with bare fists -- ${weaponItem.name} is ${weaponItem.jammed ? 'locked (smartlink hacked)' : 'dry'}`,
+                pool: Math.max(0, attacker.getAttackPool() - weapon.poolBonus + edgeBoost),
+                damageBase: 2,
+                soakPool: defender.getSoakPool(),
+            };
+        }
+        return {
+            label: `with ${weapon.name}`,
+            pool: attacker.getAttackPool() + edgeBoost,
+            damageBase: weapon.damage,
+            soakPool: defender.getSoakPool(),
+            weaponItem: weaponItem ?? undefined,
+        };
+    }
+    /** One directed strike: attack vs defense, then soak. Mutates the defender. */
+    resolveStrike(attacker, defender, profile) {
+        const strike = profile ?? this.weaponProfile(attacker, defender);
+        const lines = [];
+        // Firing costs a round; the last one gets a warning line.
+        if (strike.weaponItem?.isFirearm()) {
+            strike.weaponItem.fireRound();
+            this.logger.write(`${attacker.name} fired ${strike.weaponItem.name} (${strike.weaponItem.ammo} rounds left).`);
+        }
+        const attack = rollPool(strike.pool);
+        const defense = rollPool(defender.getDefensePool());
+        lines.push(`${attacker.name} attacks ${defender.name} ${strike.label}:`);
+        lines.push(`  Attack:  ${formatRoll(attack)}`);
+        lines.push(`  Defense: ${formatRoll(defense)}`);
+        const dryWarning = strike.weaponItem?.isFirearm() && strike.weaponItem.ammo === 0
+            ? [`  ${attacker.name}'s ${strike.weaponItem.name} clicks empty -- that was the last round.`]
+            : [];
+        const netHits = attack.hits - defense.hits;
+        if (attack.criticalGlitch) {
+            lines.push(`  ${attacker.name}'s attack goes catastrophically wrong -- a clean miss, and everyone nearby heard it.`);
+            return [...lines, ...dryWarning];
+        }
+        if (netHits <= 0) {
+            lines.push(`  ${defender.name} evades the attack.`);
+            return [...lines, ...dryWarning];
+        }
+        const incoming = strike.damageBase + netHits;
+        const soak = rollPool(strike.soakPool);
+        const dealt = Math.max(0, incoming - soak.hits);
+        lines.push(`  Hit! ${netHits} net -- ${incoming} damage incoming.`);
+        lines.push(`  Soak:    ${formatRoll(soak)}`);
+        if (dealt === 0) {
+            lines.push(`  ${defender.name} shrugs it off -- no damage gets through.`);
+            return [...lines, ...dryWarning];
+        }
+        // A jacked-in visitor takes MATRIX damage (only visitors have a
+        // simMode -- native ice's normal track IS its integrity, so it takes
+        // damage the ordinary way below). Matrix damage is HARDWARE damage:
+        //   deck rider -- every box lands on the deck's device monitor; a
+        //                 full track BRICKS it: forced dump, dumpshock, fight
+        //                 over. Hot-sim ADDITIONALLY bleeds half the hit
+        //                 (rounded up) into the rider's real stun track.
+        //   technomancer (no deck) -- a living persona has no hardware to
+        //                 sacrifice: EVERY box is real stun, both sim modes.
+        if (defender.plane === 'matrix' && defender.simMode) {
+            const deck = defender.activeDeck;
+            if (deck) {
+                deck.takeDeckDamage(dealt);
+                this.logger.write(`${attacker.name} dealt ${dealt} MATRIX damage to ${defender.name}'s ${deck.name} (${deck.deckDamage}/${deck.maxDeckBoxes}).`);
+                lines.push(`  ${defender.name}'s ${deck.name} takes ${dealt} box${dealt === 1 ? '' : 'es'}: ${deck.deckSummary()}`);
+                if (defender.simMode === 'hot') {
+                    const bio = Math.ceil(dealt / 2);
+                    const { stun, overflow } = defender.takeStun(bio);
+                    lines.push(`  Biofeedback claws through the hot-sim link -- ${stun} stun: ${defender.stunSummary()}`);
+                    if (overflow > 0) {
+                        lines.push(`  It's more than a mind can hold -- ${overflow} box${overflow === 1 ? '' : 'es'} spill physical: ${defender.conditionSummary()}`);
+                    }
+                }
+                if (deck.isBricked) {
+                    lines.push(`  ${deck.name} BRICKS -- the persona collapses into static --`);
+                    lines.push(...leaveMatrix(this.scene, defender, { forced: true, reason: `The ice burns your deck out from under you.` }));
+                }
+                return [...lines, ...dryWarning];
+            }
+            // Deckless: the living persona. Fall through to the stun branch.
+        }
+        const asStun = strike.dealStun || (defender.plane === 'matrix' && !!defender.simMode);
+        if (asStun) {
+            const { stun, overflow } = defender.takeStun(dealt);
+            this.logger.write(`${attacker.name} dealt ${dealt} STUN to ${defender.name} (stun ${defender.stunTaken}/${defender.maxStunBoxes}, overflow ${overflow}).`);
+            const bioNote = !strike.dealStun ? ' (biofeedback)' : '';
+            lines.push(`  ${defender.name} takes ${stun} stun${bioNote}: ${defender.stunSummary()}`);
+            if (overflow > 0) {
+                lines.push(`  The beating goes past unconsciousness -- ${overflow} box${overflow === 1 ? '' : 'es'} spill into their body: ${defender.conditionSummary()}`);
+            }
+        }
+        else {
+            defender.takeDamage(dealt);
+            this.logger.write(`${attacker.name} dealt ${dealt} boxes to ${defender.name} (${defender.damageTaken}/${defender.maxConditionBoxes}).`);
+            lines.push(`  ${defender.name} takes ${dealt} box${dealt === 1 ? '' : 'es'}: ${defender.conditionSummary()}`);
+        }
+        return [...lines, ...dryWarning];
+    }
+    /**
+     * Death/knockout narration is announced BEFORE the removal side effects
+     * run -- removeActor() fires the "drops what they carried" observer line
+     * straight to the screen, so running it first would put the gear hitting
+     * the floor before the kill itself. `fallLine`/`gameOverLine` let a caller replace
+     * the default gunned-down flavor; `fatal: false` marks a knockout (a
+     * full STUN track -- see cast.ts drain) rather than a death: same
+     * out-of-the-run consequences, honestly narrated as unconsciousness.
+     */
+    async resolveDeath(fallen, killer, opts) {
+        const room = fallen.currentLocation;
+        const isPlayer = fallen === this.scene.getPlayer();
+        // Idempotence: if this NPC was already removed (a concurrent exchange
+        // beat us to the kill), don't narrate a second death or re-drop gear.
+        if (!isPlayer && this.scene.getActor(fallen.name) !== fallen) {
+            this.logger.write(`CombatExchange: ${fallen.name} already resolved as down -- skipping duplicate death.`);
+            return [];
+        }
+        const verb = (opts?.fatal ?? true) ? 'killed' : 'knocked out';
+        this.logger.write(`CombatExchange: ${killer.name} ${verb} ${fallen.name} in ${room.name}.`);
+        this.scene.addWorldEvent(`${killer.name} ${verb} ${fallen.name} in ${room.name}.`);
+        if (isPlayer) {
+            const lines = [opts?.fallLine ?? `You collapse. The last thing you see is ${killer.name} standing over you.`];
+            await this.announce(lines);
+            // Same flow as kill.ts and a fatal bypass: freeze input, self-announce
+            // so the reason stays on screen, and wait for ctrl-c ("You died!").
+            const gameOverLine = opts?.gameOverLine ?? `💀 GAME OVER: ${fallen.name} was gunned down by ${killer.name}.`;
+            void this.scene.endGame().then(() => {
+                this.logger.logWithColor(gameOverLine, 'red');
+                this.logger.logWithColor(`Press ctrl-c to quit.`, 'red');
+            });
+            return ['', ...lines];
+        }
+        const npcFall = (opts?.fatal ?? true)
+            ? `${fallen.name} goes down -- dead before they hit the floor. Their gear scatters across ${room.name}.`
+            : `${fallen.name} collapses, out cold -- down for the count. Their gear scatters across ${room.name}.`;
+        const lines = [opts?.fallLine ?? npcFall];
+        await this.announce(lines);
+        // scene.removeActor drops everything they carried AND wore where they
+        // fell -- its observer lines now correctly land after the kill above.
+        this.scene.removeActor(fallen.name);
+        return ['', ...lines];
+    }
+    /**
+     * The screen already got everything block-by-block, so the player-typed
+     * path returns '' (ui.ts prints the return value -- a second copy would
+     * double-display). An NPC actor gets the full report back instead: that
+     * return value is what lands in the NPC's AI history, which is how it
+     * knows how its own fight went -- but only after the follow-up pause,
+     * which is the player's window to act before the NPC's next exchange.
+     */
+    async finishExchange(report) {
+        // The exchange is resolved -- movement unlocks BEFORE the follow-up
+        // pause below, so the pause stays the window to flee or heal.
+        this.scene.endPlayerExchange();
+        this.releaseExchange();
+        this.scene.updateStatus();
+        // The fight autopilot's trigger: a settled exchange involving the
+        // player schedules their next auto action (see utilities/auto-fight.ts).
+        this.scene.notifyExchangeSettled(this._combatants);
+        if (this.actor === this.scene.getPlayer()) {
+            return '';
+        }
+        if (this.playerWitnesses()) {
+            await new Promise(resolve => setTimeout(resolve, CombatExchange.NPC_FOLLOWUP_PAUSE_MS));
+        }
+        return report.join('\n');
+    }
+}
+//# sourceMappingURL=combat-exchange.js.map

package/bundle/typescript/src/commands/game/sideQuest/utilities/combat-exchange.js.map

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

package/bundle/typescript/src/commands/game/sideQuest/utilities/comm-style.d.ts

@@ -0,0 +1,2 @@
+export declare const CALL_ICON = "\uD83D\uDCDE";
+export declare const CALL_COLOR = "cyan";

package/bundle/typescript/src/commands/game/sideQuest/utilities/comm-style.js

@@ -0,0 +1,12 @@
+// Visual styling for commlink/AR-context messages. A call stays in the main
+// log window (it's not a separate view -- it's augmented reality laid over
+// wherever the player already is), but is tagged with a distinct icon and
+// color so it visibly reads as a different "space" than in-person dialogue.
+//
+// Future contexts (the Astral Plane, VR hot-sim/cold-sim) are expected to
+// follow the same shape: their own icon/color pair, applied the same way --
+// not a bigger context system, just more constants like this one, until
+// there's an actual second context to justify one.
+export const CALL_ICON = '📞';
+export const CALL_COLOR = 'cyan';
+//# sourceMappingURL=comm-style.js.map

package/bundle/typescript/src/commands/game/sideQuest/utilities/comm-style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comm-style.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/utilities/comm-style.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,2EAA2E;AAC3E,0EAA0E;AAC1E,4EAA4E;AAC5E,EAAE;AACF,0EAA0E;AAC1E,4EAA4E;AAC5E,wEAAwE;AACxE,mDAAmD;AACnD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC;AAC9B,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC"}

package/bundle/typescript/src/commands/game/sideQuest/utilities/dice.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shadowrun-style d6 dice pools: roll N six-siders, every 5 or 6 is a hit.
+ * A "glitch" is rolling 1s on more than half the pool (something went ugly
+ * even if you succeeded); a "critical glitch" is glitching with zero hits
+ * (it went ugly AND you failed). Pure functions, no game-state knowledge --
+ * combat resolution lives in commands/attack.ts.
+ */
+export interface IDiceRoll {
+    pool: number;
+    rolls: number[];
+    hits: number;
+    glitch: boolean;
+    criticalGlitch: boolean;
+}
+export declare function rollPool(pool: number): IDiceRoll;
+/**
+ * One-line render of a roll for the game log, e.g.:
+ *   "8d6 [6 5 5 3 2 1 4 6] -> 4 hits"
+ * The raw dice faces are shown on purpose -- watching the pool land is
+ * most of the fun of dice-pool combat.
+ */
+export declare function formatRoll(roll: IDiceRoll): string;

package/bundle/typescript/src/commands/game/sideQuest/utilities/dice.js

@@ -0,0 +1,34 @@
+/**
+ * Shadowrun-style d6 dice pools: roll N six-siders, every 5 or 6 is a hit.
+ * A "glitch" is rolling 1s on more than half the pool (something went ugly
+ * even if you succeeded); a "critical glitch" is glitching with zero hits
+ * (it went ugly AND you failed). Pure functions, no game-state knowledge --
+ * combat resolution lives in commands/attack.ts.
+ */
+export function rollPool(pool) {
+    const size = Math.max(0, Math.floor(pool));
+    const rolls = Array.from({ length: size }, () => 1 + Math.floor(Math.random() * 6));
+    const hits = rolls.filter(r => r >= 5).length;
+    const ones = rolls.filter(r => r === 1).length;
+    const glitch = size > 0 && ones > size / 2;
+    return {
+        pool: size,
+        rolls,
+        hits,
+        glitch,
+        criticalGlitch: glitch && hits === 0,
+    };
+}
+/**
+ * One-line render of a roll for the game log, e.g.:
+ *   "8d6 [6 5 5 3 2 1 4 6] -> 4 hits"
+ * The raw dice faces are shown on purpose -- watching the pool land is
+ * most of the fun of dice-pool combat.
+ */
+export function formatRoll(roll) {
+    if (roll.pool === 0)
+        return '0d6 -> no dice to roll';
+    const glitchTag = roll.criticalGlitch ? ' -- CRITICAL GLITCH' : roll.glitch ? ' -- glitch' : '';
+    return `${roll.pool}d6 [${roll.rolls.join(' ')}] -> ${roll.hits} hit${roll.hits === 1 ? '' : 's'}${glitchTag}`;
+}
+//# sourceMappingURL=dice.js.map

package/bundle/typescript/src/commands/game/sideQuest/utilities/dice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dice.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/utilities/dice.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACpF,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC;IAE3C,OAAO;QACL,IAAI,EAAE,IAAI;QACV,KAAK;QACL,IAAI;QACJ,MAAM;QACN,cAAc,EAAE,MAAM,IAAI,IAAI,KAAK,CAAC;KACrC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,IAAe;IACxC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,wBAAwB,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAChG,OAAO,GAAG,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,SAAS,EAAE,CAAC;AACjH,CAAC"}

package/bundle/typescript/src/commands/game/sideQuest/utilities/fuzzy-match.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Shared fuzzy name-matching, extracted from Inventory's item resolution so
+ * actor targeting (attack.ts, cast.ts) behaves the same way "take" does --
+ * found via a real session where "cast manabolt at mr krow" failed against
+ * "Mr. Krow" over a missing period. Three tiers, in order of confidence:
+ *
+ *   1. Exact match on the loosely-normalized strings (case, punctuation,
+ *      and extra whitespace ignored -- "mr krow" == "Mr. Krow").
+ *   2. Substring containment, either direction -- short aliases ("krow"),
+ *      or extra/missing words at the edges.
+ *   3. Word-overlap with light per-word typo tolerance (Levenshtein <= 1
+ *      on words longer than 3 chars, stopwords ignored) -- misspellings
+ *      and reordered/inserted words.
+ *
+ * A tier only matches when it produces exactly ONE candidate (or a clear
+ * best score) -- an ambiguous guess deliberately misses rather than
+ * picking someone at random.
+ */
+export declare const STOPWORDS: Set<string>;
+/** Lowercase, strip punctuation, collapse whitespace. */
+export declare function normalizeLoose(s: string): string;
+export declare function significantWords(s: string): string[];
+export declare function wordsAreCloseEnough(a: string, b: string): boolean;
+/**
+ * Damerau-Levenshtein (OSA variant): like plain Levenshtein but a swap of
+ * two adjacent letters counts as ONE edit, not two -- transpositions
+ * ("jhonson" for "johnson", "teh" for "the") are the single most common
+ * typo class, and plain Levenshtein prices them out of the <=1 tolerance.
+ */
+export declare function levenshteinDistance(a: string, b: string): number;
+/**
+ * Picks the single name from `names` that `input` most plausibly refers
+ * to, or undefined when nothing (or more than one thing) qualifies.
+ * Returns the ORIGINAL name string, not the normalized form.
+ */
+export declare function fuzzyPickName(input: string, names: string[]): string | undefined;