@agentprojectcontext/apx 1.77.2 → 1.78.0

package/src/interfaces/cli/routes/restart.js

@@ -0,0 +1,15 @@
+// apx restart — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdDaemonRestart } from "../commands/daemon.js";
+import { cmdDesktopRestart, desktopRunning } from "../commands/desktop.js";
+
+export default async function route(rest, { parseArgs }) {
+  const a = parseArgs(rest);
+  await cmdDaemonRestart(a);
+  if (desktopRunning()) await cmdDesktopRestart(a);
+  return;
+}

package/src/interfaces/cli/routes/routine.js

@@ -0,0 +1,28 @@
+// apx routine — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdRoutineAdd, cmdRoutineDisable, cmdRoutineEnable, cmdRoutineGet, cmdRoutineHistory, cmdRoutineList, cmdRoutineMemory, cmdRoutineRemove, cmdRoutineRun } from "../commands/routine.js";
+
+// Aliases accepted for this command. Declared here, next to the command
+// itself — a global alias table would be wrong, since the same word means
+// different things under different commands ("rm" is remove under `agent`,
+// unset under `project config`, revoke under `pair`).
+export const aliases = ["routines"];
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (sub === "list" || sub === "ls" || sub === undefined) await cmdRoutineList(a);
+  else if (sub === "get" || sub === "show") await cmdRoutineGet(a);
+  else if (sub === "add" || sub === "new") await cmdRoutineAdd(a);
+  else if (sub === "remove" || sub === "rm") await cmdRoutineRemove(a);
+  else if (sub === "enable") await cmdRoutineEnable(a);
+  else if (sub === "disable") await cmdRoutineDisable(a);
+  else if (sub === "run") await cmdRoutineRun(a);
+  else if (sub === "history" || sub === "hist") await cmdRoutineHistory(a);
+  else if (sub === "memory" || sub === "mem") await cmdRoutineMemory(a);
+  else die(`unknown routine subcommand: ${sub}`);
+}

package/src/interfaces/cli/routes/run.js

@@ -0,0 +1,11 @@
+// apx run — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdRun } from "../commands/runtime.js";
+
+export default async function route(rest, { parseArgs }) {
+  await cmdRun(parseArgs(rest));
+}

package/src/interfaces/cli/routes/search.js

@@ -0,0 +1,11 @@
+// apx search — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdSearch } from "../commands/search.js";
+
+export default async function route(rest, { parseArgs }) {
+  await cmdSearch(parseArgs(rest));
+}

package/src/interfaces/cli/routes/send.js

@@ -0,0 +1,11 @@
+// apx send — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdSend } from "../commands/a2a.js";
+
+export default async function route(rest, { parseArgs }) {
+  await cmdSend(parseArgs(rest));
+}

package/src/interfaces/cli/routes/session.js

@@ -0,0 +1,26 @@
+// apx session — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdSessionAsk, cmdSessionCheck, cmdSessionClose, cmdSessionCloseStale, cmdSessionCompact, cmdSessionGet, cmdSessionList, cmdSessionNew, cmdSessionResume, cmdSessionSummary, cmdSessionUpdate } from "../commands/session.js";
+import { cmdSessionFind } from "../commands/sessions.js";
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (sub === "new") cmdSessionNew(a);
+  else if (sub === "list" || sub === "ls") cmdSessionList(a);
+  else if (sub === "get" || sub === "show") cmdSessionGet(a);
+  else if (sub === "update") cmdSessionUpdate(a);
+  else if (sub === "close") cmdSessionClose(a);
+  else if (sub === "check") cmdSessionCheck();
+  else if (sub === "close-stale") cmdSessionCloseStale();
+  else if (sub === "resume") await cmdSessionResume(a);
+  else if (sub === "compact") await cmdSessionCompact(a);
+  else if (sub === "find" || sub === "search") cmdSessionFind(a);
+  else if (sub === "summary") await cmdSessionSummary(a);
+  else if (sub === "ask") await cmdSessionAsk(a);
+  else die(`unknown session subcommand: ${sub || "(none)"}`);
+}

