@maka/maka-cli 5.105.0 → 5.108.0

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

@@ -0,0 +1,128 @@
+import { Command } from './command.js';
+import { hint } from '../utilities/hints.js';
+import { Category } from '../types/shared/item-enum.js';
+import { fuzzyPickName } from '../utilities/fuzzy-match.js';
+import { fileReach, planeTintItemName } from '../utilities/planes.js';
+/**
+ * "download" -- WRITE A FILE OUT OF THE GRID AND ONTO SOMETHING YOU CAN
+ * HAND OVER.
+ *
+ * Two reports, one hole:
+ *
+ *   aNeh5TELvdgeS2vpg (Deditri): "paydata in this run is stuck with the
+ *   sprite, It won't give it to me and there is not way to get it to
+ *   Marrow."
+ *
+ *   MxiKYFGeStiyvibJN (Maka): "there needs to be a way to move data from
+ *   matrix to meatworld in the form of 'download'."
+ *
+ * THE CONVERSION ALREADY EXISTED AND HAD NO NAME. take.ts has flipped a
+ * matrix-plane file to `meat` and re-categorised it as a Datachip for a
+ * while now -- "pulled down ... written to a chip". So the mechanic was
+ * built; what was missing was a VERB anybody would think to type, and a
+ * source other than the floor.
+ *
+ * THE SPRITE IS THE CASE THAT HAD NO ROUTE AT ALL. `take` reads the
+ * ROOM's inventory, and Deditri's chip was in a compiled sprite's hands.
+ * `give` was no help from either end: it refuses whenever an actor is off
+ * the meat plane, and a sprite is `plane: 'matrix'` by construction, so
+ * "order sprite give me the chip" could never work. The only route left
+ * was `decompile` -- destroying your own sprite to make it drop the
+ * loot -- which is exactly the "hidden, non-obvious solution" the vetting
+ * described. It is also a lousy trade the player has no way to know they
+ * are making.
+ *
+ * SO THIS VERB READS BOTH SOURCES: files loose on the grid where you are
+ * standing, and files carried by YOUR OWN compiled sprites. Somebody
+ * else's sprite is not a shelf you may take from -- that is a hack, and
+ * hack.ts owns it.
+ *
+ * DELIBERATELY NOT A TEST. Pulling a file you already have reach on is
+ * not an opposed action in this engine -- `take` does not roll for it
+ * either, and getting past whatever GUARDED the file is what the host
+ * crack and the mark already charged for. Adding dice here would price
+ * the same obstacle twice.
+ */
+export class DownloadCommand extends Command {
+    static verb = 'download';
+    static description = 'Write a file out of the Matrix onto a chip you carry -- "download <file>". Reads data loose on the grid where you stand AND data your own sprites are holding, which is the one place nothing else could reach it. A downloaded file is ordinary meat-world cargo: you can carry it, stash it, or hand it to somebody.';
+    async execute(args = []) {
+        const actor = this.actor;
+        const room = actor.currentLocation;
+        // WHAT IS IN REACH, from both sources.
+        //
+        // The room's own files honour fileReach (utilities/planes.ts) -- a
+        // host's contents are inside the host and an offline server wants a
+        // body in the room -- because a download that ignored the boundary
+        // would be a way to read a sealed host from the street, which is the
+        // very thing eJANPpm7qCaCAJBJw was filed about.
+        const reach = fileReach(actor, room);
+        const loose = reach === 'open'
+            ? room.inventory.getAllItems().filter(i => i.plane === 'matrix')
+            : [];
+        // YOUR sprites, not everyone's. `compiledBy` is not modelled on the
+        // shell, so ownership is "it is in YOUR companion list" -- which is
+        // the same thing the order/decompile verbs already mean by it.
+        const mine = (this.game?.companions ?? []).filter(c => c.kind === 'sprite');
+        const carried = [];
+        for (const entry of mine) {
+            for (const item of entry.npc.inventory.getAllItems()) {
+                if (item.plane === 'matrix')
+                    carried.push({ npc: entry.npc, item });
+            }
+        }
+        if (loose.length === 0 && carried.length === 0) {
+            return `Nothing to pull down -- no data on the grid here, and nothing your sprites are carrying.${reach === 'enter' ? hint(` (This room's files live INSIDE its host -- "enter" first.)`) : ''}`;
+        }
+        // Bare "download" is the LIST. A verb whose whole reason for existing
+        // is that nobody could find the file should say what it can see.
+        const query = args.join(' ').trim();
+        if (query.length === 0) {
+            const lines = [`{cyan-fg}Within reach to pull down:{/cyan-fg}`];
+            for (const i of loose)
+                lines.push(`  ${planeTintItemName(i, actor.plane)} -- loose on the grid here`);
+            for (const c of carried)
+                lines.push(`  ${planeTintItemName(c.item, actor.plane)} -- held by ${c.npc.name}`);
+            lines.push(hint(`("download <file>" writes it to a chip you carry.)`));
+            return lines.join('\n');
+        }
+        const names = [...loose.map(i => i.name), ...carried.map(c => c.item.name)];
+        const picked = fuzzyPickName(query, names);
+        if (!picked) {
+            return `No file called "${query}" within reach.${hint(` ("download" on its own lists what is.)`)}`;
+        }
+        const fromSprite = carried.find(c => c.item.name === picked);
+        const item = fromSprite ? fromSprite.item : loose.find(i => i.name === picked);
+        // THE CONVERSION, identical to take.ts's. Same two fields, because a
+        // file that came down by one verb and a file that came down by the
+        // other must be the same object afterwards -- a chip you can `give`.
+        try {
+            actor.addInventory(item);
+        }
+        catch {
+            return `You can't carry any more -- ${item.name} stays where it is.`;
+        }
+        if (fromSprite) {
+            fromSprite.npc.inventory.removeItem(item.name);
+        }
+        else {
+            room.inventory.removeItem(item.name);
+            room.plainSightItems.delete(item.name.toLowerCase());
+        }
+        item.plane = 'meat';
+        item.category = Category.Datachip;
+        actor.performAction('pulls a file down', `${item.name} writing to a chip`);
+        this.logger.write(`${actor.name} downloaded "${item.name}"${fromSprite ? ` from ${fromSprite.npc.name}` : ` from ${room.name}`}.`);
+        this.scene.updateStatus();
+        return fromSprite
+            ? [
+                `{cyan-fg}${fromSprite.npc.name} opens its hands and the data pours out of them.{/cyan-fg}`,
+                `You pull {bold}{underline}${item.name}{/underline}{/bold} down onto a chip -- meat-world cargo now.${hint(` (You can "give ${item.name}" to somebody standing in front of you.)`)}`,
+            ].join('\n')
+            : [
+                `{cyan-fg}You pull {bold}{underline}${item.name}{/underline}{/bold} down off the grid -- written to a chip.{/cyan-fg}`,
+                hint(`(Meat-world cargo now: carry it, stash it, or "give" it to somebody.)`),
+            ].join('\n');
+    }
+}
+//# sourceMappingURL=download.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/commands/download.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAItE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,OAAO,eAAgB,SAAQ,OAAO;IAChC,MAAM,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,MAAM,CAAC,WAAW,GAAG,wTAAwT,CAAC;IAExV,KAAK,CAAC,OAAO,CAAC,OAAiB,EAAE;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,eAAe,CAAC;QAEnC,uCAAuC;QACvC,EAAE;QACF,mEAAmE;QACnE,oEAAoE;QACpE,mEAAmE;QACnE,qEAAqE;QACrE,gDAAgD;QAChD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAc,EAAE,IAAI,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAW,KAAK,KAAK,MAAM;YACpC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC;YAChE,CAAC,CAAC,EAAE,CAAC;QAEP,oEAAoE;QACpE,oEAAoE;QACpE,+DAA+D;QAC/D,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAC5E,MAAM,OAAO,GAA+B,EAAE,CAAC;QAC/C,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;gBACrD,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ;oBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO,2FAA2F,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACnM,CAAC;QAED,sEAAsE;QACtE,iEAAiE;QACjE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,CAAC,+CAA+C,CAAC,CAAC;YAChE,KAAK,MAAM,CAAC,IAAI,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,iBAAiB,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;YACtG,KAAK,MAAM,CAAC,IAAI,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,iBAAiB,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5G,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC,CAAC;YACvE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,mBAAmB,KAAK,kBAAkB,IAAI,CAAC,yCAAyC,CAAC,EAAE,CAAC;QACrG,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAE,CAAC;QAEhF,qEAAqE;QACrE,mEAAmE;QACnE,qEAAqE;QACrE,IAAI,CAAC;YACH,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,+BAA+B,IAAI,CAAC,IAAI,qBAAqB,CAAC;QACvE,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACf,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;QACpB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAElC,KAAK,CAAC,aAAa,CAAC,mBAAmB,EAAE,GAAG,IAAI,CAAC,IAAI,oBAAoB,CAAC,CAAC;QAC3E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,gBAAgB,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,SAAS,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACnI,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;QAE1B,OAAO,UAAU;YACf,CAAC,CAAC;gBACA,YAAY,UAAU,CAAC,GAAG,CAAC,IAAI,4DAA4D;gBAC3F,6BAA6B,IAAI,CAAC,IAAI,gEAAgE,IAAI,CAAC,mBAAmB,IAAI,CAAC,IAAI,0CAA0C,CAAC,EAAE;aACrL,CAAC,IAAI,CAAC,IAAI,CAAC;YACZ,CAAC,CAAC;gBACA,sCAAsC,IAAI,CAAC,IAAI,uEAAuE;gBACtH,IAAI,CAAC,uEAAuE,CAAC;aAC9E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC"}

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

@@ -30,6 +30,7 @@ import { currentSession } from './utilities/session-context.js';
 import { PlayersCommand } from './commands/players.js';
 import { LookCommand } from './commands/look.js';
 import { TakeCommand } from './commands/take.js';
+import { DownloadCommand } from './commands/download.js';
 import { LootCommand } from './commands/loot.js';
 import { NoteCommand } from './commands/note.js';
 import { BacklogCommand } from './commands/backlog.js';
@@ -2205,6 +2206,7 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         CommandFactory.registerCommand('follow', FollowCommand);
         CommandFactory.registerCommand('unfollow', UnfollowCommand);
         CommandFactory.registerCommand('take', TakeCommand);
+        CommandFactory.registerCommand('download', DownloadCommand);
         CommandFactory.registerCommand('loot', LootCommand);
         CommandFactory.registerCommand('note', NoteCommand);
         CommandFactory.registerCommand('backlog', BacklogCommand);
@@ -5409,7 +5411,7 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         // players" / "crew street"); the bare verb still answers quietly.
         { title: 'party', entries: [['crew', 'party'], ['hire'], ['dismiss'], ['train'], ['order'], ['lead'], ['command'], ['deploy'], ['recall']] },
         { title: 'magic', entries: [['spells'], ['cast'], ['summon', 'conjure'], ['project', 'astral'], ['return'], ['assense']] },
-        { title: 'matrix', entries: [['jack'], ['jackpoint'], ['deck'], ['load'], ['unload'], ['hack'], ['mark'], ['enter'], ['exit-host'], ['tap', 'splice'], ['snoop'], ['overwatch', 'os'], ['pan'], ['ar'], ['aros'], ['silent'], ['reboot'], ['agent'], ['drone'], ['jump', 'rig']] },
+        { title: 'matrix', entries: [['jack'], ['jackpoint'], ['deck'], ['load'], ['unload'], ['hack'], ['mark'], ['download'], ['enter'], ['exit-host'], ['tap', 'splice'], ['snoop'], ['overwatch', 'os'], ['pan'], ['ar'], ['aros'], ['silent'], ['reboot'], ['agent'], ['drone'], ['jump', 'rig']] },
         // The Emerged get their own shelf (player request: "there MUST be
         // resonance" -- matrix is the place, Resonance is the talent).
         // `sustain` shelves here and not under magic: the command is