@maka/maka-cli 5.3.16 → 5.4.0

package/bundle/typescript/src/commands/game/sideQuest/commands/attack.js

@@ -0,0 +1,224 @@
+import { Command } from './command.js';
+import { CombatExchange } from '../utilities/combat-exchange.js';
+import { fuzzyPickName } from '../utilities/fuzzy-match.js';
+import { describeFledTarget } from '../utilities/pursuit.js';
+import { shellsInRoom, resolveBodyAttack } from '../utilities/planes.js';
+/**
+ * Shadowrun-style dice-pool combat, one full exchange per command:
+ *
+ *   1. Attacker rolls Agility + combat skill + weapon bonus, opposed by the
+ *      defender's Reaction. Net hits land the blow.
+ *   2. Damage = weapon DV + net hits, soaked by Body + armor (each soak hit
+ *      cancels one box).
+ *   3. Whatever gets through fills the defender's condition monitor; a full
+ *      track is death.
+ *   4. If the defender survives, they immediately strike back with the same
+ *      math reversed -- starting a fight means eating one, so a fight is a
+ *      real decision, not a free action.
+ *
+ * Wound modifiers (-1 die per 3 boxes taken) apply to every pool on both
+ * sides, so a fight tilts as it goes. Pools/derivations live on Player
+ * (getAttackPool() etc.); narration pacing, strike resolution, and death
+ * handling live in CombatExchange (shared with spell combat -- see
+ * cast.ts). This command only orchestrates the weapon exchange.
+ */
+export class AttackCommand extends Command {
+    static verb = 'attack';
+    static description = 'Attack someone in the room -- dice-pool combat with your equipped weapon. They WILL hit back.';
+    async execute(args = []) {
+        if (!args || args.length === 0) {
+            return 'Who do you want to attack? Try: `attack <name>`';
+        }
+        // The dead (and the unconscious) don't fight. Covers a downed player
+        // (who stays in the scene -- endGame only freezes input) and a downed
+        // NPC whose in-flight AI loop is still issuing commands after removal
+        // from the scene.
+        if (this.actor.isIncapacitated()) {
+            return `You're down. The fight is over.`;
+        }
+        const room = this.actor.currentLocation;
+        if (!room) {
+            return 'You are not in a valid location to fight anyone.';
+        }
+        // Same fuzzy matching "take" uses (see utilities/fuzzy-match.ts) --
+        // punctuation, case, typos, and partial names all resolve, but an
+        // ambiguous guess deliberately misses rather than shooting someone
+        // at random. You can only fight what shares your plane: meat can't
+        // touch a Matrix persona or an astral form, and vice versa.
+        const targetName = args.join(' ');
+        const candidates = this.scene.getActorsInRoom(room).filter(a => a !== this.actor && a.plane === this.actor.plane);
+        const pickedName = fuzzyPickName(targetName, candidates.map(a => a.name));
+        const target = pickedName ? candidates.find(a => a.name === pickedName) : undefined;
+        if (!target) {
+            // An empty body IS attackable from the meat plane -- one unanswered
+            // strike, and its owner gets slammed back into it (see planes.ts).
+            if (this.actor.plane === 'meat') {
+                const shells = shellsInRoom(this.scene, room);
+                const shellPick = fuzzyPickName(targetName, shells.map(s => s.name));
+                const shell = shellPick ? shells.find(s => s.name === shellPick) : undefined;
+                if (shell) {
+                    const lines = resolveBodyAttack(this.scene, this.actor, shell);
+                    const exchange = new CombatExchange(this.scene, this.logger, this.actor);
+                    await exchange.announce(lines);
+                    if (shell.isDown()) {
+                        const death = await exchange.resolveDeath(shell, this.actor, {
+                            fallLine: `${shell.name}'s body never wakes -- whatever came rushing back arrived too late. Their gear scatters across ${room.name}.`,
+                        });
+                        lines.push(...death);
+                    }
+                    return this.actor === this.scene.getPlayer() ? '' : lines.join('\n');
+                }
+            }
+            // If they exist but fled the room, say WHERE and how to chase --
+            // this result is what lands in a pursuing NPC's AI history, and
+            // without the explicit direction a hostile NPC just spams failed
+            // attacks at the empty room instead of following (real session:
+            // dozens of them while the player ping-ponged between two rooms).
+            const fled = describeFledTarget(this.scene, room, targetName);
+            if (fled)
+                return fled;
+            const present = candidates.map(a => a.name).join(', ') || 'no one';
+            return `You don't see anyone named "${targetName}" here to attack. Present: ${present}.`;
+        }
+        // The dead can't be fought either. A downed NPC is removed from the
+        // scene, so a still-present downed target can only be the dead player
+        // -- found via a real session where the killer's AI loop, with nothing
+        // gating this, beat the player's corpse for a full minute, re-running
+        // the whole death sequence every swing. The plain-text result below is
+        // what actually lands in the attacker's AI history and tells it the
+        // fight is over.
+        if (target.isIncapacitated()) {
+            return `${target.name} is already down. The fight is over -- there's nothing left to attack.`;
+        }
+        // One exchange at a time per combatant: overlapping AI loops firing
+        // parallel exchanges once double-killed a target (two death events,
+        // two narrations). The player is refused cleanly (they can just retype
+        // in the lull); an NPC's attack instead WAITS for the lull and re-runs
+        // -- discarding it meant NPCs never got a single action off, because
+        // their AI always reacts while the player's exchange is still beating
+        // out (see CombatExchange.waitForLull).
+        if (this.actor.inExchange || target.inExchange) {
+            if (this.actor === this.scene.getPlayer()) {
+                return this.actor.inExchange
+                    ? `You're already mid-exchange -- let it resolve.`
+                    : `${target.name} is already trading fire -- wait for that exchange to resolve.`;
+            }
+            if (this.actor.waitingForLull) {
+                return `You're already waiting for an opening -- one move at a time.`;
+            }
+            this.actor.waitingForLull = true;
+            try {
+                const settled = await CombatExchange.waitForLull([this.actor, target]);
+                if (!settled) {
+                    return `You're already mid-exchange -- let it resolve.`;
+                }
+                this.logger.write(`${this.actor.name}'s attack waited out an exchange and now retries.`);
+                return await this.execute(args);
+            }
+            finally {
+                this.actor.waitingForLull = false;
+            }
+        }
+        // A deliberately INITIATED attack with a dry gun is blocked with a
+        // reload prompt -- the involuntary strikes (retaliation) auto-fall-back
+        // to fists instead (see CombatExchange.weaponProfile).
+        const weaponItem = this.actor.equipment.rightHand?.weapon ?? this.actor.equipment.leftHand?.weapon;
+        if (this.usesEquippedWeapon() && weaponItem?.isFirearm() && weaponItem.jammed) {
+            return `The ${weaponItem.name}'s smartlink is LOCKED -- someone cracked your PAN. "reboot" to clear it, or go in swinging.`;
+        }
+        if (this.usesEquippedWeapon() && weaponItem?.isFirearm() && weaponItem.ammo <= 0) {
+            return `Click -- the ${weaponItem.name} is dry. "reload" (needs ammunition), or go in swinging with something else.`;
+        }
+        const exchange = new CombatExchange(this.scene, this.logger, this.actor);
+        const report = [];
+        // Movement locks for the duration of the exchange when the player is a
+        // combatant (see go.ts) -- the try/finally is exception safety so a
+        // crash mid-exchange can never leave the player permanently rooted.
+        exchange.beginExchange(target);
+        try {
+            this.actor.performAction(this.actionVerb(), target.name);
+            this.scene.addWorldEvent(`${this.actor.name} ${this.actionVerb()} ${target.name} in ${room.name}.`);
+            // ---- Initiative decides who acts first (see rollInitiative) ----
+            const init = exchange.rollInitiative(this.actor, target);
+            report.push(...init.lines);
+            await exchange.announce(init.lines);
+            // ---- The two strikes, in initiative order. The aggressor's strike
+            // uses this command's profile (weapon, or subdue's stun hold); the
+            // defender's answer is always their own lethal weapon. Being
+            // preempted and dropped means your swing never happens. ----
+            for (const striker of [init.first, init.second]) {
+                if (striker.isIncapacitated())
+                    continue;
+                const defender = striker === this.actor ? target : this.actor;
+                if (defender.isIncapacitated())
+                    break;
+                // A mid-exchange forced dump (cold-sim persona crash) yanks a
+                // combatant off this plane -- the fight is over, not continued
+                // across realities.
+                if (striker.plane !== defender.plane)
+                    break;
+                const profile = striker === this.actor ? this.strikeProfile(exchange, target) : undefined;
+                const prefix = striker === init.second ? [`${striker.name} retaliates!`] : [];
+                const strike = [...prefix, ...exchange.resolveStrike(striker, defender, profile)];
+                report.push('', ...strike);
+                await exchange.announce(strike);
+                const takedown = await this.resolveTakedown(exchange, defender, striker);
+                if (takedown) {
+                    report.push(...takedown);
+                    return await exchange.finishExchange(report);
+                }
+            }
+            // ---- The initiative pass: a decisive winner presses the advantage
+            // with one extra strike. ----
+            if (init.extraStriker && !init.extraStriker.isIncapacitated()) {
+                const defender = init.extraStriker === this.actor ? target : this.actor;
+                if (!defender.isIncapacitated() && init.extraStriker.plane === defender.plane) {
+                    const profile = init.extraStriker === this.actor ? this.strikeProfile(exchange, target) : undefined;
+                    const strike = [`${init.extraStriker.name} presses the advantage!`, ...exchange.resolveStrike(init.extraStriker, defender, profile)];
+                    report.push('', ...strike);
+                    await exchange.announce(strike);
+                    const takedown = await this.resolveTakedown(exchange, defender, init.extraStriker);
+                    if (takedown)
+                        report.push(...takedown);
+                }
+            }
+            return await exchange.finishExchange(report);
+        }
+        finally {
+            this.scene.endPlayerExchange();
+            exchange.releaseExchange();
+        }
+    }
+    /** subdue.ts overrides to false: its strike ignores the equipped gun entirely. */
+    usesEquippedWeapon() {
+        return true;
+    }
+    /** Overridden by subdue.ts to swap in a stun-dealing strike. undefined = weapon default. */
+    strikeProfile(_exchange, _target) {
+        return undefined;
+    }
+    /** The verb observers see ("attacks" / "moves to subdue"). */
+    actionVerb() {
+        return 'attacks';
+    }
+    /**
+     * Post-strike incapacitation, both flavors: a full physical track is a
+     * death; a full stun track (only reachable via a stun-dealing strike,
+     * or its overflow) is a live capture. Returns the narration, or null if
+     * the fallen still stands. Either combatant can be the one who falls --
+     * initiative order means the aggressor eats preemptive strikes too.
+     */
+    async resolveTakedown(exchange, fallen, killer) {
+        if (fallen.isDown()) {
+            return exchange.resolveDeath(fallen, killer);
+        }
+        if (fallen.isUnconscious()) {
+            return exchange.resolveDeath(fallen, killer, {
+                fatal: false,
+                fallLine: `${fallen.name} sags and drops -- out cold, breathing. Their gear scatters across ${fallen.currentLocation.name}.`,
+            });
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=attack.js.map

package/bundle/typescript/src/commands/game/sideQuest/commands/attack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attack.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/commands/attack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,cAAc,EAAkB,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAIzE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,aAAc,SAAQ,OAAO;IAC9B,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC;IACvB,MAAM,CAAC,WAAW,GAAG,+FAA+F,CAAC;IAE/H,KAAK,CAAC,OAAO,CAAC,OAAiB,EAAE;QAC/B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,iDAAiD,CAAC;QAC3D,CAAC;QAED,qEAAqE;QACrE,sEAAsE;QACtE,sEAAsE;QACtE,kBAAkB;QAClB,IAAI,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,CAAC;YACjC,OAAO,iCAAiC,CAAC;QAC3C,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;QACxC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,kDAAkD,CAAC;QAC5D,CAAC;QAED,oEAAoE;QACpE,kEAAkE;QAClE,mEAAmE;QACnE,mEAAmE;QACnE,4DAA4D;QAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClH,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEpF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,oEAAoE;YACpE,mEAAmE;YACnE,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;gBAChC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBAC9C,MAAM,SAAS,GAAG,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;gBACrE,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC7E,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;oBAC/D,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;oBACzE,MAAM,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;oBAC/B,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;wBACnB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;4BAC3D,QAAQ,EAAE,GAAG,KAAK,CAAC,IAAI,kGAAkG,IAAI,CAAC,IAAI,GAAG;yBACtI,CAAC,CAAC;wBACH,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;oBACvB,CAAC;oBACD,OAAO,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACvE,CAAC;YACH,CAAC;YAED,iEAAiE;YACjE,gEAAgE;YAChE,iEAAiE;YACjE,gEAAgE;YAChE,kEAAkE;YAClE,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;YAC9D,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC;YAEtB,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;YACnE,OAAO,+BAA+B,UAAU,8BAA8B,OAAO,GAAG,CAAC;QAC3F,CAAC;QAED,oEAAoE;QACpE,sEAAsE;QACtE,uEAAuE;QACvE,sEAAsE;QACtE,uEAAuE;QACvE,oEAAoE;QACpE,iBAAiB;QACjB,IAAI,MAAM,CAAC,eAAe,EAAE,EAAE,CAAC;YAC7B,OAAO,GAAG,MAAM,CAAC,IAAI,wEAAwE,CAAC;QAChG,CAAC;QAED,oEAAoE;QACpE,oEAAoE;QACpE,uEAAuE;QACvE,uEAAuE;QACvE,qEAAqE;QACrE,sEAAsE;QACtE,wCAAwC;QACxC,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAC/C,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC;gBAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU;oBAC1B,CAAC,CAAC,gDAAgD;oBAClD,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,gEAAgE,CAAC;YACrF,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;gBAC9B,OAAO,8DAA8D,CAAC;YACxE,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;gBACvE,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,gDAAgD,CAAC;gBAC1D,CAAC;gBACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,mDAAmD,CAAC,CAAC;gBACzF,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAClC,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC;YACpC,CAAC;QACH,CAAC;QAED,mEAAmE;QACnE,wEAAwE;QACxE,uDAAuD;QACvD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;QACnG,IAAI,IAAI,CAAC,kBAAkB,EAAE,IAAI,UAAU,EAAE,SAAS,EAAE,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YAC9E,OAAO,OAAO,UAAU,CAAC,IAAI,8FAA8F,CAAC;QAC9H,CAAC;QACD,IAAI,IAAI,CAAC,kBAAkB,EAAE,IAAI,UAAU,EAAE,SAAS,EAAE,IAAI,UAAU,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;YACjF,OAAO,gBAAgB,UAAU,CAAC,IAAI,8EAA8E,CAAC;QACvH,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACzE,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,uEAAuE;QACvE,oEAAoE;QACpE,oEAAoE;QACpE,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YACzD,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI,MAAM,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YAEpG,mEAAmE;YACnE,MAAM,IAAI,GAAG,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACzD,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAEpC,oEAAoE;YACpE,mEAAmE;YACnE,6DAA6D;YAC7D,6DAA6D;YAC7D,KAAK,MAAM,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChD,IAAI,OAAO,CAAC,eAAe,EAAE;oBAAE,SAAS;gBACxC,MAAM,QAAQ,GAAG,OAAO,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;gBAC9D,IAAI,QAAQ,CAAC,eAAe,EAAE;oBAAE,MAAM;gBACtC,8DAA8D;gBAC9D,+DAA+D;gBAC/D,oBAAoB;gBACpB,IAAI,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK;oBAAE,MAAM;gBAE5C,MAAM,OAAO,GAAG,OAAO,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC1F,MAAM,MAAM,GAAG,OAAO,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9E,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;gBAClF,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,CAAC;gBAC3B,MAAM,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAEhC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACzE,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;oBACzB,OAAO,MAAM,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;gBAC/C,CAAC;YACH,CAAC;YAED,oEAAoE;YACpE,8BAA8B;YAC9B,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,EAAE,CAAC;gBAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;gBACxE,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK,EAAE,CAAC;oBAC9E,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;oBACpG,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,yBAAyB,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;oBACrI,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,CAAC;oBAC3B,MAAM,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;oBAEhC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;oBACnF,IAAI,QAAQ;wBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;YAED,OAAO,MAAM,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC/C,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC/B,QAAQ,CAAC,eAAe,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,kFAAkF;IACxE,kBAAkB;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4FAA4F;IAClF,aAAa,CAAC,SAAyB,EAAE,OAAqB;QACtE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,8DAA8D;IACpD,UAAU;QAClB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACO,KAAK,CAAC,eAAe,CAAC,QAAwB,EAAE,MAAoB,EAAE,MAAoB;QAClG,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACpB,OAAO,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,MAAM,CAAC,aAAa,EAAE,EAAE,CAAC;YAC3B,OAAO,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE;gBAC3C,KAAK,EAAE,KAAK;gBACZ,QAAQ,EAAE,GAAG,MAAM,CAAC,IAAI,sEAAsE,MAAM,CAAC,eAAe,CAAC,IAAI,GAAG;aAC7H,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC"}

package/bundle/typescript/src/commands/game/sideQuest/commands/bypass-command.d.ts

@@ -0,0 +1,28 @@
+import { Command, ICommand } from './command.js';
+import { PuzzleBypassType } from '../types/seed/puzzle-seed.js';
+/**
+ * Shared implementation for pick/hack/cast. The gate check (already
+ * solved? prerequisite met? does this puzzle even have this bypassType?)
+ * always runs first and synchronously, so a doomed attempt never makes the
+ * player sit through an interactive challenge they were never going to be
+ * allowed to attempt. Each concrete command differs in its verb,
+ * description, bypass type, the "nothing to do that to" message, and
+ * optionally how the outcome itself gets determined (see
+ * determineOutcome() -- defaults to a coin flip; lockpicking overrides it
+ * with a real minigame).
+ */
+export declare abstract class BypassCommand extends Command implements ICommand {
+    protected abstract bypassType: PuzzleBypassType;
+    protected abstract noPuzzleMessage: string;
+    /** Default: a flat coin flip. Override for a type with its own minigame. */
+    protected determineOutcome(): Promise<boolean>;
+    /**
+     * There's no typed answer here to disambiguate with (unlike solve.ts),
+     * so with more than one barrier in the room the player has to name which
+     * one: a direction ("pick north", for a locked door) or a word from the
+     * barrier's own name ("pick maglock"). With only one candidate, a bare
+     * "pick" still works exactly as before.
+     */
+    private resolveTarget;
+    execute(args: string[]): Promise<string>;
+}

package/bundle/typescript/src/commands/game/sideQuest/commands/bypass-command.js

@@ -0,0 +1,101 @@
+import { Command } from './command.js';
+/**
+ * Shared implementation for pick/hack/cast. The gate check (already
+ * solved? prerequisite met? does this puzzle even have this bypassType?)
+ * always runs first and synchronously, so a doomed attempt never makes the
+ * player sit through an interactive challenge they were never going to be
+ * allowed to attempt. Each concrete command differs in its verb,
+ * description, bypass type, the "nothing to do that to" message, and
+ * optionally how the outcome itself gets determined (see
+ * determineOutcome() -- defaults to a coin flip; lockpicking overrides it
+ * with a real minigame).
+ */
+export class BypassCommand extends Command {
+    /** Default: a flat coin flip. Override for a type with its own minigame. */
+    async determineOutcome() {
+        return Math.random() < 0.5;
+    }
+    /**
+     * There's no typed answer here to disambiguate with (unlike solve.ts),
+     * so with more than one barrier in the room the player has to name which
+     * one: a direction ("pick north", for a locked door) or a word from the
+     * barrier's own name ("pick maglock"). With only one candidate, a bare
+     * "pick" still works exactly as before.
+     */
+    resolveTarget(args, targets) {
+        const raw = args.join(' ').trim().toLowerCase();
+        if (!raw) {
+            if (targets.length === 1)
+                return { target: targets[0] };
+            const options = targets.map(t => t.direction ?? t.label).join(', ');
+            return { error: `There's more than one thing to ${this.bypassType === 'lockpick' ? 'pick' : this.bypassType === 'hack' ? 'hack' : 'cast'} at here -- say which: ${options}.` };
+        }
+        if (this.isValidDirection(raw)) {
+            const match = targets.find(t => t.direction === raw);
+            return match ? { target: match } : { error: `There's nothing to bypass in that direction.` };
+        }
+        const matches = targets.filter(t => t.label.toLowerCase().includes(raw));
+        if (matches.length === 1)
+            return { target: matches[0] };
+        if (matches.length > 1)
+            return { error: `That could mean more than one thing here -- be more specific.` };
+        return { error: `There's nothing here called "${raw}".` };
+    }
+    async execute(args) {
+        const room = this.actor.currentLocation;
+        const targets = (room?.getPuzzleTargets() ?? []).filter(t => t.puzzle.bypassType === this.bypassType);
+        if (targets.length === 0) {
+            return this.noPuzzleMessage;
+        }
+        const { target, error } = this.resolveTarget(args, targets);
+        if (!target) {
+            return error ?? this.noPuzzleMessage;
+        }
+        const gate = target.puzzle.checkBypassGate(this.bypassType);
+        if (!gate.allowed) {
+            return gate.message ?? `You can't do that here.`;
+        }
+        const succeeded = await this.determineOutcome();
+        const result = target.puzzle.resolveBypass(this.bypassType, succeeded);
+        if (result.success) {
+            if (target.door) {
+                target.door.isLocked = false;
+                this.scene.updateExits(room);
+                this.scene.addWorldEvent(`${this.actor.name} bypassed (${this.bypassType}) the way ${target.direction} in ${room.name}.`);
+            }
+            else if (target.puzzle.rewardItem) {
+                this.actor.inventory.addItem(target.puzzle.rewardItem);
+                this.scene.addWorldEvent(`${this.actor.name} bypassed "${target.puzzle.name}" (${this.bypassType}) in ${room.name}.`);
+                this.scene.updateInventory(this.scene.getPlayer().inventory);
+            }
+        }
+        if (result.alarmed) {
+            // The consequence for a failed bypass: NPCs already listen for world
+            // events (see scene.ts's getWorldEventsSummary()), so this alone lets
+            // them react organically without a dedicated alarm/alert subsystem.
+            this.scene.addWorldEvent(`${this.actor.name}'s ${this.bypassType} attempt on "${target.puzzle.name}" in ${room.name} went loud.`);
+        }
+        this.logger.write(`${this.actor.name} attempted to ${this.bypassType} "${target.puzzle.name}": ${result.success ? 'success' : 'failure'}${result.alarmed ? ' (alarmed)' : ''}`);
+        this.actor.performAction(this.bypassType, result.message);
+        // A failed bypass is instant, unrecoverable death -- there's no partial
+        // credit for tripping an alarm or a ward's backlash mid-run. Reuses the
+        // same endGame() a player-kill already uses (see kill.ts): freezes
+        // input and self-announces directly to the screen, so the fatal reason
+        // stays on screen instead of vanishing the instant blessed's alternate
+        // buffer tears down. That announcement happens synchronously before
+        // this returns, so it renders BEFORE this command's own return value --
+        // found via a real session where an immediate process.exit() killed the
+        // alternate screen before the player had any chance to read why. Only
+        // ends the actual player's session: an NPC has no `game` in its context
+        // (see command.ts), so this is a no-op for an NPC's own failed attempt.
+        if (result.alarmed && this.game) {
+            await this.scene.endGame();
+            this.logger.logWithColor(result.message, 'red');
+            this.logger.logWithColor(`💀 GAME OVER -- your run ends here.`, 'red');
+            this.logger.logWithColor(`Press ctrl-c to quit.`, 'red');
+            return '';
+        }
+        return result.message;
+    }
+}
+//# sourceMappingURL=bypass-command.js.map

package/bundle/typescript/src/commands/game/sideQuest/commands/bypass-command.js.map

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

package/bundle/typescript/src/commands/game/sideQuest/commands/call.d.ts

@@ -0,0 +1,19 @@
+import { Command, ICommand } from './command.js';
+export declare class CallCommand extends Command implements ICommand {
+    protected static verb: string;
+    protected static description: string;
+    execute(args: string[]): Promise<string>;
+    private hasEquippedCommlink;
+    private hasCommlink;
+    /**
+     * Multi-word names ("Mr. Johnson") shouldn't require the player to quote
+     * them just to call someone, and partial names shouldn't fail -- found
+     * via real sessions where "call Mr. Johnson" (period parsing), then
+     * "call mr" and "call Mr. J" (partials) all bounced. Tries progressively
+     * shorter word-prefixes of the input (longest first), resolving each
+     * through the same fuzzy matcher "take"/"attack"/"cast" use (punctuation
+     * and typo tolerant; an ambiguous fragment deliberately misses).
+     * Whatever's left over after the matched name becomes the message.
+     */
+    private resolveTargetAndMessage;
+}

package/bundle/typescript/src/commands/game/sideQuest/commands/call.js

@@ -0,0 +1,149 @@
+import { Command } from './command.js';
+import { Category } from '../types/shared/item-enum.js';
+import { parseArgsWithQuotes } from './talk.js';
+import { CALL_ICON, CALL_COLOR } from '../utilities/comm-style.js';
+import { FIXER_NAME } from '../factories/scene-seed-generator.js';
+import { fuzzyPickName } from '../utilities/fuzzy-match.js';
+export class CallCommand extends Command {
+    static verb = 'call';
+    static description = 'Call someone remotely over a commlink (no need to be in the same room; commlink must be equipped).';
+    async execute(args) {
+        if (!args || args.length === 0) {
+            return 'Usage: call <name> [message]';
+        }
+        const rawWords = parseArgsWithQuotes(args.join(' '));
+        if (!this.hasEquippedCommlink(this.actor)) {
+            return `You need to equip a commlink before you can call anyone.`;
+        }
+        // Running silent kills the broadcast both ways (see silent.ts).
+        if (this.actor.runningSilent) {
+            return `You're running silent -- your link isn't broadcasting. Go loud ("silent") before calling anyone.`;
+        }
+        // Hacked dark is a different kind of quiet (see hack.ts PAN attacks).
+        if (this.actor.arOffline) {
+            return `Your AR is CUT -- someone cracked your PAN and your link is dead air. "reboot" first.`;
+        }
+        const { target, remainingWords } = this.resolveTargetAndMessage(rawWords);
+        if (!target) {
+            return `You don't know anyone by the name "${rawWords[0]}" to call.`;
+        }
+        if (target === this.actor) {
+            return "You can't call yourself.";
+        }
+        if (!this.hasCommlink(target)) {
+            return `You don't get through -- ${target.name} doesn't seem to have a commlink.`;
+        }
+        if (target.runningSilent) {
+            return `You can't raise ${target.name} -- their link isn't broadcasting. They're running silent.`;
+        }
+        const message = remainingWords.join(' ');
+        const greeting = message || `(calling) You there, ${target.name}?`;
+        this.actor.performAction('calls', target.name);
+        this.logger.write(`${this.actor.name} calls ${target.name}: "${greeting}"`);
+        // Cleanly disconnect any stale prior call on either side before linking
+        // the new one -- otherwise a former partner would be left thinking
+        // they're still connected (their own "say" would keep routing to
+        // someone who's since moved on). See end-call.ts for the explicit
+        // version of this same disconnect.
+        if (this.actor.activeCallPartner && this.actor.activeCallPartner !== target) {
+            this.actor.activeCallPartner.activeCallPartner = undefined;
+        }
+        if (target.activeCallPartner && target.activeCallPartner !== this.actor) {
+            target.activeCallPartner.activeCallPartner = undefined;
+        }
+        // Symmetric: either side can now reach the other with an ordinary
+        // "say", not just this initial hail -- see say.ts. Stays connected
+        // until "end-call" (or a new call replaces it, per above).
+        this.actor.activeCallPartner = target;
+        target.activeCallPartner = this.actor;
+        // If the caller is holding this run's win-condition macguffin and
+        // calls its intended recipient, treat the call itself as the hand-off.
+        // Fixers work deals over comms, not face to face -- there's no in-world
+        // reason a physical "give" should ever be required for a job-giver
+        // who's meant to be unreachable in person. Resolved synchronously
+        // (doesn't depend on the NPC's reply), so it's reflected in this
+        // command's own return text right away.
+        let deliveryNote = '';
+        let deliveredItemName = '';
+        const wc = this.scene.getWinCondition();
+        if (wc?.type === 'give' && wc.toNpc?.toLowerCase() === target.name.toLowerCase()) {
+            const item = this.actor.inventory.getItem(wc.item);
+            if (item) {
+                const delivered = this.actor.inventory.transferItemTo(item.name, target.inventory);
+                if (delivered) {
+                    this.scene.updateInventory(this.scene.getPlayer().inventory);
+                    this.scene.checkWinCondition(item.name, target.name);
+                    deliveryNote = ` You relay that you have the ${item.name} -- consider it delivered.`;
+                    deliveredItemName = item.name;
+                }
+            }
+        }
+        // Fold the delivery into what the NPC actually hears (not just the
+        // player-facing confirmation above) -- otherwise an NPC whose reply is
+        // AI-generated has no way to know the job's already done, and keeps
+        // asking about it on a callback.
+        const heardMessage = deliveredItemName
+            ? `${greeting} [System note: ${this.actor.name} just delivered "${deliveredItemName}" to you over this call.]`
+            : greeting;
+        // Deliberately does NOT require sharing a room with the target -- the
+        // whole point of a commlink call is reaching someone you can't walk up
+        // to (a fixer working from a hideout you'll never set foot in, say).
+        // Deliberately NOT awaited: the target's reply (if any) comes from an
+        // AI round-trip and announces itself to the screen on its own once it
+        // arrives. Awaiting it here would block this confirmation behind that
+        // delay, so the reply could render before "You call X" does -- making
+        // it look like the call was never actually made.
+        void Promise.resolve(target.hear(this.actor, heardMessage)).catch(err => {
+            this.logger.error(`${target.name} failed to handle a call from ${this.actor.name}: ${err}`);
+        });
+        // Calling ${FIXER_NAME} once the job's done is what actually gets you
+        // the next one -- the in-fiction equivalent of typing "continue", which
+        // still works too as an explicit fallback. Deliberately checks the
+        // fixer's identity directly, NOT the win condition's toNpc: a job's
+        // "give" target is often a one-off contact ${FIXER_NAME} pointed the
+        // runner toward, not ${FIXER_NAME} himself (see the "broker, not always
+        // the destination" convention), so it's ${FIXER_NAME} specifically who
+        // lines up the next gig, regardless of who this job's delivery went to.
+        // Not gated on this call being the one that JUST completed the job:
+        // checking in on an already-finished job (e.g. delivered via "give"
+        // instead) triggers it just as well. Runs in the background (see
+        // Game.draftNextSceneInBackground()) -- job generation can take 20-40+
+        // seconds, and this confirmation shouldn't wait behind it.
+        if (this.game && this.scene.isCompleted() && target.name === FIXER_NAME) {
+            this.game.draftNextSceneInBackground();
+        }
+        return `{${CALL_COLOR}-fg}${CALL_ICON} You call ${target.name}: "${greeting}"${deliveryNote}{/${CALL_COLOR}-fg}`;
+    }
+    hasEquippedCommlink(actor) {
+        return actor.equipment.head?.commlink != null;
+    }
+    hasCommlink(actor) {
+        const inInventory = actor.inventory.getAllItems().some(item => item.category === Category.Commlink);
+        return inInventory || this.hasEquippedCommlink(actor);
+    }
+    /**
+     * Multi-word names ("Mr. Johnson") shouldn't require the player to quote
+     * them just to call someone, and partial names shouldn't fail -- found
+     * via real sessions where "call Mr. Johnson" (period parsing), then
+     * "call mr" and "call Mr. J" (partials) all bounced. Tries progressively
+     * shorter word-prefixes of the input (longest first), resolving each
+     * through the same fuzzy matcher "take"/"attack"/"cast" use (punctuation
+     * and typo tolerant; an ambiguous fragment deliberately misses).
+     * Whatever's left over after the matched name becomes the message.
+     */
+    resolveTargetAndMessage(words) {
+        // Includes the caller too, so "call <own name>" resolves into the
+        // actual "can't call yourself" check below rather than a confusing
+        // "don't know anyone" -- self is never a real target.
+        const candidates = [this.actor, ...this.scene.allActors];
+        const names = candidates.map(a => a.name);
+        for (let i = words.length; i >= 1; i--) {
+            const picked = fuzzyPickName(words.slice(0, i).join(' '), names);
+            if (picked) {
+                return { target: candidates.find(a => a.name === picked), remainingWords: words.slice(i) };
+            }
+        }
+        return { target: undefined, remainingWords: [] };
+    }
+}
+//# sourceMappingURL=call.js.map

package/bundle/typescript/src/commands/game/sideQuest/commands/call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/commands/call.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,OAAO,WAAY,SAAQ,OAAO;IAC5B,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC;IACrB,MAAM,CAAC,WAAW,GAAG,oGAAoG,CAAC;IAEpI,KAAK,CAAC,OAAO,CAAC,IAAc;QAC1B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,8BAA8B,CAAC;QACxC,CAAC;QAED,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAErD,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,OAAO,0DAA0D,CAAC;QACpE,CAAC;QAED,gEAAgE;QAChE,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;YAC7B,OAAO,kGAAkG,CAAC;QAC5G,CAAC;QACD,sEAAsE;QACtE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YACzB,OAAO,uFAAuF,CAAC;QACjG,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QAE1E,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,sCAAsC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC;QACvE,CAAC;QAED,IAAI,MAAM,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1B,OAAO,0BAA0B,CAAC;QACpC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,OAAO,4BAA4B,MAAM,CAAC,IAAI,mCAAmC,CAAC;QACpF,CAAC;QAED,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACzB,OAAO,mBAAmB,MAAM,CAAC,IAAI,4DAA4D,CAAC;QACpG,CAAC;QAED,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,OAAO,IAAI,wBAAwB,MAAM,CAAC,IAAI,GAAG,CAAC;QAEnE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,UAAU,MAAM,CAAC,IAAI,MAAM,QAAQ,GAAG,CAAC,CAAC;QAE5E,wEAAwE;QACxE,mEAAmE;QACnE,iEAAiE;QACjE,kEAAkE;QAClE,mCAAmC;QACnC,IAAI,IAAI,CAAC,KAAK,CAAC,iBAAiB,IAAI,IAAI,CAAC,KAAK,CAAC,iBAAiB,KAAK,MAAM,EAAE,CAAC;YAC5E,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,iBAAiB,GAAG,SAAS,CAAC;QAC7D,CAAC;QACD,IAAI,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,iBAAiB,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YACxE,MAAM,CAAC,iBAAiB,CAAC,iBAAiB,GAAG,SAAS,CAAC;QACzD,CAAC;QAED,kEAAkE;QAClE,mEAAmE;QACnE,2DAA2D;QAC3D,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,MAAM,CAAC;QACtC,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC;QAEtC,kEAAkE;QAClE,uEAAuE;QACvE,wEAAwE;QACxE,mEAAmE;QACnE,kEAAkE;QAClE,iEAAiE;QACjE,wCAAwC;QACxC,IAAI,YAAY,GAAG,EAAE,CAAC;QACtB,IAAI,iBAAiB,GAAG,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;QACxC,IAAI,EAAE,EAAE,IAAI,KAAK,MAAM,IAAI,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACjF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YACnD,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;gBACnF,IAAI,SAAS,EAAE,CAAC;oBACd,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC;oBAC7D,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;oBACrD,YAAY,GAAG,gCAAgC,IAAI,CAAC,IAAI,4BAA4B,CAAC;oBACrF,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;QAED,mEAAmE;QACnE,uEAAuE;QACvE,oEAAoE;QACpE,iCAAiC;QACjC,MAAM,YAAY,GAAG,iBAAiB;YACpC,CAAC,CAAC,GAAG,QAAQ,kBAAkB,IAAI,CAAC,KAAK,CAAC,IAAI,oBAAoB,iBAAiB,2BAA2B;YAC9G,CAAC,CAAC,QAAQ,CAAC;QAEb,sEAAsE;QACtE,uEAAuE;QACvE,qEAAqE;QACrE,sEAAsE;QACtE,sEAAsE;QACtE,sEAAsE;QACtE,sEAAsE;QACtE,iDAAiD;QACjD,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;YACtE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,iCAAiC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC;QAC9F,CAAC,CAAC,CAAC;QAEH,sEAAsE;QACtE,wEAAwE;QACxE,mEAAmE;QACnE,oEAAoE;QACpE,qEAAqE;QACrE,wEAAwE;QACxE,uEAAuE;QACvE,wEAAwE;QACxE,oEAAoE;QACpE,oEAAoE;QACpE,iEAAiE;QACjE,uEAAuE;QACvE,2DAA2D;QAC3D,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACxE,IAAI,CAAC,IAAI,CAAC,0BAA0B,EAAE,CAAC;QACzC,CAAC;QAED,OAAO,IAAI,UAAU,OAAO,SAAS,aAAa,MAAM,CAAC,IAAI,MAAM,QAAQ,IAAI,YAAY,KAAK,UAAU,MAAM,CAAC;IACnH,CAAC;IAEO,mBAAmB,CAAC,KAAa;QACvC,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,IAAI,IAAI,CAAC;IAChD,CAAC;IAEO,WAAW,CAAC,KAAa;QAC/B,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpG,OAAO,WAAW,IAAI,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;;;OASG;IACK,uBAAuB,CAAC,KAAe;QAC7C,kEAAkE;QAClE,mEAAmE;QACnE,sDAAsD;QACtD,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAE1C,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YACjE,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7F,CAAC;QACH,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;IACnD,CAAC"}

package/bundle/typescript/src/commands/game/sideQuest/commands/cast.d.ts

@@ -0,0 +1,58 @@
+import { BypassCommand } from './bypass-command.js';
+import { PuzzleBypassType } from '../types/seed/puzzle-seed.js';
+/**
+ * Gear-driven spellcasting (see Player's magic section): you know a spell
+ * if you carry its SpellFormula (or any Grimoire), and the best Focus on
+ * you scales the casting pool. "cast <spell> [at <target>]" casts; a bare
+ * "cast" (or "cast <direction/barrier>") is still the ward-bypass route
+ * inherited from BypassCommand -- now gated on actually having magic gear,
+ * instead of being a free-floating coin flip anyone could attempt.
+ */
+export declare class CastCommand extends BypassCommand {
+    protected static verb: string;
+    protected static description: string;
+    protected bypassType: PuzzleBypassType;
+    protected noPuzzleMessage: string;
+    execute(args?: string[]): Promise<string>;
+    /**
+     * Lenient spell-name matching: the exact key, or a unique fragment of at
+     * least 3 characters ("bolt"/"mana" -> manabolt). Anything that doesn't
+     * resolve falls through to the ward-bypass path, which is what a
+     * direction or barrier name ("cast north", "cast maglock") needs.
+     */
+    private resolveSpellName;
+    private castSpell;
+    /**
+     * Support spells (heal/armor) default to SELF but can target an ally:
+     * "cast heal on jinx". Touch range -- the target must share the room --
+     * and the same fuzzy name matching as everything else. Returns an error
+     * string instead of a target when the name can't be resolved here.
+     */
+    private resolveAllyTarget;
+    /** How the caster's pool reads in narration: focus-assisted, raw talent, or book-learned. */
+    private castingLabel;
+    /**
+     * Drain, resolved AFTER the spell: resist with Body, take whatever gets
+     * through as STUN damage -- casting doesn't cut you, it wrings you out.
+     * A full stun track is a knockout, and overflow past it spills into the
+     * physical track (enough drain doesn't just put you down, it starts
+     * killing you). Callers check drainCollapse() afterward.
+     */
+    private applyDrain;
+    /**
+     * What the drain just did to the caster, if anything: overflow filling
+     * the physical track is a burnout DEATH; a full stun track alone is a
+     * knockout -- out of the run, but honestly narrated as unconsciousness.
+     */
+    private drainCollapse;
+    private castManabolt;
+    private castHeal;
+    private castArmor;
+    /**
+     * Non-combat casts are a single block, no exchange pacing needed: the
+     * player's own casts return the text for ui.ts to print, while an NPC's
+     * cast self-announces to a witnessing player (its return value only ever
+     * feeds its AI history) -- same rationale as CombatExchange.
+     */
+    private finishSpell;
+}