package/src/interfaces/cli/routes/sessions.js

@@ -0,0 +1,15 @@
+// apx sessions — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdSessionsList } from "../commands/sessions.js";
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const isListSub = sub === "list" || sub === "ls";
+  const a = parseArgs(isListSub ? rest.slice(1) : rest);
+  if (!sub || isListSub || sub.startsWith("--")) cmdSessionsList(a);
+  else die(`unknown sessions subcommand: ${sub} — try: list`);
+}

package/src/interfaces/cli/routes/setup.js

@@ -0,0 +1,18 @@
+// apx setup — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdSetup } from "../commands/setup.js";
+
+// Aliases accepted for this command. Declared here, next to the command
+// itself — a global alias table would be wrong, since the same word means
+// different things under different commands ("rm" is remove under `agent`,
+// unset under `project config`, revoke under `pair`).
+export const aliases = ["install"];
+
+export default async function route(_rest, _ctx) {
+  await cmdSetup();
+  return;
+}

package/src/interfaces/cli/routes/skills.js

@@ -0,0 +1,20 @@
+// apx skills — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdSkillsAdd, cmdSkillsIndex, cmdSkillsInspect, cmdSkillsInspector, cmdSkillsList, cmdSkillsStatus, cmdSkillsSync } from "../commands/skills.js";
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (!sub || sub === "add") await cmdSkillsAdd(a);
+  else if (sub === "list" || sub === "ls") await cmdSkillsList(a);
+  else if (sub === "status") await cmdSkillsStatus();
+  else if (sub === "sync" || sub === "refresh") await cmdSkillsSync(a);
+  else if (sub === "index") await cmdSkillsIndex(a);
+  else if (sub === "inspect") await cmdSkillsInspect(a);
+  else if (sub === "inspector") await cmdSkillsInspector(a);
+  else die(`unknown skills subcommand: ${sub}`);
+}

package/src/interfaces/cli/routes/status.js

@@ -0,0 +1,12 @@
+// apx status — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdStatus } from "../commands/status.js";
+
+export default async function route(_rest, _ctx) {
+  await cmdStatus();
+  return; // skip checkForUpdate after status (avoid noise)
+}

package/src/interfaces/cli/routes/task.js

@@ -0,0 +1,26 @@
+// apx task — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdTaskAdd, cmdTaskDone, cmdTaskDrop, cmdTaskList, cmdTaskPatch, cmdTaskReopen, cmdTaskShow } from "../commands/task.js";
+
+// Aliases accepted for this command. Declared here, next to the command
+// itself — a global alias table would be wrong, since the same word means
+// different things under different commands ("rm" is remove under `agent`,
+// unset under `project config`, revoke under `pair`).
+export const aliases = ["tasks"];
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (!sub || sub === "list" || sub === "ls") await cmdTaskList(a);
+  else if (sub === "add" || sub === "new" || sub === "create") await cmdTaskAdd(a);
+  else if (sub === "show" || sub === "get") await cmdTaskShow(a);
+  else if (sub === "done" || sub === "complete") await cmdTaskDone(a);
+  else if (sub === "drop" || sub === "archive") await cmdTaskDrop(a);
+  else if (sub === "reopen") await cmdTaskReopen(a);
+  else if (sub === "patch" || sub === "edit") await cmdTaskPatch(a);
+  else die(`unknown task subcommand: ${sub}\nUsage: apx task <list|add|show|done|drop|reopen|patch>`);
+}

package/src/interfaces/cli/routes/telegram.js

