@agentprojectcontext/apx 1.54.0 → 1.55.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentprojectcontext/apx",
-  "version": "1.54.0",
+  "version": "1.55.0",
   "description": "APX — unified CLI + daemon for the Agent Project Context (APC) standard.",
   "publishConfig": {
     "access": "public"

package/src/core/stores/messages.js

@@ -591,6 +591,75 @@ export function readGlobalMessages({ channel, limit = 100, since } = {}) {
   return all.slice(-limit);
 }
 
+// ---------------------------------------------------------------------------
+// Global channel threads (super-agent chats surfaced in the web Chats sidebar)
+// ---------------------------------------------------------------------------
+// The global ledger is the source of truth for every super-agent turn outside
+// exec (telegram, web quick-chat, desktop, deck …). A "thread" is one
+// channel+day JSONL file — the same granularity the context window reads.
+
+const CHANNEL_NAME_RE = /^[a-z0-9_-]+$/i;
+
+// List every non-empty channel+day thread, newest-last-activity first.
+export function listGlobalThreads({ channels, _globalMessagesDir } = {}) {
+  const base = _globalMessagesDir || GLOBAL_MESSAGES_DIR;
+  if (!fs.existsSync(base)) return [];
+  const chans = (channels && channels.length
+    ? channels
+    : fs.readdirSync(base).filter((f) => {
+        try { return fs.statSync(path.join(base, f)).isDirectory(); } catch { return false; }
+      })
+  ).filter((c) => CHANNEL_NAME_RE.test(c));
+
+  const out = [];
+  for (const ch of chans) {
+    const dir = path.join(base, ch);
+    let files;
+    try { files = fs.readdirSync(dir); } catch { continue; }
+    for (const f of files) {
+      const m = f.match(/^(\d{4}-\d{2}-\d{2})\.jsonl$/);
+      if (!m) continue;
+      const msgs = parseDayJsonl(fs.readFileSync(path.join(dir, f), "utf8")).filter(
+        (r) => r.type === "user" || r.type === "agent"
+      );
+      if (!msgs.length) continue;
+      const firstUser = msgs.find((r) => r.type === "user");
+      const title = String((firstUser || msgs[0]).body || "")
+        .replace(/\s+/g, " ")
+        .trim()
+        .slice(0, 80);
+      out.push({
+        id: m[1],
+        channel: ch,
+        title: title || `${ch} · ${m[1]}`,
+        messages: msgs.length,
+        started_at: msgs[0].ts,
+        last_ts: msgs[msgs.length - 1].ts,
+      });
+    }
+  }
+  out.sort((a, b) => (b.last_ts || "").localeCompare(a.last_ts || ""));
+  return out;
+}
+
+// Read one channel+day thread shaped for the web chat viewer:
+// { id, channel, messages: [{ role, content, ts }] } — or null when missing.
+export function readGlobalThread({ channel, date, _globalMessagesDir } = {}) {
+  if (!CHANNEL_NAME_RE.test(String(channel || ""))) return null;
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(String(date || ""))) return null;
+  const base = _globalMessagesDir || GLOBAL_MESSAGES_DIR;
+  const file = path.join(base, channel, `${date}.jsonl`);
+  if (!fs.existsSync(file)) return null;
+  const messages = parseDayJsonl(fs.readFileSync(file, "utf8"))
+    .filter((r) => r.type === "user" || r.type === "agent")
+    .map((r) => ({
+      role: r.type === "user" ? "user" : "assistant",
+      content: r.body || "",
+      ts: r.ts,
+    }));
+  return { id: date, channel, messages };
+}
+
 // Wipe the cache and re-populate from APX project messages. Reads BOTH `.jsonl`
 // (current format) and `.md` (legacy). Called by rebuild.
 export function rebuildMessagesFromFs(db, projectRoot) {

package/src/host/daemon/api/conversations.js

@@ -1,11 +1,14 @@
 // Per-agent conversation surface: list, fetch, compact, and a2a /send.
 //   GET  /projects/:pid/agents/:slug/conversations
 //   GET  /projects/:pid/agents/:slug/conversations/:id
+//   GET  /projects/:pid/super-agent/threads                    (channel ledger)
+//   GET  /projects/:pid/super-agent/threads/:channel/:id
 //   POST /projects/:pid/agents/:slug/compact
 //   POST /projects/:pid/agents/:slug/conversations/:id/compact
 //   POST /projects/:pid/send                                   (agent-to-agent)
 import { readAgents } from "#core/apc/parser.js";
 import { listConversations, readConversation } from "#core/stores/conversations.js";
+import { listGlobalThreads, readGlobalThread } from "#core/stores/messages.js";
 import { compactConversation } from "#core/stores/conversations-compactor.js";
 import { replyAsAgent } from "#core/agent/a2a/reply.js";
 import { nowIso } from "./shared.js";
@@ -48,6 +51,28 @@ export function register(app, { project, config }) {
     });
   });
 
