@polycode-projects/the-mechanical-code-talker 4.1.0 → 4.1.1

package/src/services/ledger-viz.mjs

@@ -549,7 +549,7 @@ function sparkCaptionHtml(stats) {
  *  self-contained document with no external requests. Only
  *  scripts/build-demo-site.mjs, which builds the sibling bundle itself
  *  first, passes `true`. The dock's own runtime code below ALSO gates on
- *  `typeof tmctLedger !== "undefined"` regardless — the two checks answer
+ *  `typeof tmct !== "undefined"` regardless — the two checks answer
  *  different questions (did this render even offer the reference; did the
  *  browser actually manage to load it), and both must hold for the live
  *  path to run. */
@@ -564,7 +564,7 @@ export function renderLedgerHtml({ rows, terms, edges, focus, contradictions, wo
   // really in this payload, otherwise a real term from this graph. Left as
   // the query-only wording even when the live bundle is offered — the dock's
   // own script swaps it for a teach-aware placeholder the moment it confirms
-  // tmctLedger actually loaded (never claimed ahead of that confirmation).
+  // the live engine actually loaded (never claimed ahead of that confirmation).
   // The example term skips anything under 3 characters — the SAME floor the
   // dock's own miss-tips apply below — so a graph whose highest-degree term
   // is a short stopword-shaped fragment (init:large corpora carry plenty:
@@ -575,7 +575,7 @@ export function renderLedgerHtml({ rows, terms, edges, focus, contradictions, wo
     ? "who is the grandfather of ishmael"
     : (exampleTerm ? `ask the graph… e.g. what is ${exampleTerm.term}` : "ask the graph…");
   // The paste-and-drop ingest panel plus the JSONL export ride the LIVE
-  // engine (window.tmctLedger): both teach into and read the dock's own
+  // engine (window.tmct): both teach into and read the dock's own
   // session store, so they appear only where that bundle is offered — the
   // demo site, never the CLI's self-contained tmct viz page.
   const ingestHtml = ledgerBundleAvailable
@@ -888,14 +888,13 @@ ${ledgerBundleAvailable ? `<script src="./ledger-browser.bundle.js"></script>` :
   // exists it points at that session's store, which teach/research grow in
   // place, so a digest of a just-taught term reads the fresh facts.
   let getLivePayload = () => PAYLOAD;
-  // Whichever loaded bundle carries the browser digest helper — the demo
-  // ledger's own live engine (tmctLedger) or the committed memory-ask engine
-  // the CLI viz page inlines (tmctMemoryAsk). Null before either loads, and the
-  // focus card then keeps whatever server-computed digest it shipped.
+  // The browser digest helper, from whichever engine this page loaded — the
+  // demo ledger's live one or the committed query-only one the CLI viz page
+  // inlines. Both publish it in the same place now, so there is one lookup
+  // rather than two. Null before either loads, and the focus card then keeps
+  // whatever server-computed digest it shipped.
   const digestHelper = () =>
-    (typeof tmctLedger !== "undefined" && tmctLedger && tmctLedger.digestTermFromPayloadBrowser)
-    || (typeof tmctMemoryAsk !== "undefined" && tmctMemoryAsk && tmctMemoryAsk.digestTermFromPayloadBrowser)
-    || null;
+    (typeof tmct !== "undefined" && tmct.page && tmct.page.digestTermFromPayloadBrowser) || null;
   // The digest for one term, computed live in the browser from the embedded
   // structure table, or null when no structures were embedded, no engine has
   // loaded, or the term holds nothing to compose.
@@ -1138,9 +1137,9 @@ ${ledgerBundleAvailable ? `<script src="./ledger-browser.bundle.js"></script>` :
   }
 
   // ---- the chat dock: LIVE teach+ask over the sibling ledger-browser.bundle.js
-  // (window.tmctLedger) when the demo build offered it AND it actually
-  // loaded; falls back to the read-only tmctMemoryAsk engine below —
-  // unchanged from before this page could teach at all — otherwise.
+  // (window.tmct) when the demo build offered it AND it actually
+  // loaded; falls back to the read-only engine below, which publishes the
+  // same surface as a stand-in and says so through tmct.fallback.
   // bin/tmct.mjs's own \`tmct viz\` output never offers the live bundle
   // (renderLedgerHtml's own ledgerBundleAvailable defaults false there), so
   // this branch is simply never reachable on a CLI-generated page.
@@ -1148,7 +1147,7 @@ ${ledgerBundleAvailable ? `<script src="./ledger-browser.bundle.js"></script>` :
   const createTicker = ${createTicker.toString()};
   const prefersReducedMotion = ${prefersReducedMotion.toString()};
   const chatForm = el("chatform");
-  if (chatForm && typeof tmctLedger !== "undefined" && typeof tmctLedger.createLedgerSession === "function") {
+  if (chatForm && typeof tmct !== "undefined" && !tmct.fallback) {
     const log = el("chatlog");
     const chatqEl = el("chatq");
     chatqEl.placeholder = 'ask or teach the graph\\u2026 e.g. "blue is a peg"';
@@ -1183,7 +1182,7 @@ ${ledgerBundleAvailable ? `<script src="./ledger-browser.bundle.js"></script>` :
             import("./vendor/wink.js"),
             winkTimeout(WINK_LOAD_TIMEOUT_MS, "wink vendor asset load timed out"),
           ]);
-          tmctLedger.registerWinkModel(() => ({ winkNLP: mod.winkNLP, model: mod.model }));
+          tmct.page.registerWinkModel(() => ({ winkNLP: mod.winkNLP, model: mod.model }));
         } catch (err) {
           // eslint-disable-next-line no-console
           console.warn("tmct ledger: the wink vendor asset failed to load, continuing without the lemma/POS tier", err);
@@ -1196,7 +1195,7 @@ ${ledgerBundleAvailable ? `<script src="./ledger-browser.bundle.js"></script>` :
     async function ensureSession() {
       if (session) return session;
       await tryLoadWink();
-      session = await tmctLedger.createLedgerSession({ seedPayload: PAYLOAD });
+      session = await tmct.open({ seedPayload: PAYLOAD });
       // From here the live store is the source of truth for the digest, so a
       // digest of a term taught this session reads its fresh facts — the store
       // grows in place, so this one closure stays current.
@@ -1214,15 +1213,15 @@ ${ledgerBundleAvailable ? `<script src="./ledger-browser.bundle.js"></script>` :
       chatqEl.disabled = true;
       withLock(async () => {
         try {
-          const s = await ensureSession();
-          const result = await s.turn(q);
+          const live = await ensureSession();
+          const result = await tmct.turn(q);
           const record = result.record;
           const taught = !!record && record.miss === false && (record.via === "assert" || record.via === "retract");
           const body = esc(result.answer).replace(/\\n/g, "<br>");
           pending.className = "a" + (taught ? " taught" : (record && record.miss ? " miss" : ""));
           pending.innerHTML = taught ? '<span class="tag">taught</span>' + body : body;
           if (taught) {
-            const fresh = tmctLedger.computeLedgerDataFromPayload(s.memoryDir.payload, {});
+            const fresh = tmct.page.computeLedgerDataFromPayload(live.memoryDir.payload, {});
             applyLedgerData(fresh);
           } else if (!(record && record.miss)) {
             // Only a genuine answer (never a miss) tries to resolve a
@@ -1231,7 +1230,7 @@ ${ledgerBundleAvailable ? `<script src="./ledger-browser.bundle.js"></script>` :
             // ordinary English word (e.g. "run", if the graph happens to
             // hold it), and resolveAnsweredTerm has no way to tell that
             // apart from the term genuinely being discussed.
-            const hit = resolveAnsweredTerm(result.answer, q, LEDGER.terms, tmctLedger.normFactTerm);
+            const hit = resolveAnsweredTerm(result.answer, q, LEDGER.terms, tmct.page.normFactTerm);
             if (hit) refocusWithLabel(hit, q);
           }
         } catch {
@@ -1246,7 +1245,7 @@ ${ledgerBundleAvailable ? `<script src="./ledger-browser.bundle.js"></script>` :
 
     // ---- ingest + export: bring your own text, take the graph away ---------
     // The ingest panel runs pasted/dropped/browsed text through the SAME dock
-    // session, one sentence at a time (tmctLedger.splitSentences, then
+    // session, one sentence at a time (tmct.page.splitSentences, then
     // s.turn), keeping only the sentences the recognizer grounds — then
     // re-derives the whole ledger so the new facts can be examined in place.
     // Export serializes that same session store to canonical JSONL.
@@ -1282,13 +1281,13 @@ ${ledgerBundleAvailable ? `<script src="./ledger-browser.bundle.js"></script>` :
         withLock(async () => {
           try {
             const s = await ensureSession();
-            const sentences = tmctLedger.splitSentences(text);
+            const sentences = tmct.page.splitSentences(text);
             let grounded = 0;
             for (const sentence of sentences) {
-              const r = await s.turn(sentence);
+              const r = await tmct.turn(sentence);
               if (r.record && r.record.miss === false && r.record.via === "assert") grounded += 1;
             }
-            const fresh = tmctLedger.computeLedgerDataFromPayload(s.memoryDir.payload, {});
+            const fresh = tmct.page.computeLedgerDataFromPayload(s.memoryDir.payload, {});
             applyLedgerData(fresh);
             const skipped = sentences.length - grounded;
             statusEl.textContent = countLabel(sentences.length, "sentence")
@@ -1308,7 +1307,7 @@ ${ledgerBundleAvailable ? `<script src="./ledger-browser.bundle.js"></script>` :
         withLock(async () => {
           try {
             const s = await ensureSession();
-            const jsonl = await tmctLedger.exportFactsJsonl(s.memoryDir);
+            const jsonl = await tmct.page.exportFactsJsonl(s.memoryDir);
             const blob = new Blob([jsonl], { type: "application/x-ndjson" });
             const url = URL.createObjectURL(blob);
             const link = document.createElement("a");
@@ -1354,8 +1353,8 @@ ${ledgerBundleAvailable ? `<script src="./ledger-browser.bundle.js"></script>` :
         const pending = addLine("a pending", "researching\\u2026");
         return withLock(async () => {
           try {
-            const s = await ensureSession();
-            const result = await s.turn(q);
+            const live = await ensureSession();
+            const result = await tmct.turn(q);
             const missed = !result.record || Boolean(result.record.miss);
             pending.className = "a" + (missed ? " miss" : "");
             pending.innerHTML = esc(result.answer).replace(/\\n/g, "<br>");
@@ -1363,7 +1362,7 @@ ${ledgerBundleAvailable ? `<script src="./ledger-browser.bundle.js"></script>` :
               researchQueue = result.research;
               renderResearchControls();
               if (!missed) {
-                const fresh = tmctLedger.computeLedgerDataFromPayload(s.memoryDir.payload, {});
+                const fresh = tmct.page.computeLedgerDataFromPayload(live.memoryDir.payload, {});
                 applyLedgerData(fresh);
               }
             }
@@ -1406,9 +1405,11 @@ ${ledgerBundleAvailable ? `<script src="./ledger-browser.bundle.js"></script>` :
         else researchTicker.play();
       });
     }
-  } else if (chatForm && typeof tmctMemoryAsk !== "undefined") {
-    const memHandle = tmctMemoryAsk.createInMemoryStore();
-    memHandle.payload = PAYLOAD;
+  } else if (chatForm && typeof tmct !== "undefined") {
+    // The query-only dock. One session over the page's own embedded payload,
+    // and every line goes to tmct.ask — the cascade that used to be chained
+    // here by hand now lives behind that one call.
+    const opened = tmct.open({ payload: PAYLOAD });
     const log = el("chatlog");
     const addLine = (cls, html) => {
       const d = document.createElement("div");
@@ -1423,20 +1424,16 @@ ${ledgerBundleAvailable ? `<script src="./ledger-browser.bundle.js"></script>` :
       input.value = "";
       addLine("u", esc(q));
       (async () => {
-        let fact = null;
-        try { fact = await tmctMemoryAsk.factAnswer(memHandle, q, null, true, {}); } catch { fact = null; }
-        // runAsk's own cascade is factAnswer ?? factReadBack; chain the same
-        // way when the bundle exposes the second reader (relation chases —
-        // "who is the grandfather of ishmael" — live there, not in factAnswer).
-        if (!(fact && fact.text) && typeof tmctMemoryAsk.factReadBack === "function") {
-          try { fact = await tmctMemoryAsk.factReadBack(memHandle, q, null, true, null); } catch { fact = null; }
-        }
-        if (fact && fact.text) {
-          addLine("a", esc(fact.text).replace(/\\n/g, "<br>"));
+        await opened;
+        let answer = null;
+        let data = null;
+        try { ({ answer, data } = await tmct.ask(q)); } catch { answer = null; data = null; }
+        if (answer) {
+          addLine("a", esc(answer).replace(/\\n/g, "<br>"));
           // Same formatting contract as chat's withGoalLine: capitalized,
           // full-stop-terminated, rendered only when the engine deduced one.
-          if (fact.goal) addLine("a goal", "Goal (inferred): " + esc(fact.goal.charAt(0).toUpperCase() + fact.goal.slice(1)) + ".");
-          const hit = resolveAnsweredTerm(fact.text, q, LEDGER.terms, tmctMemoryAsk.normFactTerm);
+          if (data && data.goal) addLine("a goal", "Goal (inferred): " + esc(data.goal.charAt(0).toUpperCase() + data.goal.slice(1)) + ".");
+          const hit = resolveAnsweredTerm(answer, q, LEDGER.terms, tmct.page.normFactTerm);
           if (hit) refocusWithLabel(hit, q);
         } else {
           const tips = LEDGER.terms.filter((t) => t.term.length >= 3).slice(0, 2)

package/src/services/mud-viz.mjs

@@ -184,7 +184,7 @@ export function burrowGraph(state, roomIds, root = "garden") {
  *  allows that has no written exit yet. Above ground there is nothing to
  *  tunnel sideways THROUGH, so a garden digs straight down and no other way;
  *  underground, all six are open soil. The engine is the authority on this —
- *  the page prefers `tmctMud.diggableDirections` whenever the bundle exposes
+ *  the page prefers `tmct.page.diggableDirections` whenever the bundle exposes
  *  one and only falls back to the rule below. Pure, self-contained
  *  (roomKindForRoom is spliced alongside it). */
 export function diggableDirections(rows, state, here) {
@@ -1339,7 +1339,7 @@ function pageScript() {
     // world's ending sentence comes from the engine either way, never a second
     // wording of the same event.
     appendChat(character, "a", note
-      || (window.tmctMud.outOfPlayPhrase(character, fate) + ". It takes no more turns."));
+      || (window.tmct.page.outOfPlayPhrase(character, fate) + ". It takes no more turns."));
     playFateScene(character, fate);
   }
 
@@ -1372,7 +1372,7 @@ function pageScript() {
     const rows = lastSnapshot.rows;
     const state = lastSnapshot.state;
     renderRoomView(character, rows, state, den, allRoomIds(rows),
-      window.tmctMud.castInRoom(rows, state, den, character));
+      window.tmct.page.castInRoom(rows, state, den, character));
 
     const room = el(w + "-room");
     const lunger = room.querySelector('.floor-others .sprite-card[data-subject="' + predator + '"]');
@@ -1462,7 +1462,7 @@ function pageScript() {
         return { answer: "", end: false };
       });
     }
-    return serializeTick(function () { return session.windows[character].turn(line); }).then(async function (res) {
+    return serializeTick(function () { return tmct.turn(line, { as: character }); }).then(async function (res) {
       appendChat(character, "a", res.answer);
       await broadcastLocalChange();
       renderSoon();
@@ -1556,8 +1556,8 @@ function pageScript() {
   }
 
   function spriteSvgFor(species, rows, instanceKey) {
-    if (window.tmctMud && window.tmctMud.resolveSpriteAsset) {
-      return window.tmctMud.resolveSpriteAsset(species, rows, [], DATA.spriteTemplates, window.tmctMud.SPRITE_REGISTRY, { instanceKey: instanceKey });
+    if (window.tmct && window.tmct.page.resolveSpriteAsset) {
+      return window.tmct.page.resolveSpriteAsset(species, rows, [], DATA.spriteTemplates, window.tmct.page.SPRITE_REGISTRY, { instanceKey: instanceKey });
     }
     return "";
   }
@@ -1570,10 +1570,10 @@ function pageScript() {
   // "animal": everything hung on this wall is a thing, and a thing with no
   // sprite should read as a plain parcel rather than a creature.
   function objectSvgFor(subject, rows) {
-    if (window.tmctMud && window.tmctMud.resolveSpriteAsset) {
-      return window.tmctMud.resolveSpriteAsset(
+    if (window.tmct && window.tmct.page.resolveSpriteAsset) {
+      return window.tmct.page.resolveSpriteAsset(
         subject, spriteAncestryRows(rows, subject), factsForSubject(rows, subject),
-        DATA.spriteTemplates, window.tmctMud.SPRITE_REGISTRY,
+        DATA.spriteTemplates, window.tmct.page.SPRITE_REGISTRY,
         { rootFallback: "portable", instanceKey: subject },
       );
     }
@@ -1736,7 +1736,7 @@ function pageScript() {
   // than the pane offers to talk to.
   function roomCaptionFor(rows, state, here, character, roomMates) {
     const parts = [];
-    const view = window.tmctMud.worldDigestRows(rows, state, character);
+    const view = window.tmct.page.worldDigestRows(rows, state, character);
     const lines = view.filter(function (r) { return r.subject.toLowerCase() === here.toLowerCase(); })
       .map(function (r) { return r.subject + " " + r.predicate + " " + r.object + "."; });
     parts.push(lines.length ? lines.join(" ") : "You are in the " + here + ".");
@@ -1755,7 +1755,7 @@ function pageScript() {
   // direction with neither draws nothing, so the ring never offers a command
   // the world would refuse.
   function diggableFor(rows, state, here) {
-    const fromEngine = window.tmctMud && window.tmctMud.diggableDirections;
+    const fromEngine = window.tmct && window.tmct.page.diggableDirections;
     return fromEngine ? fromEngine(rows, state, here) : diggableDirections(rows, state, here);
   }
 
@@ -1782,7 +1782,7 @@ function pageScript() {
   // it. Exits appear in both the row and the compass ring on purpose: the ring
   // says WHERE a way out points, the row says what it is called.
   function affordancesFor(rows, state, here, character) {
-    const fromEngine = window.tmctMud && window.tmctMud.roomAffordances;
+    const fromEngine = window.tmct && window.tmct.page.roomAffordances;
     return fromEngine ? fromEngine(rows, state, here, character) : [];
   }
 
@@ -1838,7 +1838,7 @@ function pageScript() {
   // can say "carrot" while every verb still resolves the distinct id
   // ("carrot-1"). itemLabel is the fallback for an id carrying no such fact.
   function labelForItem(rows, subject, roomIds) {
-    const fromEngine = window.tmctMud && window.tmctMud.displayNameOf;
+    const fromEngine = window.tmct && window.tmct.page.displayNameOf;
     const name = fromEngine ? fromEngine(rows, subject) : null;
     return name && name !== subject ? name : itemLabel(subject, roomIds);
   }
@@ -1878,7 +1878,7 @@ function pageScript() {
     // the survey they annotate, and each one's own dot already carries its name.
     const keys = cast.map(function (c) {
       const room = state.placements.get(c) ? state.placements.get(c).object : "?";
-      const fate = window.tmctMud.outOfPlayReasonOf(state, c);
+      const fate = window.tmct.page.outOfPlayReasonOf(state, c);
       const where = fate ? fate : "in " + esc(room);
       return '<span class="key-actor"><span class="key-dot" style="background:' + colorFor(c) + '"></span>'
         + esc(speciesOfCharacter(c)) + " " + where + "</span>";
@@ -1939,7 +1939,7 @@ function pageScript() {
       }
     }
     for (const character of everyone()) {
-      const reason = window.tmctMud.outOfPlayReasonOf(snap.state, character);
+      const reason = window.tmct.page.outOfPlayReasonOf(snap.state, character);
       if (reason) markOutOfPlay(character, reason, null);
     }
     renderWorldMap(snap.rows, snap.state, roomIds);
@@ -1954,7 +1954,7 @@ function pageScript() {
       const place = snap.state.placements.get(character);
       const here = place ? place.object : null;
       if (!here) continue;
-      const roomMates = window.tmctMud.castInRoom(snap.rows, snap.state, here, character);
+      const roomMates = window.tmct.page.castInRoom(snap.rows, snap.state, here, character);
       renderRoomView(character, snap.rows, snap.state, here, roomIds, roomMates);
       renderDirections(character, snap.rows, snap.state, here);
       renderChatPills(character, snap.rows, snap.state, here, roomIds);
@@ -2072,9 +2072,9 @@ function pageScript() {
   function renderSuggestionPills() {
     const box = el("editorPills");
     const term = wordBeforeCursor(el("editorText").value, el("editorText").selectionStart);
-    if (!term || !window.tmctMud) { box.innerHTML = ""; return; }
-    const related = window.tmctMud.relatedForTerm ? window.tmctMud.relatedForTerm(allStoreRows, term) : null;
-    const chain = window.tmctMud.classAncestorChain ? window.tmctMud.classAncestorChain(term, allStoreRows) : [];
+    if (!term || !window.tmct) { box.innerHTML = ""; return; }
+    const related = window.tmct.page.relatedForTerm ? window.tmct.page.relatedForTerm(allStoreRows, term) : null;
+    const chain = window.tmct.page.classAncestorChain ? window.tmct.page.classAncestorChain(term, allStoreRows) : [];
     const seen = { };
     seen[term] = true;
     const out = [];
@@ -2113,7 +2113,7 @@ function pageScript() {
     const snap = await session.snapshot();
     allStoreRows = snap.rows;
     editRows = worldOnlyRows(snap.rows);
-    editState = window.tmctMud.foldWorldState(window.tmctMud.worldActionRows(editRows));
+    editState = window.tmct.page.foldWorldState(window.tmct.page.worldActionRows(editRows));
     if (result.unrecognized.length) {
       const lines = result.unrecognized.map(function (u) { return u.line; }).join(", ");
       status.className = "edit-status pending";
@@ -2169,7 +2169,7 @@ function pageScript() {
     const snap = await session.snapshot();
     allStoreRows = snap.rows;
     editRows = worldOnlyRows(snap.rows);
-    editState = window.tmctMud.foldWorldState(window.tmctMud.worldActionRows(editRows));
+    editState = window.tmct.page.foldWorldState(window.tmct.page.worldActionRows(editRows));
     el("editorText").value = renderMudEditorText(editRows, editState);
     el("editorStatus").className = "edit-status";
     el("editorStatus").textContent = "";
@@ -2249,8 +2249,8 @@ function pageScript() {
     // engine calls live world state, plus the P2P layer's own four predicates.
     // The check is handed over rather than imported, so the sync filter never
     // learns the world engine's private predicate names.
-    const extraPredicates = (window.tmctMud.P2P_PREDICATES || []).slice();
-    const isState = window.tmctMud.isMudStatePredicate;
+    const extraPredicates = (window.tmct.page.P2P_PREDICATES || []).slice();
+    const isState = window.tmct.page.isMudStatePredicate;
     room = mod.createP2pRoom({
       memoryDir: session.memoryDir,
       myPeerId: myPeerId,
@@ -2803,15 +2803,21 @@ function pageScript() {
     // so the roster belongs to the scenario rather than to the page.
     roster = rosterOf(scenario());
     rootRoom = rootRoomOf(scenario());
-    cast = window.tmctMud.pickMudRoster(roster, { count: chosenPlayerCount() });
-    const pool = window.tmctMud.expandMudRoster(roster, cast.length + npcCount)
+    cast = window.tmct.page.pickMudRoster(roster, { count: chosenPlayerCount() });
+    const pool = window.tmct.page.expandMudRoster(roster, cast.length + npcCount)
       .filter(function (id) { return cast.indexOf(id) === -1; });
-    npcs = window.tmctMud.pickMudRoster(pool, { count: npcCount });
+    npcs = window.tmct.page.pickMudRoster(pool, { count: npcCount });
     slots = DATA.paneSlots.slice(0, cast.length);
     showPlayerCount(cast.length);
     showNpcCount(npcs.length);
     renderStage();
-    const opened = await window.tmctMud.createMudSession(scenario().worldPayload, { characters: everyone(), epoch: nextEpoch });
+    // slotOf has to match cast from the same synchronous stretch that just
+    // rebuilt the DOM for it \\u2014 a render triggered anywhere in the awaits
+    // below (rebind's own re-sync can trigger one) must never see this
+    // scenario's cast paired with the LAST scenario's pane ids, which is what
+    // a null pane-element lookup in renderAll means when it happens.
+    for (let i = 0; i < cast.length; i += 1) slotOf[cast[i]] = slots[i];
+    const opened = await window.tmct.open(scenario().worldPayload, { characters: everyone(), epoch: nextEpoch });
     if (seq !== bootSeq) return;
     session = opened;
     if (liveRoom) {
@@ -2828,7 +2834,6 @@ function pageScript() {
         dropRoom("the link didn't survive the recast \\u2014 share again to link up.");
       }
     }
-    for (let i = 0; i < cast.length; i += 1) slotOf[cast[i]] = slots[i];
     bindPanes();
     for (const character of cast) {
       const w = paneIdFor(character);

package/src/services/plan-viz.mjs

@@ -665,7 +665,7 @@ const PLAN = ${embedded};
   mountPlan(PLAN);
 
   // ---- live re-solve: disk-count/max-depth controls + the chat-assert dock
-  // over the sibling plan-browser.bundle.js (window.tmctPlan). Degrades
+  // over the sibling plan-browser.bundle.js (window.tmct). Degrades
   // honestly when the bundle failed to load or wasn't built alongside this
   // page (e.g. a plain renderPlanHtml() call with no bundle nearby) — the
   // baked-in replay above already stands on its own either way.
@@ -678,7 +678,7 @@ const PLAN = ${embedded};
   const chatqEl = document.getElementById("chatq");
   const chatpillsEl = document.getElementById("chatpills");
 
-  const liveAvailable = typeof tmctPlan !== "undefined" && typeof tmctPlan.createPlanSession === "function";
+  const liveAvailable = typeof tmct !== "undefined" && typeof tmct.open === "function";
   if (!liveAvailable) {
     liveStatusEl.textContent = "live re-solve unavailable here — showing the baked-in replay only.";
     liveStatusEl.classList.add("isError");
@@ -712,7 +712,7 @@ const PLAN = ${embedded};
             import("./vendor/wink.js"),
             winkTimeout(WINK_LOAD_TIMEOUT_MS, "wink vendor asset load timed out"),
           ]);
-          tmctPlan.registerWinkModel(() => ({ winkNLP: mod.winkNLP, model: mod.model }));
+          tmct.page.registerWinkModel(() => ({ winkNLP: mod.winkNLP, model: mod.model }));
         } catch (err) {
           // eslint-disable-next-line no-console
           console.warn("tmct plan: the wink vendor asset failed to load, continuing without the lemma/POS tier", err);
@@ -729,9 +729,9 @@ const PLAN = ${embedded};
     }
     function applyPlan(freshPlan) {
       if (!freshPlan) return;
-      const { rendersAs, sizeOrder } = tmctPlan.renderInputsFromPlan(freshPlan);
-      mountPlan(tmctPlan.planToPageData({ plan: freshPlan, rendersAs, sizeOrder }));
-      if (pddlEl) pddlEl.textContent = tmctPlan.planToPddl(freshPlan);
+      const { rendersAs, sizeOrder } = tmct.page.renderInputsFromPlan(freshPlan);
+      mountPlan(tmct.page.planToPageData({ plan: freshPlan, rendersAs, sizeOrder }));
+      if (pddlEl) pddlEl.textContent = tmct.page.planToPddl(freshPlan);
       // The <title>/<h1> were baked from the INITIAL plan's own goal text —
       // a live re-solve toward a different goal (a fresh puzzle, or a
       // taught goal revision) must not leave them stating the old one.
@@ -742,7 +742,7 @@ const PLAN = ${embedded};
     async function ensureSession() {
       if (session) return session;
       await tryLoadWink();
-      session = await tmctPlan.createPlanSession({
+      session = await tmct.open({
         diskCount: Math.max(1, Math.min(7, parseInt(diskCountEl.value, 10) || 3)),
         maxDepth: Math.max(1, parseInt(maxDepthEl.value, 10) || 300),
       });
@@ -757,7 +757,7 @@ const PLAN = ${embedded};
       liveStatusEl.textContent = "solving a " + n + "-disk puzzle…";
       liveStatusEl.classList.remove("isError");
       await tryLoadWink();
-      session = await tmctPlan.createPlanSession({ diskCount: n, maxDepth: d });
+      session = await tmct.open({ diskCount: n, maxDepth: d });
       if (session.plan) {
         applyPlan(session.plan);
         liveStatusEl.textContent = "live — " + countLabel(n, "disk", "disks") + ", max depth " + d + ".";
@@ -777,7 +777,7 @@ const PLAN = ${embedded};
       withLock(async () => {
         const s = await ensureSession();
         const maxDepth = Math.max(1, parseInt(maxDepthEl.value, 10) || 300);
-        const result = await s.turn(q, { maxDepth });
+        const result = await tmct.turn(q, { maxDepth });
         addChatLine("a", result.answer);
         if (result.plan) applyPlan(result.plan);
       });

package/src/services/research-viz.mjs

@@ -2,7 +2,7 @@
 // document shaped exactly like ingest-viz.mjs/chat-page-viz.mjs's own
 // page-builders — one inlined <style> importing viz-theme.mjs's shared tokens,
 // behaviour as an inlined IIFE — running the research engine
-// (research-browser.bundle.js's globalThis.tmctResearch) by same-origin
+// (research-browser.bundle.js's globalThis.tmct) by same-origin
 // relative paths.
 //
 // One in-memory graph grows three ways, each visible on the page:
@@ -392,7 +392,7 @@ ${DASH_DARK_CHROME_CSS}
     if (progressActive) statEngineEl.textContent = loadProgressLine(Object.values(progressParts));
   }
 
-  const loadWink = loadWinkVendor({ register: (factory) => window.tmctResearch.registerWinkModel(factory) });
+  const loadWink = loadWinkVendor({ register: (factory) => window.tmct.page.registerWinkModel(factory) });
 
   let seedPayload = null;
   let seedFacts = 0;
@@ -406,8 +406,8 @@ ${DASH_DARK_CHROME_CSS}
       console.warn("tmct research: chat-seed.json unavailable — starting unseeded", err);
     }
   }
-  function newSession() {
-    return window.tmctResearch.createResearchSession({ seedPayload: cloneMemoryPayload(seedPayload), vocabSeeded: Boolean(seedPayload), digestStructures: DIGEST_STRUCTURES });
+  async function newSession() {
+    return window.tmct.open({ seedPayload: cloneMemoryPayload(seedPayload), vocabSeeded: Boolean(seedPayload), digestStructures: DIGEST_STRUCTURES });
   }
 
   // The curated reference pack provider, same fetch seam chat.html registers,
@@ -432,7 +432,7 @@ ${DASH_DARK_CHROME_CSS}
   };
 
   async function boot() {
-    if (!window.tmctResearch) {
+    if (!window.tmct) {
       engineNoteEl.hidden = false;
       engineNoteEl.textContent = "The research engine did not load. Run npm run demo:build, then reload this page.";
       statSeedEl.textContent = "—";
@@ -441,8 +441,8 @@ ${DASH_DARK_CHROME_CSS}
     }
     const [winkStatus] = await Promise.all([loadWink(), fetchSeed()]);
     progressActive = false;
-    window.tmctResearch.registerReferencePackProvider(fetchPackProvider);
-    session = newSession();
+    window.tmct.page.registerReferencePackProvider(fetchPackProvider);
+    session = await newSession();
     const winkPart = winkStatus === "loaded" ? "wink-nlp loaded" : "wink-nlp unavailable, curated tiers only";
     statSeedEl.textContent = seedPayload ? seedFacts.toLocaleString() + " facts" : "no seed";
     statEngineEl.textContent = winkPart + " · ready";
@@ -465,7 +465,7 @@ ${DASH_DARK_CHROME_CSS}
   async function refresh() {
     if (!session) return;
     let snap;
-    try { snap = await window.tmctResearch.researchSnapshot(session.memoryDir, session.sessionIds); }
+    try { snap = await window.tmct.page.researchSnapshot(session.memoryDir, session.sessionIds); }
     catch (err) { console.warn("tmct research: snapshot failed", err); return; }
     const total = (snap.sources || []).reduce((sum, source) => sum + (Number(source.count) || 0), 0);
     statFactsEl.textContent = total.toLocaleString();
@@ -626,15 +626,15 @@ ${DASH_DARK_CHROME_CSS}
     answerEl.className = "";
     answerEl.textContent = "thinking…";
     let res;
-    try { res = await session.ask(q, { sources: allChecked ? null : checked }); }
-    catch (err) { res = { text: "", miss: true }; }
-    if (res.miss || !res.text) {
+    try { res = await tmct.ask(q, { sources: allChecked ? null : checked }); }
+    catch (err) { res = { answer: "", miss: true }; }
+    if (res.miss || !res.answer) {
       answerEl.className = "miss";
       const scope = allChecked ? "any checked source" : "the " + checked.length + " checked source" + (checked.length === 1 ? "" : "s");
       answerEl.textContent = "No grounded answer from " + scope + ". It abstains rather than guess.";
     } else {
       answerEl.className = "";
-      answerEl.textContent = res.text;
+      answerEl.textContent = res.answer;
     }
   }
   el("askGo").addEventListener("click", ask);
@@ -705,7 +705,7 @@ ${DASH_DARK_CHROME_CSS}
     const note = el("teachNote");
     note.textContent = "…";
     let res;
-    try { res = await session.turn(q); } catch { res = null; }
+    try { res = await tmct.turn(q); } catch { res = null; }
     if (res && res.record && res.record.via === "assert" && !res.record.miss) {
       note.textContent = "stored: " + (res.answer || "remembered.");
       el("teachInput").value = "";
@@ -786,7 +786,7 @@ ${DASH_DARK_CHROME_CSS}
   async function researchStep(line) {
     if (!session) return;
     let res;
-    try { res = await session.turn(line); } catch { res = null; }
+    try { res = await tmct.turn(line); } catch { res = null; }
     if (res && res.research !== undefined) {
       researchQueue = res.research;
       renderResearchControls();
@@ -817,9 +817,9 @@ ${DASH_DARK_CHROME_CSS}
 
   // ---- tools --------------------------------------------------------------
   el("exportFacts").addEventListener("click", async () => {
-    if (!session || !window.tmctResearch.exportFactsJsonl) return;
+    if (!session || !window.tmct.page.exportFactsJsonl) return;
     let jsonl;
-    try { jsonl = await window.tmctResearch.exportFactsJsonl(session.memoryDir); }
+    try { jsonl = await window.tmct.page.exportFactsJsonl(session.memoryDir); }
     catch { return; }
     const blob = new Blob([jsonl], { type: "application/x-ndjson" });
     const url = URL.createObjectURL(blob);
@@ -832,7 +832,7 @@ ${DASH_DARK_CHROME_CSS}
     researchTicker.pause();
     researchQueue = null;
     checkedSources.clear();
-    session = newSession();
+    session = await newSession();
     el("teachNote").textContent = "";
     el("ingestNote").textContent = "";
     el("researchNote").textContent = "";