@polycode-projects/the-mechanical-code-talker 1.12.0 → 2.0.2

package/src/{server-http.mjs → surfaces/http/server-http.mjs}

@@ -11,29 +11,24 @@
 // Every response's `usage` is { input_tokens: 0, output_tokens: 0 } — tmct is the $0
 // floor, priced as free by the meter.
 //
-// src/server.mjs is the tool-dispatch layer, not an HTTP server; this module is the
+// src/tools/server.mjs is the tool-dispatch layer, not an HTTP server; this module is the
 // HTTP surface.
 
 import { createServer } from "node:http";
-import { runTurn, COMMANDS, asBareCommand, isConversational } from "./chat.mjs";
-import { TOOLS } from "./server.mjs";
-import { parseEntities } from "./codegraph.mjs";
-import { uuidv7 } from "./uuid.mjs";
-import * as defaultSource from "./source.mjs";
+import { runTurn, selectTool } from "../../services/chat.mjs";
+import { TOOLS } from "../../tools/server.mjs";
+import { parseEntities } from "../../domain/codegraph.mjs";
+import { uuidv7 } from "../../adapters/uuid.mjs";
+import * as defaultSource from "../../adapters/source.mjs";
+
+// The shim's deterministic tool selection lives with the chat surface's own
+// command routing (selectTool in chat.mjs); re-exported here so HTTP-side
+// callers keep one import site for the whole shim seam.
+export { selectTool } from "../../services/chat.mjs";
 
 /** The zero usage every response carries — the meter prices tmct as the $0 floor. */
 const ZERO_USAGE = { input_tokens: 0, output_tokens: 0 };
 