+  // ---- Super-agent channel threads ----
+  // The super-agent's chats (telegram, web quick-chat, desktop, deck …) live
+  // in the global per-channel ledger, not in per-agent conversation files.
+  // These endpoints surface that ledger as day-threads so the web Chats
+  // sidebar can list and reopen them.
+  app.get("/projects/:pid/super-agent/threads", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    res.json(listGlobalThreads());
+  });
+
+  app.get("/projects/:pid/super-agent/threads/:channel/:id", (req, res) => {
+    const p = project(req, res);
+    if (!p) return;
+    const thread = readGlobalThread({
+      channel: req.params.channel,
+      date: req.params.id,
+    });
+    if (!thread) return res.status(404).json({ error: "thread not found" });
+    res.json(thread);
+  });
+
   async function handleCompact(req, res, filename) {
     const p = project(req, res);
     if (!p) return;

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

@@ -0,0 +1,56 @@
+// `apx code` — launch the APX terminal coding assistant (Solid.js TUI).
+// The TUI runs its TypeScript source directly under bun; there is no
+// legacy readline fallback anymore (removed with the old sys.js chat).
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+import { spawnSync } from "node:child_process";
+import { resolveProjectId } from "./project.js";
+import { readConfig } from "#core/config/index.js";
+import { readIdentity } from "#core/identity/index.js";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TUI_SRC = resolve(__dirname, "../../tui/run.ts");
+
+export async function cmdCode(args) {
+  const pid = await resolveProjectId(args?.flags?.project);
+  const cfg = readConfig();
+  const id = readIdentity();
+
+  // Optional --agent <slug>: route chat to a project agent instead of the APX
+  // default. Empty / missing flag means default ("super-agent" mode).
+  const agentFlag = typeof args?.flags?.agent === "string" ? args.flags.agent.trim() : "";
+  const routedAgentSlug = agentFlag || null;
+  const defaultAgentLabel = id?.agent_name || cfg.super_agent?.name || "APX";
+
+  if (!existsSync(TUI_SRC)) {
+    throw new Error(
+      "apx code: TUI source not found at src/interfaces/tui/run.ts — reinstall with `npm i -g @agentprojectcontext/apx`."
+    );
+  }
+
+  // bun must resolve node_modules/tsconfig from the apx package root, so the
+  // spawn cwd stays there — but we pass the user's actual working directory
+  // (where they ran `apx code`) via --cwd so the TUI shows the real project
+  // path + git branch instead of apx/src.
+  const bunBin = process.env.BUN_PATH || "bun";
+  const userCwd = process.cwd();
+  const result = spawnSync(bunBin, [
+    "--preload", "@opentui/solid/preload",
+    TUI_SRC,
+    "--pid", pid,
+    "--agent", routedAgentSlug || defaultAgentLabel,
+    "--model", cfg.super_agent?.model || "claude-3-5-sonnet",
+    "--cwd", userCwd,
+  ], { stdio: "inherit", cwd: resolve(__dirname, "../../..") });
+
+  if (result.error?.code === "ENOENT") {
+    throw new Error(
+      "apx code: bun is required to run the TUI but was not found. Install it (https://bun.sh) or set BUN_PATH to the binary."
+    );
+  }
+  if (result.error) throw result.error;
+  if (typeof result.status === "number" && result.status !== 0) {
+    process.exitCode = result.status;
+  }
+}

package/src/interfaces/cli/index.js

@@ -90,7 +90,7 @@ import {
   cmdConversationsList,
   cmdConversationsGet,
 } from "./commands/chat.js";
-import { cmdSys as cmdCode } from "./commands/sys.js";
+import { cmdCode } from "./commands/code.js";
 import { cmdRun, cmdEnvDetect } from "./commands/runtime.js";
 import { cmdSend, cmdConnections } from "./commands/a2a.js";
 import {