@maka/maka-cli 5.3.17 → 5.5.0

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

@@ -0,0 +1,219 @@
+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.`;
+        }
+        // Talking on comms is not a quiet activity (see sneak.ts).
+        this.actor.sneaking = false;
+        // "call taxi" / "call cab": transport is a phone call away, like
+        // everything else in this world -- no system travel verbs. With a job
+        // pending, the cab comes to WHEREVER you are and takes you to the
+        // run; with a WRAPPED job it takes you home to the hub. Checked
+        // before NPC resolution ("taxi" is a service, not a person).
+        const spoken = rawWords.map(w => w.toLowerCase()).filter(w => w !== 'a' && w !== 'the');
+        if (this.game?.hasHub && (spoken[0] === 'taxi' || spoken[0] === 'cab')) {
+            if (this.actor.plane !== 'meat') {
+                return this.actor.plane === 'matrix'
+                    ? `Cabs take bodies, not personas -- "jack out" first.`
+                    : `Cabs take bodies, not ghosts -- "return" first.`;
+            }
+            if (this.actor.inExchange) {
+                return `Mid-fight is no time to hail a cab.`;
+            }
+            if (this.scene.isHub && this.game.pendingRun) {
+                this.actor.performAction('calls a taxi', 'and steps to the curb');
+                const ride = this.game.pendingRide;
+                const trip = await this.game.launchPendingRun();
+                return `${ride?.arrive ?? 'A cab pulls up.'}\n${ride?.board ?? 'You climb in.'}\n${trip}`;
+            }
+            if (!this.scene.isHub && this.scene.isCompleted()) {
+                this.actor.performAction('calls a taxi', 'for the ride home');
+                const home = await this.game.continueToNextScene();
+                return `A cab noses out of the dark and finds you like it always knew where you'd be.\n${home}`;
+            }
+            if (this.scene.isHub) {
+                return `The dispatcher's bored voice: "No fare on the books for you, chummer." (No job arranged -- "call ${FIXER_NAME}" first.)`;
+            }
+            return `No cab rolls into the middle of a live job. Finish it -- or walk.`;
+        }
+        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.`;
+        }
+        // HUB flow: calling the fixer from home isn't a conversation -- it's
+        // the COMMISSION. He answers, tells you to stay by your link, and
+        // hangs up; the job arrives as HIS callback the moment drafting lands
+        // (see Game.draftNextScene's incoming-call handoff). No lingering
+        // chat: a real session found it confusing to still be talking to the
+        // man who just said "I'll call you back."
+        if (this.game && this.game.hasHub && this.scene.isHub && target.name === FIXER_NAME) {
+            this.actor.performAction('calls', target.name);
+            // A job is WAITING: this call is the offer. The line connects for
+            // real -- his AI pitches it in his own voice, the rate can be
+            // haggled right here (haggle.ts reads the pending seed), and
+            // "travel" is what actually takes it. Calling again re-delivers.
+            const pending = this.game.pendingRun;
+            if (pending) {
+                this.actor.activeCallPartner = target;
+                target.activeCallPartner = this.actor;
+                void Promise.resolve(target.hear(this.actor, `[System note: you sent ${this.actor.name} a message about a job and they are calling back. Pitch it in your own voice: "${pending.name}" -- ${pending.story} The payout is EXACTLY ${pending.winCondition?.payout ?? 'unset'} nuyen (they may haggle). The fare's on the client's account -- taking the job means calling a taxi ("call taxi"), which picks them up wherever they are.]`)).catch(err => {
+                    this.logger.error(`${target.name} failed to pitch the pending job: ${err}`);
+                });
+                return `${CALL_ICON} ${FIXER_NAME} picks up.\n=== JOB OFFER #${this.game.pendingRunTier}: ${pending.name} ===\n${pending.story}\n("haggle" to talk rate, "end-call" to think. Fare's on the client -- "call taxi" when you're in.)`;
+            }
+            const gate = this.game.canDraftNextScene();
+            // Plain text (icon only, no color tags): a real session saw the
+            // closing tag render literally on this line.
+            if (gate.allowed) {
+                this.game.draftNextSceneInBackground();
+                return `${CALL_ICON} One ring. "${FIXER_NAME}. I'll have work for you shortly -- I'll ping you." Click.`;
+            }
+            return `${CALL_ICON} One ring. "${gate.message ?? 'Working on it.'}" Click.`;
+        }
+        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.
+        //
+        // CLASSIC sessions only (hub calls short-circuit above): calling the
+        // fixer after a completed job chain-drafts the next one. In hub
+        // sessions a finished run's Johnson call is just a call -- "continue"
+        // home first, then commission the next job from there.
+        if (this.game && target.name === FIXER_NAME
+            && !this.game.hasHub
+            && this.game.canDraftNextScene().allowed) {
+            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":"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"}

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;
+}