@polycode-projects/the-mechanical-code-talker 5.0.4 → 5.0.5

package/src/services/mudiii-viz.mjs

@@ -497,32 +497,41 @@ ${scenarioList.map((s, i) => `          <option value="${i}"${i === 0 ? " select
         <button type="button" class="deck-info-btn" id="deckInfoBtn" aria-expanded="false" aria-controls="deckInfoPopup" aria-label="about this demo">?</button>
         <span class="mono deck-turns" id="globalTurnCount">turns: 0</span>
       </div>
-      <div class="deck-sliders">
-        <label class="deck-slider">foxes
-          <input type="range" id="playerCountSlider" min="0" max="${PLAYER_COUNTS.length - 1}" step="1"
-                 value="${Math.max(0, PLAYER_COUNTS.indexOf(DEFAULT_PLAYER_COUNT))}"
-                 list="playerCountTicks" aria-valuetext="${DEFAULT_PLAYER_COUNT} foxes">
-          <datalist id="playerCountTicks">${PLAYER_COUNTS.map((n, i) => `<option value="${i}" label="${n}"></option>`).join("")}</datalist>
-          <span class="mono" id="playerCountValue">${DEFAULT_PLAYER_COUNT}</span>
-        </label>
-        <label class="deck-slider">goblins
-          <input type="range" id="npcCountSlider" min="${NPC_COUNT_MIN}" max="${NPC_COUNT_MAX}" step="1"
-                 value="${DEFAULT_NPC_COUNT}"
-                 list="npcCountTicks" aria-valuetext="${DEFAULT_NPC_COUNT} goblins">
-          <datalist id="npcCountTicks">${Array.from({ length: NPC_COUNT_MAX - NPC_COUNT_MIN + 1 }, (_, i) => {
-            const n = NPC_COUNT_MIN + i;
-            return NPC_COUNT_LABELLED.includes(n) ? `<option value="${n}" label="${n}"></option>` : `<option value="${n}"></option>`;
-          }).join("")}</datalist>
-          <span class="mono" id="npcCountValue">${DEFAULT_NPC_COUNT}</span>
-        </label>
-        <label class="deck-slider">delay
-          <input type="range" id="delaySlider" min="80" max="2000" step="20" value="${DEFAULT_DELAY_MS}">
-          <span class="mono" id="delayValue">${DEFAULT_DELAY_MS}ms</span>
-        </label>
-        <label class="deck-slider">max turns
-          <input type="range" id="maxTurnsSlider" min="20" max="2000" step="20" value="${DEFAULT_MAX_TURNS}">
-          <span class="mono" id="maxTurnsValue">${DEFAULT_MAX_TURNS}</span>
-        </label>
+      <div class="deck-body">
+        <div class="deck-sliders">
+          <label class="deck-slider">foxes
+            <input type="range" id="playerCountSlider" min="0" max="${PLAYER_COUNTS.length - 1}" step="1"
+                   value="${Math.max(0, PLAYER_COUNTS.indexOf(DEFAULT_PLAYER_COUNT))}"
+                   list="playerCountTicks" aria-valuetext="${DEFAULT_PLAYER_COUNT} foxes">
+            <datalist id="playerCountTicks">${PLAYER_COUNTS.map((n, i) => `<option value="${i}" label="${n}"></option>`).join("")}</datalist>
+            <span class="mono" id="playerCountValue">${DEFAULT_PLAYER_COUNT}</span>
+          </label>
+          <label class="deck-slider">goblins
+            <input type="range" id="npcCountSlider" min="${NPC_COUNT_MIN}" max="${NPC_COUNT_MAX}" step="1"
+                   value="${DEFAULT_NPC_COUNT}"
+                   list="npcCountTicks" aria-valuetext="${DEFAULT_NPC_COUNT} goblins">
+            <datalist id="npcCountTicks">${Array.from({ length: NPC_COUNT_MAX - NPC_COUNT_MIN + 1 }, (_, i) => {
+              const n = NPC_COUNT_MIN + i;
+              return NPC_COUNT_LABELLED.includes(n) ? `<option value="${n}" label="${n}"></option>` : `<option value="${n}"></option>`;
+            }).join("")}</datalist>
+            <span class="mono" id="npcCountValue">${DEFAULT_NPC_COUNT}</span>
+          </label>
+          <label class="deck-slider">delay
+            <input type="range" id="delaySlider" min="80" max="2000" step="20" value="${DEFAULT_DELAY_MS}">
+            <span class="mono" id="delayValue">${DEFAULT_DELAY_MS}ms</span>
+          </label>
+          <label class="deck-slider">max turns
+            <input type="range" id="maxTurnsSlider" min="20" max="2000" step="20" value="${DEFAULT_MAX_TURNS}">
+            <span class="mono" id="maxTurnsValue">${DEFAULT_MAX_TURNS}</span>
+          </label>
+        </div>
+        <section class="map-panel" id="mapPanel" aria-label="the town square, from above">
+          <div class="map-panel-head">
+            <span class="map-panel-title">the square, from above</span>
+            <span class="mono map-panel-turn" id="mapPanelTurn">turn 0</span>
+          </div>
+          <div class="map-panel-board" id="mapPanelBoard"></div>
+        </section>
       </div>
       <div class="deck-camera">
         <label class="deck-slider">follow
@@ -542,13 +551,6 @@ ${openingAgents.map((a) => `            <option value="${escapeHtml(a.id)}">${es
         <button type="button" class="deck-info-popup-close" id="deckInfoClose" aria-label="close">&times;</button>
       </div>
     </section>
-    <section class="map-panel" id="mapPanel" aria-label="the town square, from above">
-      <div class="map-panel-head">
-        <span class="map-panel-title">the square, from above</span>
-        <span class="mono map-panel-turn" id="mapPanelTurn">turn 0</span>
-      </div>
-      <div class="map-panel-board" id="mapPanelBoard"></div>
-    </section>
   </div>
   <section class="scene-stage" id="sceneStage" aria-label="the town square, in three dimensions">
     <canvas id="sceneCanvas"></canvas>
@@ -628,7 +630,7 @@ const MUDIII_STYLE = `
   }
   .mudiii-topbar-help:hover { border-color: var(--square-accent); }
 
-  .deck-row { display: grid; grid-template-columns: 1fr 1fr; gap: 1rem; align-items: stretch; margin-bottom: 1rem; }
+  .deck-row { margin-bottom: 1rem; }
   .deck {
     position: relative;
     background: var(--parchment); border: 1px solid var(--square-stone-dark); border-radius: 4px;
@@ -656,9 +658,10 @@ const MUDIII_STYLE = `
   .deck-play { background: var(--square-ink) !important; color: var(--parchment); border-color: var(--square-ink) !important; padding: .38rem 1.1rem !important; }
   .deck-play[aria-pressed="true"] { background: var(--square-accent) !important; border-color: var(--square-accent) !important; color: var(--square-ink); }
   .deck-turns { margin-left: auto; font-size: .74rem; color: var(--square-stone-dark); background: var(--square-stone-dark); background: rgba(43,35,24,.9); color: var(--square-accent); border-radius: 2px; padding: .1rem .5rem; }
-  .deck-sliders { display: flex; flex-wrap: wrap; gap: 1rem; }
-  .deck-slider { display: flex; align-items: center; gap: .35rem; font-family: ${MONO_STACK}; font-size: .62rem; text-transform: uppercase; letter-spacing: .08em; color: var(--square-stone-dark); }
-  .deck-slider input[type="range"] { accent-color: var(--square-accent); width: 8rem; max-width: 34vw; }
+  .deck-body { display: flex; gap: .7rem; align-items: flex-start; }
+  .deck-sliders { display: flex; flex-wrap: wrap; gap: 1rem; flex: 1 1 auto; min-width: 0; }
+  .deck-slider { display: flex; align-items: center; gap: .35rem; font-family: ${MONO_STACK}; font-size: .62rem; text-transform: uppercase; letter-spacing: .08em; color: var(--square-stone-dark); min-width: 0; }
+  .deck-slider input[type="range"] { accent-color: var(--square-accent); flex: 1 1 4rem; min-width: 2.5rem; width: auto; max-width: 8rem; }
   .camera-mode { display: inline-flex; gap: .25rem; }
   .camera-mode button[aria-pressed="true"] { background: var(--square-accent); border-color: var(--square-accent); color: var(--square-ink); }
   .deck-info-popup {
@@ -678,13 +681,14 @@ const MUDIII_STYLE = `
 
   .map-panel {
     background: var(--square-stone-dark); color: var(--parchment);
-    border: 1px solid var(--square-accent); border-radius: 4px; padding: .55rem .65rem .6rem;
-    display: flex; flex-direction: column; gap: .4rem; min-width: 0;
+    border: 1px solid var(--square-accent); border-radius: 4px; padding: .5rem .55rem .55rem;
+    display: flex; flex-direction: column; gap: .35rem; min-width: 0;
+    flex: 0 0 50%; max-width: 50%;
   }
-  .map-panel-head { display: flex; justify-content: space-between; align-items: baseline; gap: .5rem; }
-  .map-panel-title { font-family: ${MONO_STACK}; font-size: .58rem; text-transform: uppercase; letter-spacing: .12em; opacity: .85; }
-  .map-panel-turn { font-size: .62rem; opacity: .7; }
-  .map-panel-board { position: relative; flex: 1; min-height: 200px; background: rgba(124,154,91,.25); border: 1px solid rgba(233,217,182,.35); border-radius: 3px; }
+  .map-panel-head { display: flex; justify-content: space-between; align-items: baseline; gap: .4rem; }
+  .map-panel-title { font-family: ${MONO_STACK}; font-size: .54rem; text-transform: uppercase; letter-spacing: .1em; opacity: .85; }
+  .map-panel-turn { font-size: .58rem; opacity: .7; }
+  .map-panel-board { position: relative; flex: 1; min-height: 110px; aspect-ratio: 1; background: rgba(124,154,91,.25); border: 1px solid rgba(233,217,182,.35); border-radius: 3px; }
   .map-dot { position: absolute; width: .55rem; height: .55rem; margin: -.28rem 0 0 -.28rem; border-radius: 50%; border: 1px solid rgba(0,0,0,.4); }
   .map-dot-predator { background: var(--square-predator); }
   .map-dot-prey { background: var(--square-prey); }
@@ -716,7 +720,6 @@ const MUDIII_STYLE = `
 
   .edit-stage { display: none; grid-template-columns: minmax(0, 1.15fr) minmax(0, 1fr); gap: 1rem; align-items: start; margin-bottom: 1rem; }
   body.editing .mudiii-chat, body.editing .scene-stage, body.editing .hud-row, body.editing .deck-row .map-panel { display: none; }
-  body.editing .deck-row { grid-template-columns: 1fr; }
   body.editing .edit-stage { display: grid; }
   #editModeBtn[aria-pressed="true"] { background: var(--square-accent); border-color: var(--square-accent); }
   .edit-text, .edit-panel {
@@ -769,10 +772,22 @@ const MUDIII_STYLE = `
   .pill.affordance[aria-pressed="true"] { background: var(--square-accent); border-style: solid; }
 
   @media (max-width: 900px) {
-    .deck-row { grid-template-columns: 1fr; }
     .edit-stage { grid-template-columns: 1fr; }
     #editorText { min-height: 16rem; }
   }
+
+  /* A landscape phone and a narrow desktop window are both under 900px but
+     want different slider/map arrangements, so the split has to key off
+     orientation as well as width. */
+  @media (max-width: 900px) and (orientation: landscape) {
+    .deck-sliders { display: grid; grid-template-columns: 1fr 1fr; gap: .4rem 1rem; }
+    .deck-body { align-items: stretch; }
+    .map-panel { flex-basis: 33%; max-width: 33%; }
+    /* The square aspect-ratio that suits a tall portrait column would blow
+       the map back up to full column width in a short landscape viewport —
+       here it follows the two-row slider stack's own height instead. */
+    .map-panel-board { aspect-ratio: auto; min-height: 90px; }
+  }
 `;
 
 /** The inlined page script, spliced the same way mud-viz.mjs's own

package/src/services/predator-prey.mjs

@@ -58,6 +58,12 @@ const PLACEMENT_PREDICATE = "mgx:currently-in";
 const MASS_PREDICATE = "mgx:hasMass";
 const MOOD_PREDICATE = "mgx:feels";
 const FACING_PREDICATE = "mgx:facing";
+// The facing a visitor's own hand turned an agent to, written only on a driven
+// turn. It folds into the same facing map as the ordinary row below, which is
+// what makes a hand turn hold while the agent stands still and lose the moment
+// the planner takes a step of its own: the step's own facing row is stamped
+// with a later turn, and a later turn outranks.
+const DRIVEN_FACING_PREDICATE = "mgx:driven-facing";
 const EATEN_BY_PREDICATE = "mgx:eaten-by";
 const STARVED_PREDICATE = "mgx:starved";
 const PLACED_BY_PREDICATE = "mgx:placed-by";
@@ -86,7 +92,7 @@ const TURN_PLAYED_PREDICATE = "mgx:turn-played";
 const BOARD_SUBJECT = "square";
 
 const MUDIII_STATE_PREDICATE_SET = new Set([
-  PLACEMENT_PREDICATE, MASS_PREDICATE, MOOD_PREDICATE, FACING_PREDICATE,
+  PLACEMENT_PREDICATE, MASS_PREDICATE, MOOD_PREDICATE, FACING_PREDICATE, DRIVEN_FACING_PREDICATE,
   EATEN_BY_PREDICATE, STARVED_PREDICATE, PLACED_BY_PREDICATE,
   MODEL_PREDICATE, ROTATION_PREDICATE, TURN_PLAYED_PREDICATE,
   CARRYING_PREDICATE, PREY_EATEN_PREDICATE, WEB_BUILT_PREDICATE,
@@ -208,6 +214,7 @@ export function foldTownSquareState(factRows) {
         if (snap && rowEpoch === epoch) tickCount = Math.max(tickCount, turn);
         break;
       case FACING_PREDICATE:
+      case DRIVEN_FACING_PREDICATE:
         if (outranks(rowEpoch, turn, facing.get(base))) facing.set(base, { value: row.object, turn, epoch: rowEpoch });
         break;
       case EATEN_BY_PREDICATE:
@@ -448,6 +455,29 @@ function stepPlan(fromCell, toCell) {
   return direction ? [direction] : [];
 }
 
+/**
+ * The hand-driven move `entry` asks of an agent standing at `fromCell`, as
+ * `{ cell, facing }` with `cell` a parsed cell — or null when nothing was
+ * asked, or when what was asked is not a legal one-step move.
+ *
+ * `entry` is a target cell id, or `{ cell, facing }` with both parts optional:
+ * no cell holds the agent where it stands, which is what a turn on the spot
+ * is, and no facing leaves the facing to the step itself.
+ *
+ * The legality table is oneStepOptions — the very list the wander, evade and
+ * chase rungs pick from — so a wall or a prop is a missing exit here too,
+ * never a second notion of blocked, and a refusal reads as "no such move"
+ * rather than as a rule this seam invented. Pure.
+ */
+function acceptedManualMove(entry, fromCell, applyActions) {
+  if (!entry) return null;
+  const request = typeof entry === "string" ? { cell: entry } : entry;
+  const facing = typeof request.facing === "string" && request.facing ? request.facing : null;
+  const target = typeof request.cell === "string" && request.cell ? request.cell : cellId(fromCell.x, fromCell.y);
+  const cell = oneStepOptions(fromCell, applyActions).find((option) => cellId(option.x, option.y) === target);
+  return cell ? { cell, facing } : null;
+}
+
 const round2 = (n) => Math.round(n * 100) / 100;
 
 // ---- the goal line and the mood word -------------------------------------------
@@ -457,8 +487,9 @@ const round2 = (n) => Math.round(n * 100) / 100;
 // is scared, anything wandering or foraging is calm, and anything that just ate
 // is happy.
 
-function goalLine(kind, { subject, cell, arrived, boardNoun = "square", catches = false } = {}) {
+function goalLine(kind, { subject, cell, arrived, boardNoun = "square", catches = false, facing = null, held = false } = {}) {
   switch (kind) {
+    case "driven": return held ? `driven by hand — holding at ${cell}, facing ${facing}.` : `driven by hand — stepping to ${cell}.`;
     case "avoid": return `avoiding ${subject}, last seen at ${cell}.`;
     case "chase":
       if (!arrived) return `chasing ${subject}, last seen at ${cell}.`;
@@ -980,11 +1011,20 @@ function itemsPayload(liveItemIds, { state, itemCellOf, roles, taken = null }) {
  * to where the predator was when it looked), while eating resolves on the
  * post-move ones (it is caught where the predator actually ends up).
  *
+ * `manualMoves` is the one place a visitor's own hand reaches the world:
+ * `{ agentId: cellId }`, or `{ agentId: { cell, facing } }`, checked before
+ * that agent's belief chain runs. A legal request moves the agent under the
+ * `driven` rung; an illegal one is refused and that agent decides for itself
+ * this turn, so a rejected press never freezes it. A driven turn spends a
+ * turn like any other: the ecology pass runs, and every other agent decides
+ * and moves in this same call.
+ *
  * Returns `{ turn, epoch, agents, items, ecology, rungs, activeWebs, writes }`.
  * `agents` and `items` and `ecology` are the frozen render payload — see
  * townSquareTickPayload, which projects exactly those three plus the turn.
- * `rungs` is the decision each live agent reached this turn ("chase", "evade",
- * "forage", "avoid", "wander", and — on a cast that carries or spins webs —
+ * `rungs` is the decision each live agent reached this turn ("driven" for a
+ * hand-driven move, then "chase", "evade", "forage", "avoid", "wander", and —
+ * on a cast that carries or spins webs —
  * "carry", "deliver", "carried", "trapped", "hold-web", "build-web"); an agent
  * that decided and then died still has a rung and no longer has an `agents`
  * entry, which is the difference between a decision and a survivor.
@@ -993,6 +1033,7 @@ function itemsPayload(liveItemIds, { state, itemCellOf, roles, taken = null }) {
  */
 export async function runTownSquareTick(memoryDir, {
   layout, toldFacts = [], config = DEFAULT_GAME_CONFIG.mudiii, roles = MUDIII_ROLES,
+  manualMoves = {},
 } = {}) {
   const lay = typeof layout === "string" ? TOWN_SQUARE_LAYOUTS[layout] : layout;
   if (!lay) throw new Error(`runTownSquareTick: no such layout "${layout}"`);
@@ -1031,6 +1072,11 @@ export async function runTownSquareTick(memoryDir, {
 
   const decide = (agentId, role) => {
     const fromCell = parseCellId(state.placements.get(agentId).cell);
+    // The visitor's hand, checked before any of the belief chain below. A
+    // refused request leaves `driven` null, and the chain then runs exactly as
+    // it would have on a turn nobody touched.
+    const driven = acceptedManualMove(manualMoves?.[agentId], fromCell, applyActions);
+    const restingFacing = state.facing.get(agentId)?.value ?? DEFAULT_FACING;
     const visionRadius = role === "predator" ? config.predatorVisionRadius : config.preyVisionRadius;
     const beliefOpts = { visionRadius, toldFacts };
     // True unless a caller explicitly turns it off. A config object built by
@@ -1045,13 +1091,14 @@ export async function runTownSquareTick(memoryDir, {
     // lookup below stays on beliefOpts either way: this switch is about food.
     const foodBeliefOpts = foodVisionGated ? beliefOpts : { ...beliefOpts, visionRadius: Infinity };
     const rivals = role === "predator" ? predators.filter((id) => id !== agentId) : predators;
-    const threat = nearestBelievedTarget(agentId, fromCell, rivals, state, beliefOpts);
+    const threat = driven ? null : nearestBelievedTarget(agentId, fromCell, rivals, state, beliefOpts);
 
     let rung;
     let nextCell;
     let plan;
     let goal;
     let mood;
+    let drivenFacing = null;
     // A carried prey and its captor both leave the ordinary chain. A carrying
     // predator never drops its catch to dodge a rival or chase a second one:
     // nothing here eats a predator, so "avoid" is contention, not survival.
@@ -1060,7 +1107,18 @@ export async function runTownSquareTick(memoryDir, {
     const captorId = (carriesPrey && role === "prey") ? (captorOfPrey.get(agentId) ?? null) : null;
     let beliefCell = fromCell;
 
-    if (isCarrying && webbedAt(fromCell)) {
+    if (driven) {
+      rung = "driven";
+      nextCell = driven.cell;
+      plan = stepPlan(fromCell, nextCell);
+      drivenFacing = driven.facing;
+      goal = goalLine("driven", {
+        cell: cellId(nextCell.x, nextCell.y),
+        facing: driven.facing ?? restingFacing,
+        held: plan.length === 0,
+      });
+      mood = "calm";
+    } else if (isCarrying && webbedAt(fromCell)) {
       // Already standing in a web: hold, so the pass's own eat gate reads this
       // same cell and resolves the delivery on this exact tick.
       rung = "deliver";
@@ -1166,7 +1224,10 @@ export async function runTownSquareTick(memoryDir, {
       const foodCandidates = beliefCandidates.filter((id) => foodIds.has(id));
       Object.assign(belief, beliefSnapshotFor(agentId, beliefCell, foodCandidates, state, foodBeliefOpts));
     }
-    const facing = plan[0] ?? state.facing.get(agentId)?.value ?? DEFAULT_FACING;
+    // A hand-picked facing beats the step it came with, which is what lets the
+    // page walk an agent backwards without spinning it round.
+    const facing = drivenFacing ?? plan[0] ?? restingFacing;
+    if (rung === "driven") movementWrites.push({ subject: stamp(agentId), predicate: DRIVEN_FACING_PREDICATE, object: facing });
     postMovePlacements.set(agentId, nextCell);
     rungs[agentId] = rung;
     agents[agentId] = { role, cell: cellId(nextCell.x, nextCell.y), facing, goal, mood, plan, mass: 0, belief };