@@ -0,0 +1,39 @@
+// apx telegram — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdTelegramChannelAdd, cmdTelegramChannelList, cmdTelegramChannelRemove, cmdTelegramChannelSet, cmdTelegramChannelShow, cmdTelegramChannelUnset, cmdTelegramContactRemove, cmdTelegramContacts, cmdTelegramOwner, cmdTelegramRole, cmdTelegramRoles, cmdTelegramSend, cmdTelegramSetup, cmdTelegramStart, cmdTelegramStatus, cmdTelegramStop } from "../commands/telegram.js";
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (sub === "send") await cmdTelegramSend(a);
+  else if (sub === "status") await cmdTelegramStatus();
+  else if (sub === "start") await cmdTelegramStart();
+  else if (sub === "stop") await cmdTelegramStop();
+  else if (sub === "setup") cmdTelegramSetup();
+  else if (sub === "channel" || sub === "channels") {
+    const csub = rest[1];
+    const ca = parseArgs(rest.slice(2));
+    if (csub === "add") await cmdTelegramChannelAdd(ca);
+    else if (csub === "list" || csub === "ls" || !csub) await cmdTelegramChannelList();
+    else if (csub === "show" || csub === "get") await cmdTelegramChannelShow(ca);
+    else if (csub === "set") await cmdTelegramChannelSet(ca);
+    else if (csub === "unset") await cmdTelegramChannelUnset(ca);
+    else if (csub === "remove" || csub === "rm") await cmdTelegramChannelRemove(ca);
+    else die(`unknown telegram channel subcommand: ${csub} — try: add, list, show, set, unset, remove`);
+  }
+  else if (sub === "contacts" || sub === "contact") {
+    const csub = rest[1];
+    const ca = parseArgs(rest.slice(2));
+    if (csub === "rm" || csub === "remove") await cmdTelegramContactRemove(ca);
+    else if (!csub || csub === "list" || csub === "ls") await cmdTelegramContacts();
+    else die(`unknown telegram contacts subcommand: ${csub} — try: list, rm`);
+  }
+  else if (sub === "role") await cmdTelegramRole(parseArgs(rest.slice(1)));
+  else if (sub === "roles") await cmdTelegramRoles(parseArgs(rest.slice(1)));
+  else if (sub === "owner") await cmdTelegramOwner(parseArgs(rest.slice(1)));
+  else die(`unknown telegram subcommand: ${sub || "(none)"}`);
+}

package/src/interfaces/cli/routes/update.js

@@ -0,0 +1,24 @@
+// apx update — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdUpdate } from "../commands/update.js";
+
+// Aliases accepted for this command. Declared here, next to the command
+// itself — a global alias table would be wrong, since the same word means
+// different things under different commands ("rm" is remove under `agent`,
+// unset under `project config`, revoke under `pair`).
+export const aliases = ["upgrade"];
+
+export default async function route(rest, { parseArgs, VERSION }) {
+  await cmdUpdate(parseArgs(rest), VERSION);
+  return; // skip checkForUpdate after an update
+
+  // Refresh everything held in memory after a code change (e.g. a `git
+  // pull` in a dev checkout): restart the daemon, and restart the desktop
+  // too if it was running. The daemon picks up new code/prompts; the
+  // desktop picks up its new renderer/main.js. Token re-sync is automatic
+  // (the desktop WS re-reads daemon.token on reconnect).
+}

package/src/interfaces/cli/routes/voice.js

@@ -0,0 +1,17 @@
+// apx voice — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdVoiceListen, cmdVoiceProviders, cmdVoiceSay } from "../commands/voice.js";
+
+export default async function route(rest, { parseArgs, die }) {
+  const [sub, ...vRest] = rest;
+  const vArgs = parseArgs(vRest);
+  if (sub === "say")        { await cmdVoiceSay(vArgs); return; }
+  if (sub === "listen")     { await cmdVoiceListen(vArgs); return; }
+  if (sub === "providers" || sub === "list") { await cmdVoiceProviders(); return; }
+  die(`unknown voice sub-command: ${sub || "(missing)"}\nUsage: apx voice <say|listen|providers>`);
+  return;
+}

package/src/interfaces/desktop/main.js

@@ -124,7 +124,7 @@ function getAgentName() {
   return "Superagente";
 }
 
