@agentprojectcontext/apx 1.77.3 → 1.78.0

package/src/host/daemon/stt-venv.js

@@ -1,27 +1,33 @@
-// Dedicated Python virtualenv for the STT engines.
+// Which Python runs whisper-server.py.
 //
-// We never install into the system or user-site Python — mlx-whisper drags in
+// APX owns a dedicated virtualenv at ~/.apx/runtime/whisper-venv rather than
+// installing into the system or user-site Python: mlx-whisper drags in
 // torch/scipy/numba and would pollute (or clash with) the user's other
-// projects. Instead APX owns ~/.apx/runtime/whisper-venv: create it, install
-// faster-whisper / mlx-whisper into it, and spawn whisper-server.py with its
-// interpreter. "Reset the engine" = delete the folder and recreate it.
-import os from "node:os";
+// projects.
+//
+// This module used to also create that venv and pip-install into it
+// (ensureVenv, pipInstall, venvHasModule, removeVenv, ENGINE_PACKAGES). None of
+// it was ever called — the installer path was built and then superseded — so it
+// was ~120 lines of dead code sitting next to a live one-liner. Removed. If
+// venv provisioning comes back, it belongs in its own module with a caller.
 import path from "node:path";
 import fs from "node:fs";
-import { spawn } from "node:child_process";
-
-export const VENV_DIR = path.join(os.homedir(), ".apx", "runtime", "whisper-venv");
+import { WHISPER_VENV_DIR } from "#core/config/paths.js";
 
 /** Path to the venv's python (…/bin/python on POSIX, …/Scripts on Windows). */