-/** The tmct tools dispatchTool can back (the set the shim will emit a tool_use for).
- *  A declared tool outside this set is ignored for emission (the request falls
- *  through to a text answer) — the shim never emits a call it cannot ground. The
- *  COMMANDS map (chat.mjs) names the richer graph tools; TOOLS names the hot
- *  catalog. Their union is what dispatchTool serves. */
-const BACKED_TOOLS = new Set([
-  ...TOOLS.map((t) => t.name),
-  ...Object.values(COMMANDS).map((s) => s.tool),
-]);
-
 /** Flatten a message's `content` (a string OR a content-block array) into plain
  *  text — concatenating the `text` blocks. Non-text blocks are ignored here. */
 function textOfContent(content) {
@@ -74,55 +69,6 @@ function toolResultText(block) {
   try { return JSON.stringify(c); } catch { return String(c); }
 }
 
-/**
- * Decide whether a user turn maps to a DECLARED, dispatch-backed graph-query
- * tool, and bind its arguments. Deterministic, in-ethos (no NL guessing beyond
- * the chat surface's own command routing):
- *
- *   1. A slash/bare command that names a tmct tool ("describe X", "/callers X",
- *      "untested") → that tool with its argument bound from the exact arg key the
- *      dispatchTool switch reads (COMMANDS in chat.mjs). Only when the tool is
- *      declared by the caller.
- *   2. Otherwise, a non-conversational structural question → tmct_ask{query:…},
- *      when tmct_ask is declared. Small-talk (isConversational) never emits a
- *      call — it falls through to a text answer.
- *
- * Returns { name, input } or null (→ answer as text).
- */
-export function selectTool(text, declaredNames) {
-  const t = String(text || "").trim();
-  if (!t) return null;
-
-  // 1. explicit command form → a specific tool, argument bound
-  const cmdLine = t.startsWith("/") ? t : asBareCommand(t);
-  if (cmdLine) {
-    const [first, ...restTok] = cmdLine.replace(/^\//, "").split(/\s+/);
-    const spec = COMMANDS[String(first).toLowerCase()];
-    if (spec && declaredNames.has(spec.tool) && BACKED_TOOLS.has(spec.tool)) {
-      const input = {};
-      if (spec.arg) {
-        const val = restTok.join(" ").trim();
-        if (val) input[spec.arg] = val;
-        // an entity command with no argument can't bind a call — fall through
-        else if (!spec.optional) return askFallback(t, declaredNames);
-      }
-      return { name: spec.tool, input };
-    }
-  }
-
-  // 2. structural question → tmct_ask, unless it's small-talk
-  return askFallback(t, declaredNames);
-}
-
-/** The tmct_ask fallback: emit tmct_ask{query} for a non-conversational line when
- *  the caller declared tmct_ask; otherwise null (→ text answer). */
-function askFallback(text, declaredNames) {
-  if (declaredNames.has("tmct_ask") && BACKED_TOOLS.has("tmct_ask") && !isConversational(text)) {
-    return { name: "tmct_ask", input: { query: text } };
-  }
-  return null;
-}
-
 /** Build the assistant message envelope shared by every branch. */
 function assistantMessage(model, content, stopReason) {
   return {

package/src/{tui → surfaces/tui}/app.mjs

@@ -2,7 +2,7 @@
 // alternate-screen layout with a scrolling transcript pane, a bottom input line, and a
 // status bar (repo, module count, session id).
 //
-// Every turn goes through the SAME createSession sink (src/chat.mjs) the plain readline
+// Every turn goes through the SAME createSession sink (src/services/chat.mjs) the plain readline
 // shell uses — transcript log, sidecar, graph upsert, and memory side-write are
 // byte-identical to `--plain`; only the screen drawing differs.
 //
@@ -14,7 +14,7 @@
 
 import React, { useEffect, useState } from "react";
 import { render, Box, Text, useApp, useInput, useStdout } from "ink";
-import { createSession } from "../chat.mjs";
+import { createSession } from "../../services/chat.mjs";
 
 const h = React.createElement;
 
@@ -221,7 +221,7 @@ export function App({ session }) {
  *  which also triggers the memory fold — stream flush). Returns
  *  { logFile, sidecarFile, turns } exactly like runChat. */
 export async function runTui({ repoPath, stdout = process.stdout, stdin = process.stdin, ...sessionOpts } = {}) {
-  // Same reasoning as runChat's equivalent line (src/chat.mjs): createSession's
+  // Same reasoning as runChat's equivalent line (src/services/chat.mjs): createSession's
   // first-run seed is silent for ~2-3s, and nothing is written to the terminal
   // (not even the alternate-screen switch below) until it resolves — this was
   // reported live as an apparent hang. One cheap line on the PRIMARY screen,

package/src/{memory-ask-browser-entry.mjs → surfaces/web/memory-ask-browser-entry.mjs}

@@ -1,13 +1,13 @@
 // memory-ask-browser-entry.mjs — the esbuild entry for the ledger page's
-// chat dock (`tmct viz`, src/ledger-viz.mjs).
+// chat dock (`tmct viz`, src/services/ledger-viz.mjs).
 //
-// Re-exports `factAnswer` (src/chat.mjs) and `createInMemoryStore`
-// (src/memory/core.mjs), which lets the dock hand `factAnswer` the page's
+// Re-exports `factAnswer` (src/services/chat.mjs) and `createInMemoryStore`
+// (src/adapters/memory/core.mjs), which lets the dock hand `factAnswer` the page's
 // already-embedded payload with zero fs I/O. Called with `envelope: null,
 // miss: true` to arm factAnswer's bare-question regex fallbacks directly,
 // bypassing the structural-graph parse pipeline this dock has no use for.
-import { factAnswer, factReadBack } from "./chat.mjs";
-import { createInMemoryStore, normFactTerm } from "./memory/core.mjs";
+import { factAnswer, factReadBack } from "../../services/chat.mjs";
+import { createInMemoryStore, normFactTerm } from "../../adapters/memory/core.mjs";
 
 // normFactTerm is re-exported too, for the page's client-side term normalization.
 // factReadBack carries the taught-relation chases (grandfather-style questions)