-function getWindowOrigin(height) {
+function getWindowOrigin(_height) {
   const display = screen.getPrimaryDisplay();
   const { workArea } = display;
   const pos = getPosition();
@@ -151,7 +151,6 @@ let overlayVisible = false;
 // Asset paths — real PNG logos (apx/assets/favicon/dark/*) copied to
 // src/interfaces/desktop/assets/ at install time.
 const TRAY_ICON_PATH      = path.join(__dirname, "assets", "tray-icon.png");      // 180×180 apple-touch
-const TRAY_ICON_REC_PATH  = path.join(__dirname, "assets", "tray-icon.png");      // same; tinted in JS
 const APP_ICON_PATH       = path.join(__dirname, "assets", "app-icon-180.png");   // dock / window icon
 
 // On macOS, hide from the dock AND from Cmd+Tab. "accessory" is the modern
@@ -510,7 +509,7 @@ ipcMain.handle("warmup-stt", async () => {
     const options = {
       hostname: DAEMON_HOST,
       port: DAEMON_PORT,
-      path: "/transcribe/warmup",
+      path: "/api/transcribe/warmup",
       method: "GET",
       headers: { ...(token ? { "Authorization": `Bearer ${token}` } : {}) },
     };
@@ -542,7 +541,7 @@ function transcribeChunk(buf, format, language) {
     const options = {
       hostname: DAEMON_HOST,
       port: DAEMON_PORT,
-      path: "/transcribe/chunk",
+      path: "/api/transcribe/chunk",
       method: "POST",
       headers: {
         "Content-Type": "application/octet-stream",
@@ -585,7 +584,7 @@ function connectDaemon() {
     return;
   }
 
-  const url = `ws://${DAEMON_HOST}:${DAEMON_PORT}/desktop/ws`;
+  const url = `ws://${DAEMON_HOST}:${DAEMON_PORT}/api/desktop/ws`;
 
   function connect() {
     // Re-read the token on EVERY attempt — the daemon regenerates
@@ -652,7 +651,7 @@ async function sendMessageToDaemon(text, previousMessages) {
     const options = {
       hostname: DAEMON_HOST,
       port: DAEMON_PORT,
-      path: "/desktop/message",
+      path: "/api/desktop/message",
       method: "POST",
       headers: {
         "Content-Type": "application/json",
@@ -699,7 +698,7 @@ function _ttsRequest(text, explicitProvider) {
     const options = {
       hostname: DAEMON_HOST,
       port: DAEMON_PORT,
-      path: "/tts/say",
+      path: "/api/tts/say",
       method: "POST",
       headers: {
         "Content-Type": "application/json",

package/src/interfaces/desktop/renderer.js

@@ -92,10 +92,6 @@
   // requestTts / second finalize on the same in-flight bubble.
   let doneHandled = false;
   let ttsTimer = null;
-  // Which agent turn (by message id) is waiting for its TTS audio to attach.
-  // We finalize the bubble immediately on `done`, then post-attach the
-  // scrubber when (or if) tts-ready arrives.
-  let pendingTtsTurnId = null;
 
   // ── Inline SVG icons (mirrors the design's I.* set) ──────────────────────
   const SVG = (path, attrs = {}) => {
@@ -727,7 +723,6 @@
     currentTurn++;
     resetTurnAudio();
     doneHandled = false;
-    pendingTtsTurnId = null;
     if (ttsTimer) { clearTimeout(ttsTimer); ttsTimer = null; }
   }
   function resetTurnAudio() {

package/src/interfaces/mcp-server/index.js

@@ -19,13 +19,14 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { findApfRoot } from "#core/apc/parser.js";
-import { ensureDaemon, http } from "../../cli/http.js";
+// Was "../../cli/http.js", which resolves to src/cli/http.js — a path that
+// does not exist, so this binary could not load at all. Use the alias
+// (AGENTS.md rule 7) so the same mistake cannot recur silently.
+import { ensureDaemon, http } from "#interfaces/cli/http.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-const PORT = parseInt(process.env.APX_PORT || "7430", 10);
-
 // ---------------------------------------------------------------------------
 // Resolve current project
 // ---------------------------------------------------------------------------
@@ -37,12 +38,12 @@ async function resolveProject() {
 
   // Ensure daemon is running and project is registered.
   await ensureDaemon({ silent: true });
-  const projects = await http.get("/projects");
+  const projects = await http.get("/api/projects");
   const match = projects.find((p) => path.resolve(p.path) === path.resolve(root));
   if (match) return match;
 
   // Register if not yet known.
-  const created = await http.post("/projects", { path: root });
+  const created = await http.post("/api/projects", { path: root });
   return created;
 }
 
@@ -62,7 +63,7 @@ server.tool(
   {},
   async () => {
     const proj = await resolveProject();
-    const agents = await http.get(`/projects/${proj.id}/agents`);
+    const agents = await http.get(`/api/projects/${proj.id}/agents`);
     const rows = agents.map(
       (a) => `${a.slug}  role=${a.role || "—"}  model=${a.model || "—"}`
     );
@@ -83,7 +84,7 @@ server.tool(
     const proj = await resolveProject();
     const body = { prompt };
     if (engine) body.engine = engine;
-    const result = await http.post(`/projects/${proj.id}/agents/${slug}/exec`, body);
+    const result = await http.post(`/api/projects/${proj.id}/agents/${slug}/exec`, body);
     return { content: [{ type: "text", text: result.output || JSON.stringify(result) }] };
   }
 );
@@ -100,7 +101,7 @@ server.tool(
   async ({ slug, prompt, runtime }) => {
     const proj = await resolveProject();
     const body = { prompt, runtime: runtime || "claude-code" };
-    const result = await http.post(`/projects/${proj.id}/agents/${slug}/runtime`, body);
+    const result = await http.post(`/api/projects/${proj.id}/agents/${slug}/runtime`, body);
     return { content: [{ type: "text", text: result.output || JSON.stringify(result) }] };
   }
 );
@@ -114,7 +115,7 @@ server.tool(
   },
   async ({ slug }) => {
     const proj = await resolveProject();
-    const mem = await http.get(`/projects/${proj.id}/agents/${slug}/memory`);
+    const mem = await http.get(`/api/projects/${proj.id}/agents/${slug}/memory`);
     return { content: [{ type: "text", text: mem.body_md || "(empty)" }] };
   }
 );
@@ -129,7 +130,7 @@ server.tool(
   },
   async ({ slug, fact }) => {
     const proj = await resolveProject();
-    await http.put(`/projects/${proj.id}/agents/${slug}/memory`, { append: fact });
+    await http.put(`/api/projects/${proj.id}/agents/${slug}/memory`, { append: fact });
     return { content: [{ type: "text", text: "OK" }] };
   }
 );
@@ -149,7 +150,7 @@ server.tool(
     if (channel) qs.set("channel", channel);
     if (agent) qs.set("agent", agent);
     if (limit) qs.set("limit", String(limit));
-    const msgs = await http.get(`/projects/${proj.id}/messages?${qs}`);
+    const msgs = await http.get(`/api/projects/${proj.id}/messages?${qs}`);
     const rows = (msgs.messages || msgs).map(
       (m) => `[${m.ts}] ${m.channel}/${m.direction} ${m.author || ""}: ${m.body}`
     );
@@ -168,7 +169,7 @@ server.tool(
   async ({ slug, limit }) => {
     const proj = await resolveProject();
     const qs = limit ? `?limit=${limit}` : "";
-    const sessions = await http.get(`/projects/${proj.id}/agents/${slug}/sessions${qs}`);
+    const sessions = await http.get(`/api/projects/${proj.id}/agents/${slug}/sessions${qs}`);
     const rows = (sessions.sessions || sessions).map(
       (s) => `${s.filename}  started=${s.started_at || "—"}  title=${s.title || "—"}`
     );
@@ -183,7 +184,7 @@ server.tool(
   {},
   async () => {
     const proj = await resolveProject();
-    const mcps = await http.get(`/projects/${proj.id}/mcps`);
+    const mcps = await http.get(`/api/projects/${proj.id}/mcps`);
     const rows = (mcps.mcps || mcps).map(
       (m) => `${m.name}  source=${m.source}  transport=${m.transport}  enabled=${m.enabled}`
     );
@@ -203,7 +204,7 @@ server.tool(
   async ({ server: serverName, tool, args }) => {
     const proj = await resolveProject();
     const result = await http.post(
-      `/projects/${proj.id}/mcps/${encodeURIComponent(serverName)}/call`,
+      `/api/projects/${proj.id}/mcps/${encodeURIComponent(serverName)}/call`,
       { tool, args: args || {} }
     );
     return {

package/src/interfaces/tui/_shims/globals.d.ts

@@ -0,0 +1,8 @@
+// Ambient globals for the vendored OpenCode TUI.
+//
+// The fork was written against Bun and still calls a few Bun APIs inside
+// `_shims/`. We run it on Node, so `Bun` has no type — which produced 13
+// TS2868 errors the moment the (previously broken) tsconfig started loading.
+// Declaring it loosely keeps the typecheck honest about everything else
+// without pulling @types/bun into a Node-only install.
+declare const Bun: any;

package/src/interfaces/tui/tsconfig.json

@@ -5,7 +5,10 @@
     "jsxImportSource": "@opentui/solid",
     "lib": ["ESNext", "DOM", "DOM.Iterable"],
     "noEmit": true,
-    "types": [],
+    // `types: []` used to be here; combined with the missing base config it
+    // stripped node globals and flooded the check with TS2591.
+    // TS 6 deprecated `baseUrl`; `paths` below resolve relative to this file.
+    "types": ["node"],
     "paths": {
       "@tui/*": ["./*"],
       "@/cli/cmd/tui/*": ["./*"],

package/src/interfaces/web/README.md

@@ -27,7 +27,7 @@ src/
 │   ├── api.ts               ← typed daemon client (Bearer auth)
 │   └── cn.ts                ← clsx + tailwind-merge
 ├── hooks/
-│   └── useTokenBootstrap.ts ← reads /admin/web-token on first paint
+│   └── useTokenBootstrap.ts ← reads /api/admin/web-token on first paint
 ├── components/
 │   ├── ProjectSidebar.tsx   ← rail of avatars (APX + projects)
 │   └── Section.tsx          ← card primitive + small UI atoms
@@ -44,11 +44,11 @@ Nothing new server-side. Mounting is done by `src/host/daemon/api/web.js`:
 - **Same origin / same port** as the daemon (default `127.0.0.1:7430`).
 - The daemon serves `dist/` from `/` and does an SPA fallback for unknown
   GETs that aren't an API prefix.
-- `GET /admin/web-token` returns the bearer for loopback callers, so the
+- `GET /api/admin/web-token` returns the bearer for loopback callers, so the
   panel can authenticate every subsequent request.
 
-In development, `pnpm dev` boots Vite on `:7431` and proxies `/projects`,
-`/telegram`, `/admin`, etc. → `127.0.0.1:7430`. Hot reload, real daemon.
+In development, `pnpm dev` boots Vite on `:7431` and proxies `/api` (the whole
+daemon surface, WebSocket included) → `127.0.0.1:7430`. Hot reload, real daemon.
 
 ## Project typology
 
@@ -95,8 +95,8 @@ read-only:
 - [ ] Edit per-project config inline (today: JSON viewer; needs form).
 - [ ] Create / edit telegram channels from the panel (today: list-only).
 - [ ] Run / enable / disable a routine from the panel (today: list).
-- [ ] Threads view: render `/projects/:pid/agents/:slug/conversations`.
-- [ ] APX self-chat surface (call /super-agent/chat/stream).
+- [ ] Threads view: render `/api/projects/:pid/agents/:slug/conversations`.
+- [ ] APX self-chat surface (call /api/super-agent/chat/stream).
 - [ ] Light theme toggle (tokens are there; missing the button).
 
 Adding any of these is a single screen edit + an existing daemon endpoint.