@polycode-projects/the-mechanical-code-talker 2.10.3 → 2.11.0

package/src/services/chat-session.mjs

@@ -28,6 +28,8 @@ import * as defaultSource from "../adapters/source.mjs";
 import { resolveExtensions, mergedLexiconExtra } from "./extensions.mjs";
 import { runTurn, hasSeededVocabulary, vocabExampleHint } from "./chat.mjs";
 import { resolveGameConfig } from "../domain/game-config.mjs";
+import { resolveResearchConfig } from "./research.mjs";
+import { sessionLogHeaderMarkdown, sessionLogTurnMarkdown, sessionLogEndMarkdown } from "./session-log-format.mjs";
 
 /** Where session logs live, relative to the target repo. `.tmct/` is the repo's
  *  one artifact directory (gitignored, machine-local) — flip this single constant
@@ -198,6 +200,11 @@ export async function createSession({
   // to the shipped defaults for every key.
   const gameConfig = resolveGameConfig(toml);
 
+  // The research lane's knobs (fan-out cap, depth, the polite interval) —
+  // resolved once per session from the same tmct.toml, defaults filling
+  // every unset key exactly as resolveGameConfig does above.
+  const researchConfig = resolveResearchConfig(toml);
+
   // tmct.toml's corpus tier3 opts the session into the live supplement too —
   // the flag/env tiers above stay authoritative when set.
   if (toml?.corpus?.tier === "tier3") liveReferenceOn = true;
@@ -243,7 +250,7 @@ export async function createSession({
   const sessionsDir = join(repo, SESSIONS_DIR_REL);
   await mkdir(logDir, { recursive: true });
   await mkdir(sessionsDir, { recursive: true });
-  const logFile = join(logDir, `session-${sessionId}.log`);
+  const logFile = join(logDir, `session-${sessionId}.md`);
   const sidecarFile = join(sessionsDir, `session-${sessionId}.jsonl`);
   const stream = createWriteStream(logFile, { flags: "a" });
   const sidecar = createWriteStream(sidecarFile, { flags: "a" });
@@ -255,7 +262,7 @@ export async function createSession({
   const writeSidecar = (obj) => flush(sidecar, JSON.stringify(obj) + "\n");
 
   const startIso = new Date().toISOString();
-  await writeLog(`# tmct chat ${version} — session started ${startIso} — repo ${repo}\n\n`);
+  await writeLog(sessionLogHeaderMarkdown({ version, sessionId, startedAt: startIso, repo }));
   await writeSidecar({ type: "session", id: sessionId, started: startIso, repo, tmctVersion: version });
 
   // Read-time graph upsert (sessions.mjs): after every turn, the session becomes /
@@ -336,6 +343,7 @@ export async function createSession({
   let focus = null; // the current focus entity ({id,label}) — threaded turn to turn
   let last = null;  // the last dispatched answer ({query,answer,detail}) — why/say-more re-renders it
   let planState = null; // the in-progress plan (goals/moves/cursor) — cleared by completion or a fresh goal, never by an aside
+  let researchState = null; // the in-progress research queue — advanced by "research next", cleared by completion or "research stop"
   let closed = false;
 
   return {
@@ -346,6 +354,7 @@ export async function createSession({
     get focus() { return focus; },
     get lastAnswer() { return last; },
     get planState() { return planState; },
+    get researchState() { return researchState; },
     get turns() { return turns; },
     get narrate() { return narrateOn; },
     get liveReference() { return liveReferenceOn; },
@@ -359,27 +368,31 @@ export async function createSession({
     async turn(line) {
       let result;
       try {
-        result = await runTurn(line, { config, source, graph, focus, last, memoryDir, sessionId, env, lexicon, narrate: narrateOn, liveReference: liveReferenceOn, vocabHint, tel, biasByBundle, planState, gameConfig });
+        result = await runTurn(line, { config, source, graph, focus, last, memoryDir, sessionId, env, lexicon, narrate: narrateOn, liveReference: liveReferenceOn, vocabHint, tel, biasByBundle, planState, gameConfig, researchState, researchConfig });
       } catch (e) {
         const ts = new Date().toISOString();
         const message = e instanceof Error ? e.message : String(e);
-        await writeLog(`${ts}\n> ${line}\nerror: ${message}\n`);
+        await writeLog(sessionLogTurnMarkdown({ startedAt: ts, turnNumber: turns + 1, query: line, answer: `error: ${message}` }));
         const errorRecord = { type: "error", ts, query: line, error: message };
         await writeSidecar(errorRecord);
         turnRecords.push(errorRecord);
         turns += 1;
         return { answer: `Something went wrong answering that (${message}). Try rephrasing, or /help.`, end: false, prompt: promptFor(focus) };
       }
-      const { answer, logLines, record, focus: nextFocus, last: nextLast, end, narrate: nextNarrate, liveReference: nextLiveReference } = result;
+      const { answer, record, focus: nextFocus, last: nextLast, end, narrate: nextNarrate, liveReference: nextLiveReference } = result;
       focus = nextFocus;
       last = nextLast;
       if ("planState" in result) planState = result.planState;
+      if ("researchState" in result) researchState = result.researchState;
       // /narrate on|off and /wiki on|off (runCommand) ride the turn RESULT the
       // same way a focus update does — apply them to this handle's
       // session-scoped state.
       if (typeof nextNarrate === "boolean") narrateOn = nextNarrate;
-      if (typeof nextLiveReference === "boolean") liveReferenceOn = nextLiveReference;
-      await writeLog(logLines.join("\n") + "\n");
+      // four-state: false (off), true (rescue on a miss), "supplement" (also
+      // append a cited read-out under every grounded vocabulary answer), or
+      // "always" (widen that to every grounded answer).
+      if (typeof nextLiveReference === "boolean" || nextLiveReference === "supplement" || nextLiveReference === "always") liveReferenceOn = nextLiveReference;
+      await writeLog(sessionLogTurnMarkdown({ startedAt: record.ts, turnNumber: turns + 1, query: line, answer }));
       await writeSidecar(record);
       turnRecords.push(record);
       // One telemetry line per dispatched turn (OFF by default → no-op). query.raw is
@@ -391,7 +404,7 @@ export async function createSession({
       });
       await upsertGraph(record.ts);
       turns += 1;
-      return { answer, end: Boolean(end), prompt: promptFor(focus), plan: result.plan ?? null, record };
+      return { answer, end: Boolean(end), prompt: promptFor(focus), plan: result.plan ?? null, research: result.research, record };
     },
 
     /** End-of-session close: end lines in both artifacts, the final graph upsert
@@ -401,7 +414,9 @@ export async function createSession({
       if (closed) return;
       closed = true;
       const endIso = new Date().toISOString();
-      await writeLog(`${endIso}\n> /exit\nsession end ${endIso}\n`);
+      const closingTurnNumber = turns + 1;
+      await writeLog(sessionLogTurnMarkdown({ startedAt: endIso, turnNumber: closingTurnNumber, query: "/exit", answer: "" }));
+      await writeLog(sessionLogEndMarkdown({ endedAt: endIso, turnCount: closingTurnNumber }));
       await writeSidecar({ type: "end", ts: endIso });
       await upsertGraph(endIso);
       await new Promise((resolve) => stream.end(resolve));