-export function venvPython() {
+function venvPython() {
   return process.platform === "win32"
-    ? path.join(VENV_DIR, "Scripts", "python.exe")
-    : path.join(VENV_DIR, "bin", "python");
+    ? path.join(WHISPER_VENV_DIR, "Scripts", "python.exe")
+    : path.join(WHISPER_VENV_DIR, "bin", "python");
 }
 
 /** True once the venv has a usable interpreter. */
-export function venvExists() {
-  try { return fs.existsSync(venvPython()); } catch { return false; }
+function venvExists() {
+  try {
+    return fs.existsSync(venvPython());
+  } catch {
+    return false;
+  }
 }
 
 /**
@@ -31,70 +37,3 @@ export function venvExists() {
 export function pythonForWhisper() {
   return venvExists() ? venvPython() : "python3";
 }
-
-function run(cmd, args, onLine) {
-  return new Promise((resolve) => {
-    let proc;
-    try {
-      proc = spawn(cmd, args, { stdio: ["ignore", "pipe", "pipe"] });
-    } catch (e) {
-      onLine?.(`spawn failed: ${e.message}`);
-      return resolve({ ok: false, code: -1 });
-    }
-    const pump = (chunk) => {
-      for (const line of chunk.toString().split(/\r?\n/)) {
-        if (line.trim()) onLine?.(line);
-      }
-    };
-    proc.stdout.on("data", pump);
-    proc.stderr.on("data", pump);
-    proc.on("exit", (code) => resolve({ ok: code === 0, code }));
-    proc.on("error", (e) => { onLine?.(e.message); resolve({ ok: false, code: -1 }); });
-  });
-}
-
-/** Create the venv (idempotent). Streams progress lines to onLine. */
-export async function ensureVenv(onLine) {
-  if (venvExists()) return { ok: true, created: false };
-  fs.mkdirSync(path.dirname(VENV_DIR), { recursive: true });
-  onLine?.(`creating venv at ${VENV_DIR}…`);
-  const r = await run("python3", ["-m", "venv", VENV_DIR], onLine);
-  if (!r.ok || !venvExists()) return { ok: false, error: "venv creation failed" };
-  // Upgrade pip once so wheel resolution is fast/modern.
-  await run(venvPython(), ["-m", "pip", "install", "--upgrade", "pip", "wheel"], onLine);
-  return { ok: true, created: true };
-}
-
-/** Is a module importable inside the venv? */
-export function venvHasModule(mod) {
-  return new Promise((resolve) => {
-    if (!venvExists()) return resolve(false);
-    const p = spawn(venvPython(), ["-c", `import ${mod}`], { stdio: "ignore" });
-    p.on("exit", (code) => resolve(code === 0));
-    p.on("error", () => resolve(false));
-  });
-}
-
-/** pip install <pkgs> into the venv, streaming progress. Creates the venv first. */
-export async function pipInstall(pkgs, onLine) {
-  const ensured = await ensureVenv(onLine);
-  if (!ensured.ok) return ensured;
-  const list = Array.isArray(pkgs) ? pkgs : [pkgs];
-  onLine?.(`installing ${list.join(", ")}…`);
-  const r = await run(venvPython(), ["-m", "pip", "install", "--upgrade", ...list], onLine);
-  return { ok: r.ok, code: r.code };
-}
-
-/** Delete the whole venv (so the engine can be reinstalled clean). */
-export async function removeVenv(onLine) {
-  if (!fs.existsSync(VENV_DIR)) return { ok: true, removed: false };
-  onLine?.(`removing ${VENV_DIR}…`);
-  await fs.promises.rm(VENV_DIR, { recursive: true, force: true });
-  return { ok: !fs.existsSync(VENV_DIR), removed: true };
-}
-
-/** Engine → the pip package(s) it needs in the venv. */
-export const ENGINE_PACKAGES = {
-  faster: ["faster-whisper"],
-  mlx: ["mlx-whisper"],
-};

package/src/host/daemon/wakeup.js

@@ -18,7 +18,7 @@ export function detectLanguage(identity, config) {
   if (cfgLang) return ISO_TO_LANGUAGE[cfgLang.toLowerCase()] || cfgLang;
   if (identity?.language) return identity.language;
   const lang = process.env.LANG || process.env.LC_MESSAGES || process.env.LC_ALL || "";
-  const code = lang.split(/[_\.]/)[0].toLowerCase();
+  const code = lang.split(/[_.]/)[0].toLowerCase();
   return ISO_TO_LANGUAGE[code] || "English";
 }
 

package/src/interfaces/acp/index.js

@@ -6,7 +6,7 @@
 //
 // Like the mcp-server surface, this is a thin adapter over the daemon HTTP
 // API: each `session/prompt` becomes a POST to the NDJSON stream endpoint
-// `/projects/:pid/super-agent/chat/stream` and the stream events are mapped
+// `/api/projects/:pid/super-agent/chat/stream` and the stream events are mapped
 // onto ACP `session/update` notifications:
 //
 //   assistant_text         → agent_message_chunk
@@ -179,7 +179,7 @@ export class AcpAgentServer {
     session.activeTurn = turn;
     try {
       const final = await this.client.streamPost(
-        `/projects/${session.project.id}/super-agent/chat/stream`,
+        `/api/projects/${session.project.id}/super-agent/chat/stream`,
         {
           prompt: promptText,
           // ACP clients are coding surfaces (IDEs) — the `code` channel gives
@@ -314,7 +314,7 @@ export class AcpAgentServer {
     }
     try {
       await this.client.post(
-        `/super-agent/confirm/${encodeURIComponent(event.correlationId)}`,
+        `/api/super-agent/confirm/${encodeURIComponent(event.correlationId)}`,
         { confirmed }
       );
     } catch (e) {

package/src/interfaces/acp/session.js

@@ -129,12 +129,12 @@ export async function resolveProjectForCwd(client, cwd) {
       `No APC project found at or above: ${cwd}. Run \`apx init\` in the workspace first.`
     );
   }
-  const projects = await client.get("/projects");
+  const projects = await client.get("/api/projects");
   const match = (projects || []).find(
     (p) => path.resolve(p.path) === path.resolve(root)
   );
   if (match) return match;
-  return client.post("/projects", { path: root });
+  return client.post("/api/projects", { path: root });
 }
 
 /** Flatten an ACP prompt (ContentBlock[]) into the text the daemon expects. */

package/src/interfaces/cli/commands/a2a.js

@@ -26,7 +26,7 @@ export async function cmdSend(args) {
   if (!body) throw new Error("apx send: body is empty");
 
   const pid = await resolveProjectId(args?.flags?.project);
-  const result = await http.post(`/projects/${pid}/send`, {
+  const result = await http.post(`/api/projects/${pid}/send`, {
     from,
     to,
     body,
@@ -48,7 +48,7 @@ export async function cmdConnections(args) {
   const slug = args._[0];
   if (!slug) throw new Error("apx connections: missing <agent-slug>");
   const pid = await resolveProjectId(args?.flags?.project);
-  const peers = await http.get(`/projects/${pid}/agents/${slug}/connections`);
+  const peers = await http.get(`/api/projects/${pid}/agents/${slug}/connections`);
   if (peers.length === 0) {
     console.log(`(no connections logged for ${slug} yet)`);
     return;

package/src/interfaces/cli/commands/agent.js

@@ -24,9 +24,9 @@ function requireRoot() {
 async function nudgeDaemon(root) {
   try {
     if (!(await http.ping())) return;
-    const projects = await http.get("/projects", { autoStart: false });
+    const projects = await http.get("/api/projects", { autoStart: false });
     const me = projects.find((p) => p.path === root);
-    if (me) await http.post(`/projects/${me.id}/rebuild`, undefined, { autoStart: false });
+    if (me) await http.post(`/api/projects/${me.id}/rebuild`, undefined, { autoStart: false });
   } catch { /* daemon hiccup */ }
 }
 
@@ -116,7 +116,7 @@ export async function cmdAgentRemove(args) {
     }
   }
   const pid = await resolveProjectId(args?.flags?.project);
-  await http.delete(`/projects/${pid}/agents/${slug}`);
+  await http.delete(`/api/projects/${pid}/agents/${slug}`);
   console.log(`${tag("removed")}  ${bold(slug)}  ${gray("(agent file + runtime memory deleted)")}`);
 }
 

package/src/interfaces/cli/commands/artifact.js

@@ -51,13 +51,13 @@ export async function cmdArtifactCreate(args) {
   if (!name) throw new Error("apx artifact create: missing <name>");
   const pid = await resolveProjectId(args?.flags?.project);
   const content = args.flags.content && args.flags.content !== true ? String(args.flags.content) : "";
-  const r = await http.post(`/projects/${pid}/artifacts`, { name, content });
+  const r = await http.post(`/api/projects/${pid}/artifacts`, { name, content });
   console.log(r.path);
 }
 
 export async function cmdArtifactList(args = {}) {
   const pid = await resolveProjectId(args?.flags?.project);
-  const rows = await http.get(`/projects/${pid}/artifacts`);
+  const rows = await http.get(`/api/projects/${pid}/artifacts`);
   if (rows.length === 0) {
     console.log(`(no artifacts in project #${pid})`);
     return;
@@ -77,7 +77,7 @@ export async function cmdArtifactShow(args) {
   const name = args._[0];
   if (!name) throw new Error("apx artifact show: missing <name>");
   const pid = await resolveProjectId(args?.flags?.project);
-  const r = await http.get(`/projects/${pid}/artifacts/${encodeURIComponent(name)}`);
+  const r = await http.get(`/api/projects/${pid}/artifacts/${encodeURIComponent(name)}`);
   process.stdout.write(r.content);
 }
 
@@ -85,7 +85,7 @@ export async function cmdArtifactRemove(args) {
   const name = args._[0];
   if (!name) throw new Error("apx artifact remove: missing <name>");
   const pid = await resolveProjectId(args?.flags?.project);
-  await http.delete(`/projects/${pid}/artifacts/${encodeURIComponent(name)}`);
+  await http.delete(`/api/projects/${pid}/artifacts/${encodeURIComponent(name)}`);
   console.log(`removed artifact "${name}"`);
 }
 
@@ -106,7 +106,7 @@ export async function cmdArtifactRun(args) {
   // Pull the artifact record from the daemon for the absolute path.
   let entry;
   try {
-    entry = await http.get(`/projects/${pid}/artifacts/${encodeURIComponent(name)}`);
+    entry = await http.get(`/api/projects/${pid}/artifacts/${encodeURIComponent(name)}`);
   } catch (e) {
     throw new Error(`artifact "${name}" not found in project #${pid}: ${e.message}`);
   }
@@ -170,7 +170,7 @@ export async function cmdArtifactPreview(args) {
   let view;
   try {
     view = await http.post(
-      `/projects/${pid}/artifacts/${encodeURIComponent(name)}/preview`,
+      `/api/projects/${pid}/artifacts/${encodeURIComponent(name)}/preview`,
       { watch }
     );
   } catch (e) {
@@ -196,7 +196,7 @@ export async function cmdArtifactPreview(args) {
 async function sharePreview(previewId, { open: doOpen = false } = {}) {
   let tunnel;
   try {
-    tunnel = await http.post(`/previews/${previewId}/tunnel`, {});
+    tunnel = await http.post(`/api/previews/${previewId}/tunnel`, {});
   } catch (e) {
     throw new Error(`could not create tunnel: ${e.message}`);
   }
@@ -217,7 +217,7 @@ export async function cmdArtifactShare(args) {
   const watch = args.flags["no-watch"] ? false : true;
 
   const view = await http.post(
-    `/projects/${pid}/artifacts/${encodeURIComponent(name)}/preview`,
+    `/api/projects/${pid}/artifacts/${encodeURIComponent(name)}/preview`,
     { watch }
   );
   console.log(`sharing ${view.kind} artifact "${view.name}"`);
@@ -227,8 +227,8 @@ export async function cmdArtifactShare(args) {
 }
 
 // `apx artifact previews` — list running preview servers.
-export async function cmdArtifactPreviews(args = {}) {
-  const rows = await http.get(`/previews`);
+export async function cmdArtifactPreviews(_args = {}) {
+  const rows = await http.get(`/api/previews`);
   if (!rows.length) {
     console.log("(no running previews)");
     return;
@@ -247,13 +247,13 @@ export async function cmdArtifactPreviews(args = {}) {
 // `apx artifact stop <id> | --all` — stop preview server(s).
 export async function cmdArtifactStop(args) {
   if (args.flags.all) {
-    const rows = await http.get(`/previews`);
-    for (const r of rows) await http.delete(`/previews/${r.id}`);
+    const rows = await http.get(`/api/previews`);
+    for (const r of rows) await http.delete(`/api/previews/${r.id}`);
     console.log(`stopped ${rows.length} preview(s)`);
     return;
   }
   const id = args._[0];
   if (!id) throw new Error("apx artifact stop: missing <id> (or --all)");
-  await http.delete(`/previews/${encodeURIComponent(id)}`);
+  await http.delete(`/api/previews/${encodeURIComponent(id)}`);
   console.log(`stopped preview ${id}`);
 }

package/src/interfaces/cli/commands/chat.js

@@ -42,7 +42,7 @@ export async function cmdChat(args) {
       if (convId) body.conversation_id = convId;
       if (overrideModel) body.model = overrideModel;
 
-      const result = await http.post(`/projects/${pid}/agents/${slug}/chat`, body);
+      const result = await http.post(`/api/projects/${pid}/agents/${slug}/chat`, body);
       convId = result.conversation_id;
       process.stdout.write("\n" + result.text + "\n\n");
     } catch (e) {
@@ -61,7 +61,7 @@ export async function cmdConversationsList(args) {
   // No slug → the super-agent (default conversational agent).
   const slug = args._[0] || superAgentSlug();
   const pid = await resolveProjectId(args?.flags?.project);
-  const rows = await http.get(`/projects/${pid}/agents/${slug}/conversations`);
+  const rows = await http.get(`/api/projects/${pid}/agents/${slug}/conversations`);
   if (rows.length === 0) {
     console.log(`(no conversations for ${slug})`);
     return;
@@ -85,7 +85,7 @@ export async function cmdConversationsGet(args) {
   else { slug = superAgentSlug(); id = args._[0]; }
   if (!id) throw new Error("apx conversations get: usage: apx conversations get [<agent>] <id>");
   const pid = await resolveProjectId(args?.flags?.project);
-  const conv = await http.get(`/projects/${pid}/agents/${slug}/conversations/${id}`);
+  const conv = await http.get(`/api/projects/${pid}/agents/${slug}/conversations/${id}`);
   process.stdout.write(`# Conversation ${id} (${slug})\n`);
   for (const t of conv.turns) {
     process.stdout.write(`\n## ${t.role} — ${t.ts}\n${t.content}\n`);

package/src/interfaces/cli/commands/command.js

@@ -18,7 +18,7 @@ async function resolveCommandRoot(args = {}) {
   const explicitProject = args?.flags?.project;
   if (explicitProject !== undefined && explicitProject !== null && explicitProject !== "") {
     const pid = await resolveProjectId(explicitProject);
-    const projects = await http.get("/projects");
+    const projects = await http.get("/api/projects");
     const project = projects.find((p) => p.id === pid);
     if (!project) throw new Error(`project ${pid} not found`);
     return project.path;
@@ -28,7 +28,7 @@ async function resolveCommandRoot(args = {}) {
   if (root) return root;
 
   const pid = await resolveProjectId();
-  const projects = await http.get("/projects");
+  const projects = await http.get("/api/projects");
   const project = projects.find((p) => p.id === pid);
   if (!project) throw new Error(`project ${pid} not found`);
   return project.path;

package/src/interfaces/cli/commands/config.js

@@ -1,7 +1,7 @@
 import { http } from "../http.js";
 import { resolveProjectId } from "./project.js";
 import { readConfig, writeConfig } from "#core/config/index.js";
-import { PERMISSION_MODES, DEFAULT_PERMISSION_MODE } from "#core/constants/permissions.js";
+import { DEFAULT_PERMISSION_MODE } from "#core/constants/permissions.js";
 
 function parseValue(raw) {
   // best-effort: try JSON first (covers numbers, bools, objects, arrays, null,
@@ -15,7 +15,7 @@ function parseValue(raw) {
 
 export async function cmdConfigShow(args) {
   const pid = await resolveProjectId(args?.flags?.project);
-  const data = await http.get(`/projects/${pid}/config`);
+  const data = await http.get(`/api/projects/${pid}/config`);
   if (args.flags.effective) {
     process.stdout.write(JSON.stringify(data.effective, null, 2) + "\n");
     return;
@@ -45,7 +45,7 @@ export async function cmdConfigSet(args) {
   }
   const pid = await resolveProjectId(args?.flags?.project);
   const value = parseValue(valueRaw);
-  await http.patch(`/projects/${pid}/config`, { set: { [key]: value } });
+  await http.patch(`/api/projects/${pid}/config`, { set: { [key]: value } });
   console.log(`set ${key} = ${JSON.stringify(value)}`);
 }
 
@@ -53,7 +53,7 @@ export async function cmdConfigUnset(args) {
   const key = args._[0];
   if (!key) throw new Error("apx config unset: usage: apx config unset <key.path>");
   const pid = await resolveProjectId(args?.flags?.project);
-  await http.patch(`/projects/${pid}/config`, { unset: [key] });
+  await http.patch(`/api/projects/${pid}/config`, { unset: [key] });
   console.log(`unset ${key}`);
 }
 

package/src/interfaces/cli/commands/daemon.js

@@ -1,6 +1,5 @@
 import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
+import { PID_PATH, LOG_PATH } from "#core/config/paths.js";
 import { ensureDaemon, http } from "../http.js";
 
 // Wait until nothing answers on the daemon port (old process fully exited and
@@ -13,8 +12,8 @@ async function waitForPortReleased({ tries = 40, intervalMs = 150 } = {}) {
   return false;
 }
 
-const PID_PATH = path.join(os.homedir(), ".apx", "daemon.pid");
-const LOG_PATH = path.join(os.homedir(), ".apx", "daemon.log");
+
+
 
 // ── ANSI helpers ─────────────────────────────────────────────────────────────
 const c = {
@@ -56,8 +55,8 @@ function debugRaw(label, data) {
 export async function cmdDaemonStart(args = {}) {
   const debug = args.flags?.debug;
   await ensureDaemon();
-  const status = await http.get("/health");
-  if (debug) debugRaw("/health", status);
+  const status = await http.get("/api/health");
+  if (debug) debugRaw("/api/health", status);
   console.log(
     `\n  ${fmt.green("●")} ${fmt.bold("apx daemon")} ${fmt.dim("v" + status.version)}` +
     `  ${fmt.gray("·")}  ${fmt.cyan("port")} ${status.port ?? (process.env.APX_PORT || 7430)}` +
@@ -77,13 +76,13 @@ export async function cmdDaemonStatus(args = {}) {
     process.exit(1);
   }
 
-  const h        = await http.get("/health",   { autoStart: false });
-  const projects = await http.get("/projects", { autoStart: false });
+  const h        = await http.get("/api/health",   { autoStart: false });
+  const projects = await http.get("/api/projects", { autoStart: false });
   const pid      = fs.existsSync(PID_PATH) ? fs.readFileSync(PID_PATH, "utf8").trim() : "?";
 
   if (debug) {
-    debugRaw("/health",   h);
-    debugRaw("/projects", projects);
+    debugRaw("/api/health",   h);
+    debugRaw("/api/projects", projects);
   }
 
   console.log(
@@ -113,8 +112,8 @@ export async function cmdDaemonReload(args = {}) {
     console.log(`\n  ${fmt.yellow("○")} ${fmt.bold("apx daemon")}  ${fmt.dim("not running — start first")}\n`);
     process.exit(1);
   }
-  const res = await http.post("/admin/reload", undefined, { autoStart: false });
-  if (debug) debugRaw("/admin/reload", res);
+  const res = await http.post("/api/admin/reload", undefined, { autoStart: false });
+  if (debug) debugRaw("/api/admin/reload", res);
   console.log(`\n  ${fmt.green("↻")} ${fmt.bold("config reloaded")}`);
   if (res.super_agent_model) console.log(fmt.kv("model", fmt.cyan(res.super_agent_model)));
   if (res.fallback_order?.length) console.log(fmt.kv("fallback", fmt.cyan(res.fallback_order.join(" → "))));
@@ -129,8 +128,8 @@ export async function cmdDaemonRestart(args = {}) {
     // Ask the daemon to shut down cleanly; fall back to a PID kill if the
     // HTTP shutdown route is unreachable (same fallback as `stop`).
     try {
-      const res = await http.post("/admin/shutdown", undefined, { autoStart: false });
-      if (debug) debugRaw("/admin/shutdown", res);
+      const res = await http.post("/api/admin/shutdown", undefined, { autoStart: false });
+      if (debug) debugRaw("/api/admin/shutdown", res);
     } catch {
       if (fs.existsSync(PID_PATH)) {
         try {
@@ -154,8 +153,8 @@ export async function cmdDaemonRestart(args = {}) {
   }
 
   await ensureDaemon({ silent: true });
-  const status = await http.get("/health", { autoStart: false });
-  if (debug) debugRaw("/health", status);
+  const status = await http.get("/api/health", { autoStart: false });
+  if (debug) debugRaw("/api/health", status);
   console.log(
     `\n  ${fmt.green("●")} ${fmt.bold("apx daemon")} ${fmt.dim("v" + status.version)}` +
     `  ${fmt.gray("·")}  ${fmt.green(wasRunning ? "restarted" : "started")}` +
@@ -173,8 +172,8 @@ export async function cmdDaemonStop(args = {}) {
   }
 
   try {
-    const res = await http.post("/admin/shutdown", undefined, { autoStart: false });
-    if (debug) debugRaw("/admin/shutdown", res);
+    const res = await http.post("/api/admin/shutdown", undefined, { autoStart: false });
+    if (debug) debugRaw("/api/admin/shutdown", res);
     console.log(`\n  ${fmt.red("○")} ${fmt.bold("apx daemon")}  ${fmt.dim("stopped")}\n`);
   } catch {
     if (fs.existsSync(PID_PATH)) {

package/src/interfaces/cli/commands/desktop.js

@@ -1,8 +1,8 @@
 // apx desktop — launch/manage the floating voice desktop window (Electron).
 import fs from "node:fs";
-import os from "node:os";
 import path from "node:path";
-import { spawn, execFileSync } from "node:child_process";
+import { DESKTOP_LOG_PATH, CONFIG_PATH } from "#core/config/paths.js";
+import { spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { http } from "../http.js";
 import {
@@ -11,18 +11,11 @@ import {
   autostartUninstall,
   getApxRunner as _getApxRunner,
   buildPlist as _buildPlist,
-  MAC_PLIST_PATH,
-  LINUX_DESKTOP_PATH,
-  WIN_RUN_KEY,
-  WIN_RUN_NAME,
 } from "#core/desktop/autostart.js";
 import {
   DESKTOP_MAIN,
-  readPid, writePid, clearPid, pidAlive, isDesktopRunning,
-  findElectron as _findElectron,
+  readPid, writePid, clearPid, pidAlive, findElectron as _findElectron,
   buildElectronSpawn as _buildElectronSpawn,
-  startDesktopDetached,
-  stopDesktop,
 } from "#core/desktop/process.js";
 
 // Re-exports — kept so existing tests (tests/desktop-autostart.test.js)
@@ -75,13 +68,13 @@ export async function cmdDesktopStart(args = {}) {
   // Get daemon port from running daemon or env
   let daemonPort = process.env.APX_PORT || "7430";
   try {
-    const health = await http.get("/health").catch(() => null);
+    const health = await http.get("/api/health").catch(() => null);
     if (health?.port) daemonPort = String(health.port);
   } catch {}
 
   const { cmd, argv } = buildElectronSpawn(electronDescriptor, DESKTOP_MAIN, daemonPort);
 
-  const logFile = path.join(os.homedir(), ".apx", "desktop.log");
+  const logFile = DESKTOP_LOG_PATH;
 
   if (debug) {
     // ── Debug mode: start desktop normally, then tail -f the log ─────────
@@ -191,7 +184,7 @@ export async function cmdDesktopStart(args = {}) {
   // Read configured shortcut (if any) for display
   let shortcutHint = "⌘G (macOS) / Ctrl+G (Win/Linux)";
   try {
-    const cfg = JSON.parse(fs.readFileSync(path.join(os.homedir(), ".apx", "config.json"), "utf8"));
+    const cfg = JSON.parse(fs.readFileSync(CONFIG_PATH, "utf8"));
     const sc = cfg?.desktop?.shortcut || cfg?.overlay?.shortcut;
     if (sc) shortcutHint = sc;
   } catch {}
@@ -254,7 +247,7 @@ export async function cmdDesktopStatus(_args = {}) {
 
   let daemonClients = 0;
   try {
-    const s = await http.get("/desktop/status").catch(() => null);
+    const s = await http.get("/api/desktop/status").catch(() => null);
     daemonClients = s?.connected_clients ?? 0;
   } catch {}
 

package/src/interfaces/cli/commands/exec.js

@@ -171,7 +171,7 @@ export async function cmdExec(args) {
     let result;
     try {
       result = await http.streamPost(
-        `/projects/${pid}/super-agent/chat/stream`,
+        `/api/projects/${pid}/super-agent/chat/stream`,
         { ...body, confirm: false },
         (event) => status.set(labelForEvent(event))
       );
@@ -187,7 +187,7 @@ export async function cmdExec(args) {
     return;
   }
 
-  const result = await http.post(`/projects/${pid}/agents/${slug}/exec`, body);
+  const result = await http.post(`/api/projects/${pid}/agents/${slug}/exec`, body);
 
   process.stdout.write(result.text + "\n");
   if (process.stderr.isTTY || args.flags.verbose) {

package/src/interfaces/cli/commands/log.js

@@ -10,11 +10,10 @@
 // here, regardless of which module produced it (telegram, whisper, super-agent…).
 
 import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
+import { APX_LOG_PATH, ERROR_TRACE_PATH } from "#core/config/paths.js";
+
+
 
-const APX_LOG_PATH = path.join(os.homedir(), ".apx", "logs", "apx.log");
-const ERROR_TRACE_PATH = path.join(os.homedir(), ".apx", "logs", "errors.jsonl");
 
 const c = {
   reset: "\x1b[0m", bold: "\x1b[1m", dim: "\x1b[2m",