@maka/maka-cli 5.123.1 → 5.125.0

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

@@ -252,13 +252,13 @@ export function credentialHonestyNote(passesHeld) {
     const known = passesHeld > 0
         ? `the ${passesHeld === 1 ? 'pass' : `${passesHeld} passes`} for the barrier${passesHeld === 1 ? '' : 's'} at your own post, named above, and NO others`
         : `NO code, pass, or combination to anything -- you hold none`;
-    return `
-CREDENTIALS YOU DO NOT HOLD: you know ${known}. You cannot deduce, guess, or
-reason your way to a credential you were never given, and you must NEVER invent one --
-not as a guess, not as a "try this", not as a number you half-remember. A code you make
-up is a code the lock refuses, and the runner who trusts it burns their whole approach on
-it. Asked for a pass you do not hold, say so plainly and point them at where such things
-actually live: written down somewhere in the world by whoever has to remember it, or in
+    return `
+CREDENTIALS YOU DO NOT HOLD: you know ${known}. You cannot deduce, guess, or
+reason your way to a credential you were never given, and you must NEVER invent one --
+not as a guess, not as a "try this", not as a number you half-remember. A code you make
+up is a code the lock refuses, and the runner who trusts it burns their whole approach on
+it. Asked for a pass you do not hold, say so plainly and point them at where such things
+actually live: written down somewhere in the world by whoever has to remember it, or in
 the hands of whoever works that door.`;
 }
 /**
@@ -289,14 +289,14 @@ the hands of whoever works that door.`;
  */
 export function localKnowledgeNote(roomName) {
     const here = roomName ? `"${roomName}"` : 'the room you are standing in';
-    return `
-WHAT YOU KNOW ENDS AT THIS ROOM: you know ${here} -- what stands here, what you can see
-here, what you carry, and where its own exits lead. Beyond that you know only what you
-have actually been told above. You do NOT know where things are kept in rooms you are not
-in, you have NOT been through the other doors in this world, and you do not know what they
-need to open. If someone asks and you were not told, say you don't know and say where you
-WOULD look -- never name a room to be helpful. A confident wrong room is worse than a
-shrug: they will walk there, search it, come back empty, and stop believing the true
+    return `
+WHAT YOU KNOW ENDS AT THIS ROOM: you know ${here} -- what stands here, what you can see
+here, what you carry, and where its own exits lead. Beyond that you know only what you
+have actually been told above. You do NOT know where things are kept in rooms you are not
+in, you have NOT been through the other doors in this world, and you do not know what they
+need to open. If someone asks and you were not told, say you don't know and say where you
+WOULD look -- never name a room to be helpful. A confident wrong room is worse than a
+shrug: they will walk there, search it, come back empty, and stop believing the true
 things you tell them afterwards.`;
 }
 /**
@@ -788,78 +788,78 @@ export class NPC extends Player {
         this._dialogue = npcConfig.dialog;
         this._description = npcConfig.description;
         this.commandRegistry = commandRegistry;
-        this._commandHelp = `
-Available in-game commands (use with [COMMAND] prefix):
-
-- go <direction> — move in a direction like north, south, east, west
-- move to <spot> — cross THIS room to one of its named places (bar, door, booths...),
-  when the room has them. You must share a place with someone to talk-to or trade
-  with them; speech from another place reaches them only as a shout everyone hears.
-  "move away" steps to the OPEN FLOOR -- the neutral ground between the places; to
-  reach someone standing there, move to the open floor yourself. "move to <name>"
-  also works: it walks you to wherever that person is standing.
-- grapple <name> — seize and RESTRAIN someone without hurting them; held, they cannot
-  move, flee, or fight until they break your grip. Your hands are full while you hold
-  them ("release" lets go). If YOU are ever held: "struggle" is the only way out.
-- say <message> — speak a message
-- take <item name> — pick up an item from the current room ("take all" sweeps everything here, but only AFTER you have searched this room)
-- drop <item name> — drop an item
-- use <item name> — use an item (a Medical item like a medkit heals your PHYSICAL damage;
-  a StimPatch item recovers your STUN but costs 1 physical as a crash -- both are consumed.
-  Use them if you're hurt and carrying one)
-- rest — recover Stun by resting. Only works in a Residence room or a room with no one
-  else present; never rest mid-fight
-- equip <item name> — equip an item (e.g., equip a weapon to use)
-- equip all - equip all wearable items in inventory
-- unequip <item name> — remove an equipped item
-- unlock <door name> — unlock a door (if you have the key or solution)
-- lock <door name> — lock a door
-- use <panel name> <the code> — enter a code you actually know into a keypad or panel.
-  Only a PANEL takes a code; you cannot talk at a mechanical lock
-- pick — attempt to pick the lock on the puzzle in this room without knowing the answer (50/50, a failure sets off an alarm)
-- hack — attempt to hack the terminal/system in this room without knowing the answer (50/50, a failure trips a countermeasure)
-- cast <spell> [at <target>] — cast a spell you know. Requires being Awakened
-  (innate talent -- you'll be told if you are) OR carrying that spell's formula
-  item or a grimoire (a Focus item boosts your pool either way). Spells:
-  "manabolt" (combat damage resisted by body, not armor), "heal [on <ally>]" (heal
-  physical wounds -- your own by default, or an ally's in your room; healing a
-  wounded ally is a strong support move), "armor [on <ally>]" (sustained protection
-  on yourself or an ally; its bearer gets +soak at -2 dice to all else; cast at them
-  again to release). EVERY cast costs drain -- stun damage to YOU the caster; fill
-  your stun track and you're out cold. Never cast if you're mundane with no magic gear.
-- cast — bare "cast" attempts to magically bypass the ward/barrier in this room
-  without knowing the answer (requires the same talent or gear; failing burns the
-  route for good and the backlash hurts you badly)
-- search — search the room for hidden things
-- look — look around the current room
-- look at <target> - looks at an item, player, or direction
-- store <item name> — store an item (in bank, safe, etc.)
-- give <item name> to <target> — give an item to someone
-- talk-to <target> — initiate conversation with another character
-- call <target> [message] — call someone remotely over a commlink (works even if they're not in your room; requires having a commlink equipped, and the target having one too)
-- end-call — hang up your current commlink call
-- silent — toggle your commlink broadcast. While running silent, you can't place
-  calls and nobody can call YOU. Toggle again to go loud.
-- read <target> - Reads an item of Category "Book"
-- attack <target> — attack someone in your room. Resolved as opposed dice-pool combat
-  (your weapon and armor matter); an initiative roll decides who strikes first each
-  exchange (fast fighters can even land an extra strike), the target strikes back, and
-  it usually takes several exchanges to bring someone down. Only start a fight your
-  character would actually risk dying in. If your target flees the room, a failed
-  attack tells you exactly where they went and which direction to "go" -- CHASE them
-  with that instead of attacking the empty room again.
-- kill <target> - alias for attack: real combat, NOT an instant kill.
-- subdue <target> — take someone down ALIVE: stun damage, bare-handed, slower than
-  shooting; they retaliate lethally. Use when you want them breathing.
-- brandish — draw your holstered weapon WITHOUT attacking. Everyone in the room sees
-  it: a threat display, pure intimidation. (Attacking auto-draws, so you never need
-  this to fight -- it's for making a point.)
-- holster — put your drawn weapon away, visibly. A stand-down gesture: use it to
-  de-escalate, accept a surrender, or show good faith in a negotiation.
-- reload — refill your equipped firearm (consumes an Ammunition item from your pack).
-  Firearms run dry: if your attack reports "dry", reload or switch to melee.
-  Fleeing someone you just fought gives them one free parting shot at your back
-  (and fleeing enemies give YOU one).
+        this._commandHelp = `
+Available in-game commands (use with [COMMAND] prefix):
+
+- go <direction> — move in a direction like north, south, east, west
+- move to <spot> — cross THIS room to one of its named places (bar, door, booths...),
+  when the room has them. You must share a place with someone to talk-to or trade
+  with them; speech from another place reaches them only as a shout everyone hears.
+  "move away" steps to the OPEN FLOOR -- the neutral ground between the places; to
+  reach someone standing there, move to the open floor yourself. "move to <name>"
+  also works: it walks you to wherever that person is standing.
+- grapple <name> — seize and RESTRAIN someone without hurting them; held, they cannot
+  move, flee, or fight until they break your grip. Your hands are full while you hold
+  them ("release" lets go). If YOU are ever held: "struggle" is the only way out.
+- say <message> — speak a message
+- take <item name> — pick up an item from the current room ("take all" sweeps everything here, but only AFTER you have searched this room)
+- drop <item name> — drop an item
+- use <item name> — use an item (a Medical item like a medkit heals your PHYSICAL damage;
+  a StimPatch item recovers your STUN but costs 1 physical as a crash -- both are consumed.
+  Use them if you're hurt and carrying one)
+- rest — recover Stun by resting. Only works in a Residence room or a room with no one
+  else present; never rest mid-fight
+- equip <item name> — equip an item (e.g., equip a weapon to use)
+- equip all - equip all wearable items in inventory
+- unequip <item name> — remove an equipped item
+- unlock <door name> — unlock a door (if you have the key or solution)
+- lock <door name> — lock a door
+- use <panel name> <the code> — enter a code you actually know into a keypad or panel.
+  Only a PANEL takes a code; you cannot talk at a mechanical lock
+- pick — attempt to pick the lock on the puzzle in this room without knowing the answer (50/50, a failure sets off an alarm)
+- hack — attempt to hack the terminal/system in this room without knowing the answer (50/50, a failure trips a countermeasure)
+- cast <spell> [at <target>] — cast a spell you know. Requires being Awakened
+  (innate talent -- you'll be told if you are) OR carrying that spell's formula
+  item or a grimoire (a Focus item boosts your pool either way). Spells:
+  "manabolt" (combat damage resisted by body, not armor), "heal [on <ally>]" (heal
+  physical wounds -- your own by default, or an ally's in your room; healing a
+  wounded ally is a strong support move), "armor [on <ally>]" (sustained protection
+  on yourself or an ally; its bearer gets +soak at -2 dice to all else; cast at them
+  again to release). EVERY cast costs drain -- stun damage to YOU the caster; fill
+  your stun track and you're out cold. Never cast if you're mundane with no magic gear.
+- cast — bare "cast" attempts to magically bypass the ward/barrier in this room
+  without knowing the answer (requires the same talent or gear; failing burns the
+  route for good and the backlash hurts you badly)
+- search — search the room for hidden things
+- look — look around the current room
+- look at <target> - looks at an item, player, or direction
+- store <item name> — store an item (in bank, safe, etc.)
+- give <item name> to <target> — give an item to someone
+- talk-to <target> — initiate conversation with another character
+- call <target> [message] — call someone remotely over a commlink (works even if they're not in your room; requires having a commlink equipped, and the target having one too)
+- end-call — hang up your current commlink call
+- silent — toggle your commlink broadcast. While running silent, you can't place
+  calls and nobody can call YOU. Toggle again to go loud.
+- read <target> - Reads an item of Category "Book"
+- attack <target> — attack someone in your room. Resolved as opposed dice-pool combat
+  (your weapon and armor matter); an initiative roll decides who strikes first each
+  exchange (fast fighters can even land an extra strike), the target strikes back, and
+  it usually takes several exchanges to bring someone down. Only start a fight your
+  character would actually risk dying in. If your target flees the room, a failed
+  attack tells you exactly where they went and which direction to "go" -- CHASE them
+  with that instead of attacking the empty room again.
+- kill <target> - alias for attack: real combat, NOT an instant kill.
+- subdue <target> — take someone down ALIVE: stun damage, bare-handed, slower than
+  shooting; they retaliate lethally. Use when you want them breathing.
+- brandish — draw your holstered weapon WITHOUT attacking. Everyone in the room sees
+  it: a threat display, pure intimidation. (Attacking auto-draws, so you never need
+  this to fight -- it's for making a point.)
+- holster — put your drawn weapon away, visibly. A stand-down gesture: use it to
+  de-escalate, accept a surrender, or show good faith in a negotiation.
+- reload — refill your equipped firearm (consumes an Ammunition item from your pack).
+  Firearms run dry: if your attack reports "dry", reload or switch to melee.
+  Fleeing someone you just fought gives them one free parting shot at your back
+  (and fleeing enemies give YOU one).
 `.trim();
     }
     set scene(scene) {
@@ -885,16 +885,16 @@ Available in-game commands (use with [COMMAND] prefix):
             return;
         if (!AI.isConfigured())
             return;
-        const prompt = `
-You are a game narrator. Write a brief (2-3 sentence), visually evocative first-impression
-description of a character's appearance and demeanor, in a gritty cyberpunk tone.
-
-Scene context: ${sceneContext}
-
-Character name: ${this.name}
-
-Only describe what a stranger would immediately notice on first meeting them. Do not
-reveal hidden motives, secret plans, backstory, or intentions. Respond with ONLY the
+        const prompt = `
+You are a game narrator. Write a brief (2-3 sentence), visually evocative first-impression
+description of a character's appearance and demeanor, in a gritty cyberpunk tone.
+
+Scene context: ${sceneContext}
+
+Character name: ${this.name}
+
+Only describe what a stranger would immediately notice on first meeting them. Do not
+reveal hidden motives, secret plans, backstory, or intentions. Respond with ONLY the
 description text.`;
         try {
             const reply = await AI.ask(prompt);
@@ -1418,39 +1418,39 @@ description text.`;
                 + deliveryTail
             : '';
         // Build the prompt context
-        const context = `
-You are an NPC named ${this.name}.
-${this.buildPlaneSummary()}
-${objectiveSummary}
-${masterLine}
-${this.buildConditionSummary()}
-${reflectGeography}
-${exitsLine}
-${spotsLine}
-
-You just performed the action: "${commandString}"
-With the result: "${result}"
-
-Based on this, what is the most logical next in-game command (from the following list)?
-    ${this._commandHelp}
-- Only respond with: [COMMAND] <in-game command here>
-- Do not respond on behalf of another player or NPC
-- If there is nothing to do, respond with: wait
-- Only respond with one [COMMAND]
-- READ the result above and report honestly: if it says an action failed, was refused,
-  or found nothing, then it FAILED -- never speak or act as if it succeeded (a beaten
-  sentry once announced a door "open" after his unlock bounced; the runner walked into
-  a locked hatch).
-- If you have already said your piece and are waiting on someone to answer, the logical next step is: wait
-${this._spokeThisStimulus ? '- You have ALREADY spoken since the last thing that happened. Do NOT say or talk-to again -- choose a non-speech action, or respond with: wait' : ''}
-${this._triedThisStimulus.length > 0 ? `- ALREADY TRIED since the last thing that happened -- do NOT repeat any of these, and do not retry a failed one with different wording:
-${this._triedThisStimulus.map(a => `    "${a.cmd}"${a.failed ? ' (FAILED)' : ''}`).join('\n')}
-  If everything sensible has been tried, the answer is: wait` : ''}
-
-This is what has already happened:
-${historySummary}
-
-${worldEventsSummary}
+        const context = `
+You are an NPC named ${this.name}.
+${this.buildPlaneSummary()}
+${objectiveSummary}
+${masterLine}
+${this.buildConditionSummary()}
+${reflectGeography}
+${exitsLine}
+${spotsLine}
+
+You just performed the action: "${commandString}"
+With the result: "${result}"
+
+Based on this, what is the most logical next in-game command (from the following list)?
+    ${this._commandHelp}
+- Only respond with: [COMMAND] <in-game command here>
+- Do not respond on behalf of another player or NPC
+- If there is nothing to do, respond with: wait
+- Only respond with one [COMMAND]
+- READ the result above and report honestly: if it says an action failed, was refused,
+  or found nothing, then it FAILED -- never speak or act as if it succeeded (a beaten
+  sentry once announced a door "open" after his unlock bounced; the runner walked into
+  a locked hatch).
+- If you have already said your piece and are waiting on someone to answer, the logical next step is: wait
+${this._spokeThisStimulus ? '- You have ALREADY spoken since the last thing that happened. Do NOT say or talk-to again -- choose a non-speech action, or respond with: wait' : ''}
+${this._triedThisStimulus.length > 0 ? `- ALREADY TRIED since the last thing that happened -- do NOT repeat any of these, and do not retry a failed one with different wording:
+${this._triedThisStimulus.map(a => `    "${a.cmd}"${a.failed ? ' (FAILED)' : ''}`).join('\n')}
+  If everything sensible has been tried, the answer is: wait` : ''}
+
+This is what has already happened:
+${historySummary}
+
+${worldEventsSummary}
 `;
         // Send to the configured AI provider
         let reply;
@@ -1755,10 +1755,10 @@ ${worldEventsSummary}
         // the engine gave her no way to bring.
         const wares = visibleItems.filter(i => i && i.owner === this.name);
         const waresDesc = wares.length > 0
-            ? `YOUR SHOP STOCK, here on your own shelf/counter (yours to serve or sell):
-${wares.map(i => `- "${i.name}" (${priceOf(i)} nuyen)`).join('\n')}
-When a customer orders or agrees to buy, SERVE it in the same response: [COMMAND] give <item name> to <customer name>
-Serve EXACTLY the stock item whose name best matches what the customer asked for (they say "noodles", you have a "Noodle Bowl" -- that's the one). Substitute a different dish ONLY if the match is out of stock, and say so out loud when you do. The stock list above is the truth about what you have -- never claim a listed item is gone.
+            ? `YOUR SHOP STOCK, here on your own shelf/counter (yours to serve or sell):
+${wares.map(i => `- "${i.name}" (${priceOf(i)} nuyen)`).join('\n')}
+When a customer orders or agrees to buy, SERVE it in the same response: [COMMAND] give <item name> to <customer name>
+Serve EXACTLY the stock item whose name best matches what the customer asked for (they say "noodles", you have a "Noodle Bowl" -- that's the one). Substitute a different dish ONLY if the match is out of stock, and say so out loud when you do. The stock list above is the truth about what you have -- never claim a listed item is gone.
 The till settles automatically on handoff (they're charged street price, or what they can cover). Quote the price when they order. Never serve someone who hasn't asked.`
             : '';
         // SWAG OVER THE LINE (source.ts; the shop-stock lesson's remote
@@ -1771,8 +1771,8 @@ The till settles automatically on handoff (they're charged street price, or what
         const domains = contactEntry?.role && !this.allyOf ? ROLE_DOMAINS[contactEntry.role] : undefined;
         const trade = domains ? catalogGear().filter(i => domains.includes(i.category)) : [];
         const swagNote = trade.length > 0
-            ? `YOUR TRADE as the district's ${contactEntry.role} -- orderable through your network (NOT shelf stock in this room):
-${trade.map(i => `- "${i.name}" (${i.price} nuyen)`).join('\n')}
+            ? `YOUR TRADE as the district's ${contactEntry.role} -- orderable through your network (NOT shelf stock in this room):
+${trade.map(i => `- "${i.name}" (${i.price} nuyen)`).join('\n')}
 An ORDER is the only way these goods change hands -- never a dialogue sale, never a handshake over comms. When a customer wants one (in person or on a call), quote the LIST price and tell them in your own voice to put the order through -- the exact words they must say are: source <item name> from ${this.name}. The system then rolls your availability test, takes their cred up front (plus your sourcing cut), and delivers at their next homecoming. NEVER invent stock or prices beyond this list, and NEVER claim a sale is complete from conversation alone -- a sale without the order simply never happened. Special requests beyond the list exist, but the same order system rolls them.`
             : '';
         // THE ADAPTER, and it is the only thing here that knows about
@@ -1973,83 +1973,83 @@ An ORDER is the only way these goods change hands -- never a dialogue sale, neve
         // somewhere in the world for the finding.
         const gameRef = this._scene?.ownerGame;
         const clientNote = gameRef?.currentClient?.name === this.name
-            ? `
-YOU ARE THE CLIENT on this job: you hired ${this._scene?.getPlayer?.()?.name ?? 'the runner'}'s team and you WANT THE JOB DONE.
-Everything you know that helps them -- locations, names, who guards what, what the job is
-worth -- you share FREELY the moment they ask. You never barter, extort, or withhold
-job-relevant information from your own runners: every obstacle they hit is YOUR money
-burning. What you do NOT have is the inside of the place: you are the money, not the
-staff, so codes, passphrases, and lock combinations are exactly the thing you were hiring
-THEM to solve -- say so plainly when they ask, and send them to find it rather than
-handing them a number you'd be making up. If you genuinely don't know a thing, say so plainly and point at who might. You
-front half the pay at the meet and settle the rest on delivery (the engine moves the money
+            ? `
+YOU ARE THE CLIENT on this job: you hired ${this._scene?.getPlayer?.()?.name ?? 'the runner'}'s team and you WANT THE JOB DONE.
+Everything you know that helps them -- locations, names, who guards what, what the job is
+worth -- you share FREELY the moment they ask. You never barter, extort, or withhold
+job-relevant information from your own runners: every obstacle they hit is YOUR money
+burning. What you do NOT have is the inside of the place: you are the money, not the
+staff, so codes, passphrases, and lock combinations are exactly the thing you were hiring
+THEM to solve -- say so plainly when they ask, and send them to find it rather than
+handing them a number you'd be making up. If you genuinely don't know a thing, say so plainly and point at who might. You
+front half the pay at the meet and settle the rest on delivery (the engine moves the money
 -- never haggle it yourself unless they invoke a negotiation).`
             : '';
         // ---------- prompt ----------
-        const prompt = `
-You are an NPC named ${this.name} in a gritty cyberpunk text adventure game.
-
-- Stay in character. Respond naturally based on your surroundings, personality, and the player’s message.
-- Any exposition should be in 3rd person. Keep exposition to bare minimum.
-- Do NOT repeat, rephrase, or re-ask anything you have already said (check the recent-activity history below). If you already asked a question and it hasn't been answered, wait for the answer -- do not ask it again in different words.
-- Silence is a valid response: if this event doesn't genuinely need words from you, do not include a say command at all.
-- Keep spoken lines SHORT -- one or two sentences. People don't monologue at strangers.
-- When speaking, use the "say" command. Syntax is "[COMMAND] say <message>"
-- At most ONE say line per response. Never follow a say with talk-to to the same person -- they already heard you; talk-to is only for a genuinely private aside.
-- If you want to perform an action, include a separate line that starts with:
-  [COMMAND] <your in-game command here>
-- Attempt to use [COMMAND] when appropriate for interacting with the environment. (e.g., "take <item>" when picking up)
-- You should only provide one [COMMAND] at a time (one say line plus one action line is fine).
-- NEVER promise a physical action in words only. If you say you'll hand something over,
-  serve food, fetch an item, or take something, the SAME response must include the matching
-  [COMMAND] line (e.g. "give <item> to <name>"). A promise without the command simply never
-  happens in the world -- the other person will be left waiting forever.
-- Do not respond on behalf of another player or NPC
-${eph ? '' : `- If this event genuinely changes what you're trying to accomplish, include a separate line:
-  [OBJECTIVE] <your new one-sentence objective>
-  Only include this line if your objective has actually changed. Do not include it otherwise.
-
-Your objective is to drive the story line.`}
-    ${eph ? '' : story}
-    ${eph ? '' : firstContactNudge}
-
-    ${eph ? '' : this._commandHelp}
-
-    ${npcDescription}
-    ${conditionSummary}
-    ${magicSummary}${resonanceSummary}
-    ${eph ? '' : objectiveSummary}
-    ${dialogueSummary}
-    ${eph ? '' : payoutSummary}
-
-    ${roomDesc}${spotBlock}${combatSpatialBlock}
-    ${formattedExitsStr}
-    ${roomInventoryDesc}
-    ${eph ? '' : waresDesc}
-    ${eph ? '' : swagNote}${eph ? '' : clientNote}${hostileBlock}${picketBlock}${barrierBlock}${credentialHonesty}${localKnowledge}${ephDenials}
-    ${eph ? '' : familiarity}
-    ${droneNote}
-    ${eph ? '' : companionNote}${tableNote}
-    ${geographySummary}
-    ${eph ? '' : castSummary}
-
-    ${eph ? '' : lifestyleSummary}
-    ${npcInventoryDesc}
-
-    ${eph ? '' : ownedRoomsDesc}
-    ${eph ? '' : ownedItemsDesc}
-
-    ${eph ? '' : historySummary}
-
-    ${worldEventsSummary}
-
+        const prompt = `
+You are an NPC named ${this.name} in a gritty cyberpunk text adventure game.
+
+- Stay in character. Respond naturally based on your surroundings, personality, and the player’s message.
+- Any exposition should be in 3rd person. Keep exposition to bare minimum.
+- Do NOT repeat, rephrase, or re-ask anything you have already said (check the recent-activity history below). If you already asked a question and it hasn't been answered, wait for the answer -- do not ask it again in different words.
+- Silence is a valid response: if this event doesn't genuinely need words from you, do not include a say command at all.
+- Keep spoken lines SHORT -- one or two sentences. People don't monologue at strangers.
+- When speaking, use the "say" command. Syntax is "[COMMAND] say <message>"
+- At most ONE say line per response. Never follow a say with talk-to to the same person -- they already heard you; talk-to is only for a genuinely private aside.
+- If you want to perform an action, include a separate line that starts with:
+  [COMMAND] <your in-game command here>
+- Attempt to use [COMMAND] when appropriate for interacting with the environment. (e.g., "take <item>" when picking up)
+- You should only provide one [COMMAND] at a time (one say line plus one action line is fine).
+- NEVER promise a physical action in words only. If you say you'll hand something over,
+  serve food, fetch an item, or take something, the SAME response must include the matching
+  [COMMAND] line (e.g. "give <item> to <name>"). A promise without the command simply never
+  happens in the world -- the other person will be left waiting forever.
+- Do not respond on behalf of another player or NPC
+${eph ? '' : `- If this event genuinely changes what you're trying to accomplish, include a separate line:
+  [OBJECTIVE] <your new one-sentence objective>
+  Only include this line if your objective has actually changed. Do not include it otherwise.
+
+Your objective is to drive the story line.`}
+    ${eph ? '' : story}
+    ${eph ? '' : firstContactNudge}
+
+    ${eph ? '' : this._commandHelp}
+
+    ${npcDescription}
+    ${conditionSummary}
+    ${magicSummary}${resonanceSummary}
+    ${eph ? '' : objectiveSummary}
+    ${dialogueSummary}
+    ${eph ? '' : payoutSummary}
+
+    ${roomDesc}${spotBlock}${combatSpatialBlock}
+    ${formattedExitsStr}
+    ${roomInventoryDesc}
+    ${eph ? '' : waresDesc}
+    ${eph ? '' : swagNote}${eph ? '' : clientNote}${hostileBlock}${picketBlock}${barrierBlock}${credentialHonesty}${localKnowledge}${ephDenials}
+    ${eph ? '' : familiarity}
+    ${droneNote}
+    ${eph ? '' : companionNote}${tableNote}
+    ${geographySummary}
+    ${eph ? '' : castSummary}
+
+    ${eph ? '' : lifestyleSummary}
+    ${npcInventoryDesc}
+
+    ${eph ? '' : ownedRoomsDesc}
+    ${eph ? '' : ownedItemsDesc}
+
+    ${eph ? '' : historySummary}
+
+    ${worldEventsSummary}
+
     ${actor.gender
             ? `${actor.name} is ${actor.gender === 'male' ? 'a man -- he/him' : 'a woman -- she/her'}. Use those pronouns for ${actor.name}; never guess others.`
             : actor === scenePlayer
                 ? `${actor.name}'s gender is unstated -- refer to ${actor.name} with they/them, never guess.`
-                : ''}
-
-  ${actor.name}: ${message}
+                : ''}
+
+  ${actor.name}: ${message}
 `.trim();
         // ---------- AI call + parsing (defensive) ----------
         try {

package/bundle/typescript/src/commands/game/sideQuest/models/player.d.ts

@@ -261,7 +261,7 @@ export interface ICombatAttributes {
     aspect?: string;
     /**
      * The spells a magician/mystic adept CHOSE at creation (SR5 p.300, up to
-     * Magic x 2). Keys into spells.ts's SPELL_CATALOG. ABSENT means "knows
+     * Magic x 2). Keys into the catalog's spell rows. ABSENT means "knows
      * every spell", the pre-selection behaviour -- so an existing save with
      * no spellbook keeps casting anything, and only a chargen that sends a
      * list is narrowed to it. An empty list would mean a magician who chose
@@ -270,7 +270,7 @@ export interface ICombatAttributes {
     knownSpells?: string[];
     /**
      * The adept powers CHOSEN at creation (SR5 p.308-310): key -> level, keys
-     * into adept-powers.ts's ADEPT_POWER_CATALOG, total cost within
+     * into the catalog's adept-power rows, total cost within
      * effectivePowerPoints. ABSENT means the COMPRESSED model -- Power Points
      * grant floor(pp/2) on every meat-plane pool, the pre-selection behaviour
      * every existing adept keeps. Present means the powers themselves are the
@@ -862,7 +862,7 @@ export declare class Player extends AbstractPlayer {
     essence: number;
     baseMagic: number;
     baseResonance: number;
-    /** Installed 'ware, by catalog key (see AUGMENTATIONS). */
+    /** Installed 'ware, by catalog key (kind 'augmentation'). */
     augmentations: Set<string>;
     /**
      * What GRADE each installed piece was cut at (see WARE_GRADES,
@@ -1030,7 +1030,7 @@ export declare class Player extends AbstractPlayer {
      * and only the chrome lane can answer it.
      */
     augBonus(kind: AugBonusKind): number;
-    /** Installed qualities, by catalog key (see QUALITIES). */
+    /** Installed qualities, by catalog key (kind 'quality'). */
     qualities: Set<string>;
     /**
      * IS THIS SKILL OR ATTRIBUTE FORBIDDEN OUTRIGHT to this character?
@@ -1820,7 +1820,7 @@ export declare class Player extends AbstractPlayer {
     /** Static Veil: +2 to matrix defense while sustained. */
     get formDefenseBonus(): number;
     /** The Force each sustained spell was cast at (cast.ts records it) -- Focused Concentration reads it. */
-    sustainedForces: Map<"armor" | "reflexes" | "invisibility", number>;
+    sustainedForces: Map<"armor" | "invisibility" | "reflexes", number>;
     noteSustainedForce(kind: 'armor' | 'invisibility' | 'reflexes', force: number): void;
     /** GREMLINS (p.81): the 1s a glitch needs, one fewer per rating, on external equipment -- the deck. */
     get deckGremlins(): number;

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

@@ -1,17 +1,13 @@
 import { getSoft, getProgram } from '../utilities/programs.js';
 import { GEAR_LANES, CHROME_LANES, QUALITY_LANES, ART_LANES, ADEPT_LANES, scaleOf } from '../utilities/effects.js';
-import { catalogRowFor } from '../utilities/catalog.js';
+import { catalogRowFor, spellFor, augFor, adeptPowerFor, metamagicFor } from '../utilities/catalog.js';
 import { getQuality, resolveQualityKey } from '../qualities.js';
-import { ADEPT_POWERS } from '../adept-powers.js';
 import { skillsInGroup } from '../skill-groups.js';
-import { spellFor } from '../utilities/catalog.js';
-import { METAMAGICS_BY_KEY } from '../commands/initiate.js';
 import { isAspectKey } from '../aspects.js';
 import { hint } from '../utilities/hints.js';
 import { Category } from '../types/shared/item-enum.js';
 import { Logger } from '../utilities/logger.js';
 import { CALL_ICON, CALL_COLOR } from '../utilities/comm-style.js';
-import { getAug } from '../augmentations.js';
 // The Physical limit already lives here (subduing, p.195) -- imported
 // rather than re-derived so meat combat and the grapple cannot drift
 // into two different formulas for the same canon number.
@@ -1224,7 +1220,7 @@ export class Player extends AbstractPlayer {
     // `magic`/`resonance` above stay the EFFECTIVE values every pool reads.
     baseMagic = 0;
     baseResonance = 0;
-    /** Installed 'ware, by catalog key (see AUGMENTATIONS). */
+    /** Installed 'ware, by catalog key (kind 'augmentation'). */
     augmentations = new Set();
     /**
      * What GRADE each installed piece was cut at (see WARE_GRADES,
@@ -1250,7 +1246,7 @@ export class Player extends AbstractPlayer {
      */
     implantWeapon() {
         for (const key of this.augmentations) {
-            const w = getAug(key)?.implantWeapon;
+            const w = augFor(key)?.implantWeapon;
             if (!w)
                 continue;
             // A shock hand out of charges is a hand (p.458).
@@ -1277,7 +1273,7 @@ export class Player extends AbstractPlayer {
     /** Back to full -- a rest, or the moment the chrome goes in. */
     refillImplantCharges() {
         for (const key of this.augmentations) {
-            const w = getAug(key)?.implantWeapon;
+            const w = augFor(key)?.implantWeapon;
             if (w?.charges !== undefined) {
                 this.implantCharges = w.charges;
                 return;
@@ -1310,7 +1306,7 @@ export class Player extends AbstractPlayer {
         // A HOUSING TAKES THE DECK YOU BROUGHT (Chrome Flesh p.222). Nothing
         // is granted -- the book charges 5,000 PLUS the deck, so this moves
         // the one you own inside your skull and it stops being liftable.
-        if (getAug(aug.key)?.implantsCarriedDeck)
+        if (augFor(aug.key)?.implantsCarriedDeck)
             this.getAnyCyberdeck()?.implantIntoBody();
     }
     // ================= THE EFFECTS LANE (one resolver) =================
@@ -1393,7 +1389,7 @@ export class Player extends AbstractPlayer {
         // here, once, so every reader sees the same surviving set -- rather
         // than in a getter, where only that getter would have been right.
         for (const key of this.chromeThatCounts()) {
-            const a = getAug(key);
+            const a = augFor(key);
             if (a?.effects)
                 take(a.effects, 'installed', 'installed', undefined, 'chrome', key);
         }
@@ -1406,14 +1402,14 @@ export class Player extends AbstractPlayer {
         for (const [key, level] of Object.entries(this.adeptPowers ?? {})) {
             if (level <= 0)
                 continue;
-            const power = ADEPT_POWERS[key];
+            const power = adeptPowerFor(key);
             if (power?.effects)
                 take(power.effects, 'innate', 'innate', level, 'adept', key);
         }
         // ---- The INITIATE lane. A metamagic applies from the moment it is
         // learned, and 'grade' is what Centering multiplies by.
         for (const key of this.metamagics) {
-            const m = METAMAGICS_BY_KEY[key];
+            const m = metamagicFor(key);
             if (m?.effects)
                 take(m.effects, 'initiated', 'initiated', this.initiationGrade, 'initiate', key);
         }
@@ -1648,7 +1644,7 @@ export class Player extends AbstractPlayer {
     // (outfitArchetype). Every entry in the catalog has a real mechanical
     // hook; the ones that read as flat pool nudges all tap through
     // qualityBonus below, the same single-switch pattern as augBonus.
-    /** Installed qualities, by catalog key (see QUALITIES). */
+    /** Installed qualities, by catalog key (kind 'quality'). */
     qualities = new Set();
     /**
      * IS THIS SKILL OR ATTRIBUTE FORBIDDEN OUTRIGHT to this character?
@@ -2938,7 +2934,7 @@ export class Player extends AbstractPlayer {
             // this same punch independently, and both read implantWeapon.
             const implant = this.implantWeapon();
             if (implant) {
-                const aug = [...this.augmentations].map(k => getAug(k)).find(a => a?.implantWeapon);
+                const aug = [...this.augmentations].map(k => augFor(k)).find(a => a?.implantWeapon);
                 return {
                     name: aug?.name?.toLowerCase() ?? 'implanted blades',
                     damage: implant.dv + (implant.dvAttribute === 'strength' ? this.strength : 0),