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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polycode-projects/the-mechanical-code-talker",
-  "version": "4.1.0",
+  "version": "4.1.1",
   "private": false,
   "type": "module",
   "description": "The Mechanical Code Talker (tmct) — a tolerant, offline, $0 chat surface that guides you toward precision queries about a software repository. ELIZA/PARRY-style but domain-obsessed with code. No model calls; indexes a repo on request (tmct index) or reads any producer's graph.",

package/src/domain/sprite-request.mjs

@@ -10,7 +10,7 @@
 // spider-fly-viz.mjs's threadCellsForSpiderPlan takes its grid geometry as an
 // argument: a function with no module-scope references survives `.toString()`
 // splicing into a page script, and the browser already holds its own copies of
-// those primitives on window.tmctSpiderFly.
+// those primitives on window.tmct.
 //
 // The resolution CHAIN is derived by OBSERVATION, never by re-implementing
 // sprite-templates.mjs's specificity order. At each term of the ancestor chain

package/src/services/adventure-viz.mjs

@@ -42,17 +42,17 @@
 //
 // Four further pure helpers are exported for testing but NOT spliced,
 // because each calls another module's export — the in-page script instead
-// reaches through the browser bundle's own `tmctAdventure` global (mirroring
-// how the inline script calls `tmctSpiderFly.*` rather than re-importing
+// reaches through the browser bundle's own `tmct` surface (mirroring
+// how the spider-fly page's inline script calls it rather than re-importing
 // spider-fly-world.mjs): `roomCaptionText` (calls `worldDigestRows`; the
-// in-page `captionFor` mirrors it against `tmctAdventure.worldDigestRows`),
+// in-page `captionFor` mirrors it against `tmct.page.worldDigestRows`),
 // `pillsForRoom` (a thin wrapper over adventure.mjs's own exported
 // `roomAffordances`, whose header explains why its list can never promise an
 // action one of take/open/talk/examine would then refuse; the in-page
-// `pillsFor` mirrors it against `tmctAdventure.roomAffordances`),
+// `pillsFor` mirrors it against `tmct.page.roomAffordances`),
 // `goalStatusLines` (calls `foldWorldState` and adventure-autoplay.mjs's own
 // `exposedFacts`; the in-page `goalStatusLinesFor` mirrors both against the
-// `tmctAdventure` global too), and `visitedRoomGraph` (a directions-only
+// `tmct` surface too), and `visitedRoomGraph` (a directions-only
 // layout of the rooms a session has actually visited, now a thin wrapper over
 // viz-room-graph.mjs's shared `directedGridLayout` — mud-viz.mjs's own
 // burrowGraph wrote the same BFS-grid layout a second time under its own
@@ -60,7 +60,7 @@
 // header for the algorithm and what `hints`/disconnected components mean).
 // The in-page script never splices `directedGridLayout`/`roomGraphSvg`
 // either, for the same not-self-contained reason: it calls
-// `tmctAdventure.directedGridLayout`/`tmctAdventure.roomGraphSvg` straight
+// `tmct.page.directedGridLayout`/`tmct.page.roomGraphSvg` straight
 // through the bundle instead of re-implementing the room map a second time.
 //
 // The chat dock (chatlog/chatform/chatq/pills, below) mirrors
@@ -479,8 +479,8 @@ export function groundedPlaceholder(actions, fallback) {
  *  row. `[]` on an honest miss (neither lookup returns anything) — never a
  *  fabricated suggestion. NOT .toString()-splice-safe (it calls two other
  *  modules' exports) — the in-page script mirrors this same combination
- *  against the browser bundle's own `tmctAdventure.relatedForTerm`/
- *  `tmctAdventure.classAncestorChain`, the same reach-through-the-global
+ *  against the browser bundle's own `tmct.page.relatedForTerm`/
+ *  `tmct.page.classAncestorChain`, the same reach-through-the-global
  *  pattern `pillsFor`/`captionFor` already use for their own adventure.mjs
  *  calls (see this module's header). */
 export function suggestionsForTerm(rows, term) {
@@ -1199,7 +1199,7 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   let allStoreRows = [];
 
   // ---- persistence — the manor remembers your visit, on this device -------
-  // Best-effort IndexedDB (tmctAdventure.openPersistedStore): after any
+  // Best-effort IndexedDB (tmct.page.openPersistedStore): after any
   // state-changing redraw, the whole Backend-B payload plus the visited-room
   // exposure set snapshots under the "adventure" key, debounced. Restored on
   // boot; reset clears it and starts the world over. The home page's preview
@@ -1297,22 +1297,22 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
 
   function captionFor(rows, state, here) {
     const hereCased = here.charAt(0).toUpperCase() + here.slice(1);
-    const lines = tmctAdventure.worldDigestRows(rows, state)
+    const lines = tmct.page.worldDigestRows(rows, state)
       .filter((row) => row.subject !== "Player" && (row.object === here || row.subject === hereCased))
       .map((row) => row.subject + " " + row.predicate + " " + row.object + ".");
     return lines.length ? lines.join(" ") : "Nothing more about the " + here + " is written down yet.";
   }
 
   // ---- goal status — mirrors adventure-viz.mjs's own goalStatusLines
-  // against tmctAdventure.foldWorldState/tmctAdventure.exposedFacts (the
+  // against tmct.page.foldWorldState/tmct.page.exposedFacts (the
   // same mirroring captionFor/pillsFor already do against their own
   // adventure.mjs exports), so a location is never claimed before the room
   // holding it has actually been visited this session.
   function goalStatusLinesFor(rows, state, visitedRoomIds) {
     const ids = Array.from(new Set(rows.filter((r) => r.predicate === "mgx:is-objective" && r.object === "true").map((r) => r.subject)));
     const carriedIds = new Set(carriedItems(rows, state, ACTING_SUBJECT).map((o) => o.subject));
-    const exposedRows = tmctAdventure.exposedFacts(rows, visitedRoomIds);
-    const exposedState = tmctAdventure.foldWorldState(exposedRows);
+    const exposedRows = tmct.page.exposedFacts(rows, visitedRoomIds);
+    const exposedState = tmct.page.foldWorldState(exposedRows);
     return ids.map((id) => {
       if (carriedIds.has(id)) return { subject: id, status: "carried", text: "carrying the " + id + " \\u2014 the adventure is won." };
       const room = visibleRoomOf(exposedRows, exposedState, id, ACTING_SUBJECT);
@@ -1340,21 +1340,21 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   // cursor per node; play mode's own map stays purely informational.
   // roomGraphSvgFor mirrors the OLD inline roomMapSvg's own board-game sizing
   // (a 64px square cell, 56x26px room footprints) through the shared
-  // viz-room-graph.mjs renderer, reached via the tmctAdventure global the
+  // viz-room-graph.mjs renderer, reached via the tmct surface the
   // same way captionFor/pillsFor already reach their own adventure.mjs
   // calls: roomGraphSvg needs escapeHtml and a module-level exit-delta table
   // this splice-safe script carries neither of, so it runs through the
   // bundle rather than being spliced as text (see this page's own module
   // header). visitedRoomGraphFor is the same posture for the layout half.
   function roomGraphSvgFor(graph, clickable) {
-    return tmctAdventure.roomGraphSvg(graph, {
+    return tmct.page.roomGraphSvg(graph, {
       cellX: 64, cellY: 64, roomW: 56, roomH: 26,
       clickable, selectedRoomId,
       label: clickable ? "the whole manor \\u2014 click a room to inspect it" : "the rooms visited so far",
     });
   }
   function visitedRoomGraphFor(state, visitedIds) {
-    return tmctAdventure.directedGridLayout(state, visitedIds, { actingSubject: ACTING_SUBJECT });
+    return tmct.page.directedGridLayout(state, visitedIds, { actingSubject: ACTING_SUBJECT });
   }
   function renderRoomMap(rows, state, visitedRoomIds) {
     mapWrapEl.innerHTML = roomGraphSvgFor(visitedRoomGraphFor(state, visitedRoomIds), false) || '<span class="empty-note">nowhere yet</span>';
@@ -1417,7 +1417,7 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
     addChatLine("u", esc(line));
     addObjDockLine("u", esc(line));
     return withLock(async () => {
-      const result = await session.turn(line);
+      const result = await tmct.turn(line);
       addChatLine("a", esc(result.answer).replace(/\\n/g, "<br>"));
       addObjDockLine("a", esc(result.answer).replace(/\\n/g, "<br>"));
       const snap = await session.snapshot();
@@ -1442,7 +1442,7 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
     // nothing, so it needs no main-transcript echo — it IS the board's own
     // content); pill/typed turns below do echo, since they can change state.
     await withLock(async () => {
-      const result = await session.turn("look " + subject);
+      const result = await tmct.turn("look " + subject);
       objLookEl.textContent = result.answer;
     });
   }
@@ -1505,8 +1505,8 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
 
   // ---- contextual pills — refreshed every redraw from the CURRENT room's
   // own roomAffordances-derived list (mirroring pillsForRoom against
-  // tmctAdventure.roomAffordances, the same way captionFor above mirrors
-  // roomCaptionText against tmctAdventure.worldDigestRows), so a pill for a
+  // tmct.page.roomAffordances, the same way captionFor above mirrors
+  // roomCaptionText against tmct.page.worldDigestRows), so a pill for a
   // room the player has left, or an object already taken, never lingers.
   // Clicking one inserts its exact command text into the input and focuses
   // it; it never auto-submits, so free typing still works and a clicked
@@ -1517,7 +1517,7 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   // ever wants to edit before running, and drawing it in both places would
   // make one control a suggestion and its twin an action.
   function pillsFor(rows, state, here) {
-    return tmctAdventure.roomAffordances(rows, state, here);
+    return tmct.page.roomAffordances(rows, state, here);
   }
   function renderPills(rows, state, here) {
     const actions = pillsFor(rows, state, here).filter((a) => a.indexOf("go ") !== 0);
@@ -1560,10 +1560,10 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   const ROOT_FALLBACK_BY_CLASS = { adventurer: "person", person: "person", room: "room" };
   const rootFallbackFor = (cls) => ROOT_FALLBACK_BY_CLASS[cls] || "portable";
   function resolveObjectSprite(rows, s) {
-    if (s.subject === "you") return tmctAdventure.resolveSpriteAsset("adventurer", [], [], activeSpriteTemplates, tmctAdventure.SPRITE_REGISTRY, { rootFallback: "person", instanceKey: "you" });
-    return tmctAdventure.resolveSpriteAsset(
+    if (s.subject === "you") return tmct.page.resolveSpriteAsset("adventurer", [], [], activeSpriteTemplates, tmct.page.SPRITE_REGISTRY, { rootFallback: "person", instanceKey: "you" });
+    return tmct.page.resolveSpriteAsset(
       s.subject, spriteAncestryRows(rows, s.subject), factsForSubject(rows, s.subject),
-      activeSpriteTemplates, tmctAdventure.SPRITE_REGISTRY,
+      activeSpriteTemplates, tmct.page.SPRITE_REGISTRY,
       { rootFallback: rootFallbackFor(s.spriteClass), instanceKey: s.subject },
     );
   }
@@ -1574,9 +1574,9 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   // everything else falls back through room's own ancestor chain to the
   // generic room icon.
   function roomKindIconSvg(rows, here) {
-    return tmctAdventure.resolveSpriteAsset(
+    return tmct.page.resolveSpriteAsset(
       here, spriteAncestryRows(rows, here), factsForSubject(rows, here),
-      activeSpriteTemplates, tmctAdventure.SPRITE_REGISTRY,
+      activeSpriteTemplates, tmct.page.SPRITE_REGISTRY,
       { rootFallback: "room", instanceKey: "roomkind-" + here },
     );
   }
@@ -1641,7 +1641,7 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
     ticker.pause();
     addChatLine("u", esc(line));
     return withLock(async () => {
-      const result = await session.turn(line);
+      const result = await tmct.turn(line);
       addChatLine("a", esc(result.answer).replace(/\\n/g, "<br>"));
       const snap = await session.snapshot();
       redraw(snap);
@@ -1703,9 +1703,9 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
     const classes = new Set(["adventurer"]);
     subjects.forEach((s) => { if (s !== ACTING_SUBJECT) classes.add(spriteClassForObject(rows, s)); });
     legendListEl.innerHTML = Array.from(classes).sort().map((cls) => {
-      const svg = tmctAdventure.resolveSpriteAsset(
+      const svg = tmct.page.resolveSpriteAsset(
         cls, spriteAncestryRows(rows, cls), factsForSubject(rows, cls),
-        activeSpriteTemplates, tmctAdventure.SPRITE_REGISTRY,
+        activeSpriteTemplates, tmct.page.SPRITE_REGISTRY,
         { rootFallback: rootFallbackFor(cls), instanceKey: "legend-" + cls },
       );
       return spriteCardHtml(cls, cls, svg);
@@ -1724,8 +1724,8 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   }
 
   // ---- cursor-driven suggestion pills — the lateral SKOS neighbourhood
-  // (tmctAdventure.relatedForTerm) plus the vertical is-a ancestor chain
-  // (tmctAdventure.classAncestorChain), mirroring adventure-viz.mjs's own
+  // (tmct.page.relatedForTerm) plus the vertical is-a ancestor chain
+  // (tmct.page.classAncestorChain), mirroring adventure-viz.mjs's own
   // suggestionsForTerm against the browser bundle's global (the same
   // reach-through-the-global pattern captionFor/pillsFor already use).
   // Reads the FULL store (allStoreRows), not worldOnlyRows — a term's
@@ -1734,8 +1734,8 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   function renderSuggestionPills() {
     const term = wordBeforeCursor(editorTextEl.value, editorTextEl.selectionStart);
     if (!term) { editorPillsEl.innerHTML = ""; return; }
-    const related = tmctAdventure.relatedForTerm(allStoreRows, term);
-    const chain = tmctAdventure.classAncestorChain(term, allStoreRows);
+    const related = tmct.page.relatedForTerm(allStoreRows, term);
+    const chain = tmct.page.classAncestorChain(term, allStoreRows);
     const seen = new Set([term]);
     const out = [];
     const push = (label) => { if (label && !seen.has(label)) { seen.add(label); out.push(label); } };
@@ -1766,7 +1766,7 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
     const snap = await session.snapshot();
     allStoreRows = snap.rows;
     editRows = worldOnlyRows(snap.rows);
-    editState = tmctAdventure.foldWorldState(editRows);
+    editState = tmct.page.foldWorldState(editRows);
     if (result.unrecognized.length) {
       const lines = result.unrecognized.map((u) => u.line).join(", ");
       editorStatusEl.className = "edit-status pending";
@@ -1797,7 +1797,7 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
     const snap = await session.snapshot();
     allStoreRows = snap.rows;
     editRows = worldOnlyRows(snap.rows);
-    editState = tmctAdventure.foldWorldState(editRows);
+    editState = tmct.page.foldWorldState(editRows);
     editorTextEl.value = renderWorldEditorText(editRows, editState);
     editorStatusEl.className = "edit-status";
     editorStatusEl.textContent = "";
@@ -1818,7 +1818,7 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
 
   async function boot({ fresh = false } = {}) {
     const saved = !fresh && persist ? await persist.load() : null;
-    session = await tmctAdventure.createAdventureSession(
+    session = await tmct.open(
       world(),
       saved && saved.payload && saved.payload.memoryPayload
         ? { restoredPayload: saved.payload.memoryPayload, restoredVisitedRoomIds: saved.payload.visitedRoomIds }
@@ -1877,9 +1877,9 @@ ${engineBundleJs ? `<script>\n${embedScriptText(engineBundleJs)}\n</script>` : `
   // to. Without that, one world's snapshot would restore into another's graph.
   let siteVersion = "";
   async function openPersistFor(worldName) {
-    if (preview || !tmctAdventure.openPersistedStore) return;
+    if (preview || !tmct.page.openPersistedStore) return;
     if (!siteVersion) siteVersion = await fetchSiteVersion();
-    persist = tmctAdventure.openPersistedStore({ storeKey: "adventure", stamp: siteVersion + ":" + worldName });
+    persist = tmct.page.openPersistedStore({ storeKey: "adventure", stamp: siteVersion + ":" + worldName });
   }
 
   if (scenarioSelectEl) {

package/src/services/chat-page-viz.mjs

@@ -2,7 +2,7 @@
 // document shaped exactly like spider-fly-viz.mjs/adventure-viz.mjs's own
 // page-builders — one inlined <style> importing viz-theme.mjs's shared
 // tokens, behaviour as an inlined IIFE — running the full chat engine
-// (chat-browser.bundle.js's globalThis.tmctChat, chat-seed.json,
+// (chat-browser.bundle.js's globalThis.tmct, chat-seed.json,
 // public/reference-pack/) by same-origin relative paths. The same
 // relationship spider-fly-viz.mjs's own inlined chat dock has with
 // createSpiderFlySession: both call the shared session.turn(line), neither
@@ -539,7 +539,7 @@ ${THEME_TOKENS_CSS}
 
   /* the provenance stats panel: what this session's memory holds, docked to
      the right of the chat column (a real layout column, not an overlay) —
-     re-rendered after boot and after every turn from window.tmctChat's own
+     re-rendered after boot and after every turn from window.tmct's own
      memoryStats(), never a second provenance computation. */
   .statsPanel { flex: 0 0 300px; max-width: 300px; overflow-y: auto; border-left: 1px solid var(--line); padding: 1.1rem 1.2rem 1.6rem; font-family: ${MONO_STACK}; font-size: .74rem; line-height: 1.55; }
   .statsPanel h2 { font-size: .66rem; letter-spacing: .07em; text-transform: uppercase; color: var(--muted); margin: 1.3rem 0 .5rem; }
@@ -554,7 +554,7 @@ ${THEME_TOKENS_CSS}
   .statsPanel .persist-note { color: var(--muted); font-size: .64rem; margin: .4rem 0 0; }
 
   /* the "researched this session" panel: its own section under the memory
-     stats, filled from window.tmctChat.researchedFactRows() plus each
+     stats, filled from window.tmct.page.researchedFactRows() plus each
      settled research turn's own answer text — the passage tmct actually
      read, the article it read it from, and the facts that passage grounded.
      A sibling section, not folded into #statsPanelStats — that div's own
@@ -1124,7 +1124,7 @@ ${THEME_TOKENS_CSS}
         })(),
         stallGuard(),
       ]);
-      window.tmctChat.registerWinkModel(() => ({ winkNLP: mod.winkNLP, model: mod.model }));
+      window.tmct.page.registerWinkModel(() => ({ winkNLP: mod.winkNLP, model: mod.model }));
       winkStatus = "loaded";
     } catch (err) {
       winkStatus = "unavailable";
@@ -1170,8 +1170,8 @@ ${THEME_TOKENS_CSS}
     if (!seedPayload) return null;
     try { return structuredClone(seedPayload); } catch { return JSON.parse(JSON.stringify(seedPayload)); }
   };
-  function newSession() {
-    return window.tmctChat.createChatSession({
+  async function newSession() {
+    return window.tmct.open({
       seedPayload: cloneSeed(),
       vocabSeeded: Boolean(seedPayload),
       liveReference: liveReferenceForMode(checkedWikiMode()),
@@ -1205,7 +1205,7 @@ ${THEME_TOKENS_CSS}
   };
 
   // ---- persistence: what you taught it survives a reload, on this device -
-  // Best-effort IndexedDB (window.tmctChat.openPersistedStore): the whole
+  // Best-effort IndexedDB (window.tmct.page.openPersistedStore): the whole
   // Backend-B payload snapshots after each teach turn, debounced so a burst
   // of teaching costs one multi-MB write, not one per fact. The stamp ties a
   // snapshot to this deploy (site version) AND this seed (its fact count and
@@ -1246,14 +1246,14 @@ ${THEME_TOKENS_CSS}
     // it would keep merging peers' facts into a store nothing reads any more.
     // Rejoining is a fresh invite, which is what a dropped node needs anyway.
     dropRoom();
-    window.tmctChatSession = newSession();
-    const stats = await window.tmctChat.memoryStats(window.tmctChatSession.memoryDir);
+    window.tmctChatSession = await newSession();
+    const stats = await window.tmct.page.memoryStats(window.tmctChatSession.memoryDir);
     addSystemLine("forgot everything taught on this device \\u2014 back to the fresh seed (" + statsSummaryLine(stats, bandLabelFor) + ").");
     await renderStatsPanel(stats);
   }
 
   // ---- memory stats: the boot message's own numbers, and the docked panel -
-  // Both read window.tmctChat.memoryStats(memoryDir) (chat-browser-entry.mjs)
+  // Both read window.tmct.page.memoryStats(memoryDir) (chat-browser-entry.mjs)
   // — one computation, reused, so the boot line and the panel can never
   // disagree with each other about what this session's memory holds.
   // bandLabelFor/statsSummaryLine/renderStatsPanelInto are the shared
@@ -1266,8 +1266,8 @@ ${THEME_TOKENS_CSS}
    *  rather than blanking it. */
   async function renderStatsPanel(stats) {
     if (!stats) {
-      if (!window.tmctChatSession || !window.tmctChat.memoryStats) return;
-      try { stats = await window.tmctChat.memoryStats(window.tmctChatSession.memoryDir); }
+      if (!window.tmctChatSession || !window.tmct.page.memoryStats) return;
+      try { stats = await window.tmct.page.memoryStats(window.tmctChatSession.memoryDir); }
       catch { return; }
     }
     factPillValueEl.textContent = Number(stats.total || 0).toLocaleString();
@@ -1282,7 +1282,7 @@ ${THEME_TOKENS_CSS}
   // and grounded so far — each entry pairs the passage a settled research
   // turn's own answer cites (parseResearchAnswer, off the SAME "(source:
   // research article ...)" text the chat bubble already shows) with the real
-  // facts that turn stored, read back through window.tmctChat.
+  // facts that turn stored, read back through window.tmct.
   // researchedFactRows(memoryDir) rather than re-deriving them from the
   // answer text — the citation names WHERE tmct read, the fact rows name
   // WHAT it kept, and this panel never invents either from the other.
@@ -1348,9 +1348,9 @@ ${THEME_TOKENS_CSS}
    *  own entry — the passage was still read, even where nothing new stuck. */
   async function noteResearchLearned(result) {
     if (result.research === undefined || !result.record || result.record.miss) return;
-    if (!window.tmctChat.researchedFactRows || !window.tmctChatSession) return;
+    if (!window.tmct.page.researchedFactRows || !window.tmctChatSession) return;
     let rows;
-    try { rows = await window.tmctChat.researchedFactRows(window.tmctChatSession.memoryDir); }
+    try { rows = await window.tmct.page.researchedFactRows(window.tmctChatSession.memoryDir); }
     catch { return; }
     const newFacts = [];
     for (const row of rows) {
@@ -1446,7 +1446,7 @@ ${THEME_TOKENS_CSS}
     setBusy(true);
     let result = null;
     try {
-      result = await window.tmctChatSession.turn(q);
+      result = await window.tmct.turn(q);
       settleAssistantBubble(pendingRow, result.answer, result.record);
       // Persist on ANY store write, not just a teach turn: a learn-on-miss
       // load (a child pack, a reference or live-Wikipedia article, a
@@ -1587,10 +1587,10 @@ ${THEME_TOKENS_CSS}
   // CLI paths emit), so what you taught leaves in the standard shape.
   el("exportFacts").addEventListener("click", async () => {
     const session = window.tmctChatSession;
-    if (!session || !window.tmctChat.exportFactsJsonl) return;
+    if (!session || !window.tmct.page.exportFactsJsonl) return;
     let jsonl;
     try {
-      jsonl = await window.tmctChat.exportFactsJsonl(session.memoryDir);
+      jsonl = await window.tmct.page.exportFactsJsonl(session.memoryDir);
     } catch (err) {
       statusEl.textContent = "couldn't export the facts (" + (err && err.message ? err.message : err) + ")";
       return;
@@ -1607,7 +1607,7 @@ ${THEME_TOKENS_CSS}
   });
 
   // "ingest file" feeds a whole .txt/.md through the SAME session, one
-  // sentence at a time (window.tmctChat.splitSentences, then session.turn),
+  // sentence at a time (window.tmct.page.splitSentences, then session.turn),
   // teaching every sentence the recognizer grounds and skipping the rest
   // honestly — the same pipeline the ingest page runs, reaching the chat's own
   // memory so the taught facts answer questions straight away.
@@ -1616,7 +1616,7 @@ ${THEME_TOKENS_CSS}
     const file = e.target.files && e.target.files[0];
     e.target.value = "";
     const session = window.tmctChatSession;
-    if (!file || busy || !session || !window.tmctChat.splitSentences) return;
+    if (!file || busy || !session || !window.tmct.page.splitSentences) return;
     let text;
     try {
       text = await file.text();
@@ -1624,14 +1624,14 @@ ${THEME_TOKENS_CSS}
       addSystemLine("couldn't read that file (" + (err && err.message ? err.message : err) + ").");
       return;
     }
-    const sentences = window.tmctChat.splitSentences(text);
+    const sentences = window.tmct.page.splitSentences(text);
     if (!sentences.length) { addSystemLine("nothing to ingest in " + file.name + "."); return; }
     setBusy(true);
     statusEl.textContent = "ingesting " + file.name + "\\u2026";
     let grounded = 0;
     try {
       for (const sentence of sentences) {
-        const result = await session.turn(sentence);
+        const result = await tmct.turn(sentence);
         if (result.record && result.record.via === "assert" && !result.record.miss) grounded += 1;
       }
     } catch (err) {
@@ -2221,16 +2221,16 @@ ${THEME_TOKENS_CSS}
   }
 
   async function boot() {
-    if (!window.tmctChat) {
+    if (!window.tmct) {
       statusEl.textContent = "the chat engine didn't load \\u2014 this page needs its build step (npm run demo:build)";
       inputEl.placeholder = "chat engine unavailable";
       return;
     }
     await Promise.all([fetchSeed(), tryLoadWink(), fetchSiteVersion().then((v) => { siteVersion = v; })]);
     progressActive = false;
-    window.tmctChat.registerReferencePackProvider(fetchPackProvider);
-    if (window.tmctChat.openPersistedStore) {
-      persist = window.tmctChat.openPersistedStore({ storeKey: "chat", stamp: siteVersion + ":" + seedFacts + ":" + SEED_STAMP });
+    window.tmct.page.registerReferencePackProvider(fetchPackProvider);
+    if (window.tmct.page.openPersistedStore) {
+      persist = window.tmct.page.openPersistedStore({ storeKey: "chat", stamp: siteVersion + ":" + seedFacts + ":" + SEED_STAMP });
     }
     const savedRecord = persist ? await persist.load() : null;
     const initialMode = readWikiMode();
@@ -2239,7 +2239,7 @@ ${THEME_TOKENS_CSS}
     synthSliderEl.value = String(readSynthBudget());
     synthValueEl.textContent = synthSliderEl.value;
     if (savedRecord && savedRecord.payload) {
-      window.tmctChatSession = window.tmctChat.createChatSession({
+      window.tmctChatSession = await window.tmct.open({
         seedPayload: savedRecord.payload,
         vocabSeeded: true,
         liveReference: liveReferenceForMode(initialMode),
@@ -2248,9 +2248,9 @@ ${THEME_TOKENS_CSS}
         digestStructures: DIGEST_STRUCTURES,
       });
     } else {
-      window.tmctChatSession = newSession();
+      window.tmctChatSession = await newSession();
     }
-    const stats = await window.tmctChat.memoryStats(window.tmctChatSession.memoryDir);
+    const stats = await window.tmct.page.memoryStats(window.tmctChatSession.memoryDir);
     if (savedRecord) restoredCount = stats.taught.length;
     const restoredNote = savedRecord
       ? " Restored " + restoredCount + " taught fact" + (restoredCount === 1 ? "" : "s")
@@ -2264,14 +2264,14 @@ ${THEME_TOKENS_CSS}
     // seen-set from them so a later research turn only reports what's
     // actually new, without fabricating passages for a visit this page
     // was never open to read.
-    if (window.tmctChat.researchedFactRows) {
+    if (window.tmct.page.researchedFactRows) {
       try {
-        const existingResearch = await window.tmctChat.researchedFactRows(window.tmctChatSession.memoryDir);
+        const existingResearch = await window.tmct.page.researchedFactRows(window.tmctChatSession.memoryDir);
         for (const row of existingResearch) researchedFactKeysSeen.add(row.subject + "|" + row.predicate + "|" + row.object);
       } catch { /* best-effort seeding only — a fresh session has none to seed */ }
     }
     renderResearchedPanel();
-    inputEl.placeholder = seedPayload ? 'try "what is a dog" or "list facts"' : window.tmctChat.vocabExampleHint(false);
+    inputEl.placeholder = seedPayload ? 'try "what is a dog" or "list facts"' : window.tmct.page.vocabExampleHint(false);
     renderStatus();
     setBusy(false);
     inputEl.focus();

package/src/services/chat.mjs

@@ -2127,7 +2127,7 @@ export { moduleCountOf };
 /** A KNOWN-empty code graph: a loaded graph object with 0 modules. A null graph
  *  (a bare runTurn that wasn't handed one) is "unknown", NOT empty — the empty
  *  orientation/greeting only fires when we actually hold an empty graph. */
-const noCodeGraph = (graph) => !!graph && moduleCountOf(graph) === 0;
+export const noCodeGraph = (graph) => !!graph && moduleCountOf(graph) === 0;
 
 /** LIVE orientation examples: the example queries on the orientation card name
  *  entities from the LOADED graph — the sorted-first Module label and the

package/src/services/code-explorer-viz.mjs

@@ -110,7 +110,7 @@ export function computeCodeExplorerData(payload, opts = {}) {
 const CLIENT_JS = String.raw`
 (function () {
   var DATA = window.__CODE_EXPLORER__;
-  var api = window.tmctCodeExplorer || null;
+  var api = window.tmct ? window.tmct.page : null;
   var els = {
     focus: document.getElementById("focus-name"),
     ledger: document.getElementById("ledger"),

package/src/services/ingest-viz.mjs

@@ -2,7 +2,7 @@
 // self-contained document shaped exactly like chat-page-viz.mjs's own
 // page-builder — one inlined <style> importing viz-theme.mjs's shared tokens,
 // behaviour as an inlined IIFE — running the ingest engine
-// (ingest-browser.bundle.js's globalThis.tmctIngest) by same-origin relative
+// (ingest-browser.bundle.js's globalThis.tmct) by same-origin relative
 // paths.
 //
 // The page's own chrome is a two-pane translate-tool layout: mode pills
@@ -133,7 +133,7 @@ ${THEME_TOKENS_CSS}
      the right of the ingest column (a real layout column, not an overlay) —
      the same class names and breakpoint chat-page-viz.mjs's own docked panel
      uses, re-rendered after boot and after every ingest from
-     window.tmctIngest's own memoryStats(). */
+     window.tmct's own memoryStats(). */
   .statsPanel { flex: 0 0 300px; max-width: 300px; overflow-y: auto; border-left: 1px solid var(--line); padding: 1.1rem 1.2rem 1.6rem; font-family: ${MONO_STACK}; font-size: .74rem; line-height: 1.55; display: flex; flex-direction: column; }
   .statsPanel h2 { font-size: .66rem; letter-spacing: .07em; text-transform: uppercase; color: var(--muted); margin: 1.3rem 0 .5rem; }
   .statsPanel h2:first-child { margin-top: 0; }
@@ -359,8 +359,8 @@ ${THEME_TOKENS_CSS}
   // ---- memory stats: the docked panel, same convention as chat.html --------
   async function renderStatsPanel(stats) {
     if (!stats) {
-      if (!session || !window.tmctIngest.memoryStats) return;
-      try { stats = await window.tmctIngest.memoryStats(session.memoryDir); }
+      if (!session || !window.tmct.page.memoryStats) return;
+      try { stats = await window.tmct.page.memoryStats(session.memoryDir); }
       catch { return; }
     }
     factPillValueEl.textContent = Number(stats.total || 0).toLocaleString();
@@ -415,13 +415,13 @@ ${THEME_TOKENS_CSS}
     }
   }
   const cloneMemoryPayload = ${cloneMemoryPayload.toString()};
-  function newSession() {
-    return window.tmctIngest.createIngestSession({ seedPayload: cloneMemoryPayload(seedPayload), vocabSeeded: Boolean(seedPayload) });
+  async function newSession() {
+    return window.tmct.open({ seedPayload: cloneMemoryPayload(seedPayload), vocabSeeded: Boolean(seedPayload) });
   }
 
   // ---- engine boot ---------------------------------------------------------
   const loadWinkVendor = ${loadWinkVendor.toString()};
-  const tryLoadWink = loadWinkVendor({ register: (factory) => window.tmctIngest.registerWinkModel(factory) });
+  const tryLoadWink = loadWinkVendor({ register: (factory) => window.tmct.page.registerWinkModel(factory) });
 
   // The deploy's own version, read off the service worker file the build
   // already stamps — the only same-origin place the number exists at runtime
@@ -467,10 +467,10 @@ ${THEME_TOKENS_CSS}
     clearTimeout(saveTimer);
     saveTimer = null;
     if (persist) await persist.clear();
-    session = newSession();
+    session = await newSession();
     clearFactsPane();
     updateIngestEnabled();
-    const stats = await window.tmctIngest.memoryStats(session.memoryDir);
+    const stats = await window.tmct.page.memoryStats(session.memoryDir);
     statusEl.textContent = "forgot everything taught on this device. Back to the fresh seed (" + statsSummaryLine(stats, bandLabelFor) + ").";
     await renderStatsPanel(stats);
   }
@@ -486,9 +486,9 @@ ${THEME_TOKENS_CSS}
     await fetchSeedIfWanted();
     clearTimeout(saveTimer);
     saveTimer = null;
-    session = newSession();
+    session = await newSession();
     clearFactsPane();
-    const stats = await window.tmctIngest.memoryStats(session.memoryDir);
+    const stats = await window.tmct.page.memoryStats(session.memoryDir);
     statusEl.textContent = statsSummaryLine(stats, bandLabelFor) + ". Ready.";
     await renderStatsPanel(stats);
     updateIngestEnabled();
@@ -496,7 +496,7 @@ ${THEME_TOKENS_CSS}
   });
 
   async function boot() {
-    if (!window.tmctIngest) {
+    if (!window.tmct) {
       statusEl.textContent = "the ingest engine didn't load. This page needs its build step (npm run demo:build)";
       return;
     }
@@ -507,16 +507,16 @@ ${THEME_TOKENS_CSS}
       fetchSiteVersion().then((v) => { siteVersion = v; }),
     ]);
     progressActive = false;
-    if (window.tmctIngest.openPersistedStore) {
-      persist = window.tmctIngest.openPersistedStore({ storeKey: "ingest", stamp: siteVersion + ":" + seedFacts + ":" + SEED_STAMP });
+    if (window.tmct.page.openPersistedStore) {
+      persist = window.tmct.page.openPersistedStore({ storeKey: "ingest", stamp: siteVersion + ":" + seedFacts + ":" + SEED_STAMP });
     }
     const savedRecord = persist ? await persist.load() : null;
     session = savedRecord && savedRecord.payload
-      ? window.tmctIngest.createIngestSession({ seedPayload: savedRecord.payload, vocabSeeded: true })
-      : newSession();
+      ? await window.tmct.open({ seedPayload: savedRecord.payload, vocabSeeded: true })
+      : await newSession();
     setMode(false);
     updateIngestEnabled();
-    const stats = await window.tmctIngest.memoryStats(session.memoryDir);
+    const stats = await window.tmct.page.memoryStats(session.memoryDir);
     const winkPart = winkStatus === "loaded"
       ? "wink-nlp: loaded"
       : "wink-nlp unavailable. The recognizer can't split sentences without it";
@@ -569,10 +569,10 @@ ${THEME_TOKENS_CSS}
 
   // ---- download the canonical facts as JSONL -------------------------------
   downloadBtn.addEventListener("click", async () => {
-    if (!session || !window.tmctIngest.exportFactsJsonl) return;
+    if (!session || !window.tmct.page.exportFactsJsonl) return;
     let jsonl;
     try {
-      jsonl = await window.tmctIngest.exportFactsJsonl(session.memoryDir);
+      jsonl = await window.tmct.page.exportFactsJsonl(session.memoryDir);
     } catch (err) {
       statusEl.textContent = "couldn't build the download (" + (err && err.message ? err.message : err) + ")";
       return;