@profullstack/qryptchat 0.7.0 → 0.8.0

package/bin/qc.js

@@ -6,7 +6,7 @@ import { errorLine, exitWhenFlushed, main } from '../dist/commands.js';
 const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
 
 main(process.argv.slice(2), { version: pkg.version }).then(
-	() => exitWhenFlushed(0),
+	() => exitWhenFlushed(process.exitCode ?? 0),
 	(err) => {
 		process.stderr.write(`${errorLine(err)}\n`);
 		exitWhenFlushed(1);

package/dist/{chunk-bdg6cmfy.js → chunk-nrv1k5q2.js}

@@ -6,8 +6,11 @@ import {
   unlockSession,
   storeSession,
   clearSession,
-  notify
-} from "./chunk-g9xn5036.js";
+  notify,
+  PAIRUX_URL,
+  newVoiceRoomLink,
+  voiceMessage
+} from "./chunk-zc4n789c.js";
 
 // src/cli/crypto.js
 import { MlKem1024 as MlKem10242 } from "mlkem";
@@ -743,6 +746,9 @@ class QcClient {
       throw new QcError(`HTTP ${res.status}`, res.status);
     return res.text();
   }
+  async archive(conversationId, on = true) {
+    return this.request(`/api/conversations/${on ? "archive" : "unarchive"}`, { method: "POST", body: { conversationId } });
+  }
   async conversations() {
     const { conversations = [] } = await this.request("/api/conversations/load", { method: "POST", body: {} });
     return conversations.map((c) => ({ ...c, title: conversationTitle(c, this.me) }));
@@ -1181,6 +1187,55 @@ function who(user, { agent = false } = {}) {
   return `${face}${name}${handle}${pronouns}`;
 }
 
+// src/cli/voice.js
+import { spawn as spawn2 } from "node:child_process";
+var PAIRUX_INSTALL = "curl -fsSL https://installer.pairux.com/install.sh | bash";
+var VOICE_HELP = `qc voice: end-to-end encrypted voice rooms on PairUX (an alias for the pairux CLI)
+
+Usage:
+  qc voice [--send <chat>] [--json]   print a link to a fresh anonymous room; --send posts it to a chat.
+                                      Made on this machine: the key is in the #fragment, so PairUX
+                                      never sees it, and nobody needs an account to join.
+  qc voice login|logout|whoami        sign the pairux CLI in or out
+  qc voice join <CODE> | say | who | listen | status | leave | help
+                                      any other subcommand runs \`pairux <subcommand>\`
+
+The pairux CLI comes with the PairUX app: ${PAIRUX_INSTALL}
+PAIRUX_API_URL changes the server (default ${PAIRUX_URL}).`;
+function parseVoiceArgs(argv) {
+  const [first] = argv;
+  if (first === "help" || first === "--help" || first === "-h")
+    return { action: "help" };
+  if (first === undefined || first.startsWith("--") || first === "link" || first === "room" || first === "new") {
+    const rest = first && !first.startsWith("--") ? argv.slice(1) : argv;
+    const flags = { json: false, send: null };
+    for (let i = 0;i < rest.length; i++) {
+      if (rest[i] === "--json")
+        flags.json = true;
+      else if (rest[i] === "--send" && rest[i + 1])
+        flags.send = rest[++i];
+      else if (rest[i].startsWith("--send="))
+        flags.send = rest[i].slice(7);
+      else
+        throw new Error(`Unknown option "${rest[i]}" for qc voice.
+
+${VOICE_HELP}`);
+    }
+    return { action: "link", ...flags };
+  }
+  return { action: "pairux", args: argv };
+}
+var voiceLink = (env = process.env) => newVoiceRoomLink(env.PAIRUX_API_URL || PAIRUX_URL);
+function runPairux(args, { spawnImpl = spawn2, env = process.env } = {}) {
+  return new Promise((resolve, reject) => {
+    const child = spawnImpl(env.PAIRUX_BIN || "pairux", args, { stdio: "inherit", env });
+    child.on("error", (err) => {
+      reject(err.code === "ENOENT" ? new Error(`The pairux CLI is not installed. Install PairUX: ${PAIRUX_INSTALL}`) : err);
+    });
+    child.on("exit", (code, signal) => resolve(code ?? (signal ? 1 : 0)));
+  });
+}
+
 // src/cli/exit.js
 function exitWhenFlushed2(code, { timeoutMs = 30000 } = {}) {
   setTimeout(() => process.exit(code), timeoutMs);
@@ -1202,7 +1257,10 @@ Usage:
   qc profile [--emoji \uD83D\uDD2D] [--pronouns she/her] [--website URL] [--bio TEXT]
                           show or set your public profile (an empty value clears it);
                           --openprofile prints it as OpenProfile.md
-  qc chats                list your chats
+  qc chats [--archived]   list your chats (archived ones only with --archived)
+  qc archive <chat>       archive a chat for you (qc unarchive <chat> brings it back)
+  qc voice [--send <chat>]   a link to a fresh end-to-end encrypted PairUX voice room (no account
+                          needed to join); qc voice login|join|... runs the pairux CLI (qc voice help)
   qc read <chat> [-n 20]  print the last messages of a chat
   qc send <chat> <text>   send a message (text "-" reads stdin; --reply <message-id> to reply)
   qc react <chat> <message-id> <emoji> [--remove]   react to a message
@@ -1286,6 +1344,8 @@ async function main2(argv, { version = "0.0.0" } = {}) {
   const out = (line) => process.stdout.write(`${line}
 `);
   const json = (value) => out(JSON.stringify(value, null, flags.json === "compact" ? 0 : 2));
+  if (cmd === "voice")
+    return voiceCommand(argv.slice(argv.indexOf("voice") + 1), { out, json });
   if (flags.version)
     return out(`qc ${version}`);
   if (flags.help || cmd === "help")
@@ -1387,13 +1447,25 @@ ${info("Set: qc profile --emoji :telescope: --pronouns she/her --website https:/
     }
     case "chats":
     case "ls": {
-      const chats = await (await client(flags)).conversations();
+      const all = await (await client(flags)).conversations();
+      const chats = all.filter((c) => !!c.is_archived === !!flags.archived);
       if (flags.json)
         return json(chats.map((c) => ({ id: c.id, title: c.title, type: c.type, updated_at: c.updated_at, participants: c.participants?.length ?? 0 })));
       for (const c of chats)
         out(`${c.id}  ${mark(c.type === "group" ? "users" : "chat")}${c.title}`);
       return;
     }
+    case "archive":
+    case "unarchive": {
+      if (!rest[0])
+        throw new Error(`Usage: qc ${cmd} <chat>`);
+      const c = await client(flags);
+      const chat = findChat2(await c.conversations(), rest[0]);
+      await c.archive(chat.id, cmd === "archive");
+      if (flags.json)
+        return json({ id: chat.id, archived: cmd === "archive" });
+      return out(ok(cmd === "archive" ? `Archived ${chat.title}. qc chats --archived lists it; qc unarchive brings it back.` : `${chat.title} is back in your chats.`));
+    }
     case "read": {
       if (!rest[0])
         throw new Error("Usage: qc read <chat> [-n 20]");
@@ -1507,5 +1579,34 @@ ${info("Set: qc profile --emoji :telescope: --pronouns she/her --website https:/
 ${HELP2}`);
   }
 }
+async function voiceCommand(argv, { out, json }) {
+  const parsed = parseVoiceArgs(argv);
+  if (parsed.action === "help")
+    return out(VOICE_HELP);
+  if (parsed.action === "pairux") {
+    const code = await runPairux(parsed.args);
+    if (code)
+      process.exitCode = code;
+    return;
+  }
+  const url = voiceLink();
+  let sent = null;
+  if (parsed.send) {
+    const c = await client({});
+    const chat = findChat2(await c.conversations(), parsed.send);
+    const { skipped } = await c.send(chat.id, voiceMessage(url));
+    sent = { id: chat.id, title: chat.title, skipped };
+  }
+  if (parsed.json)
+    return json({ url, sent });
+  out(url);
+  if (sent) {
+    if (sent.skipped)
+      process.stderr.write(`qc: ${warn(`${sent.skipped} participant(s) have no key yet and will not see it.`)}
+`);
+    process.stderr.write(`qc: ${mark("send")}Sent to ${sent.title}.
+`);
+  }
+}
 
 export { exitWhenFlushed2, errorLine2, HELP2, parseArgs2, findChat2, main2 };

package/dist/{chunk-g9xn5036.js → chunk-zc4n789c.js}

@@ -214,4 +214,25 @@ function notify(title, body, { env = process.env, streams = [process.stdout, pro
   return Boolean(seq && tty);
 }
 
-export { DEFAULT_URL, configDir, sessionPath, baseUrl, loadSession, unlockSession, storeSession, clearSession, notify };
+// src/lib/chat/voice.js
+var PAIRUX_URL = "https://pairux.com";
+var toBase64Url = (bytes) => {
+  let s = "";
+  for (const b of bytes)
+    s += String.fromCharCode(b);
+  return btoa(s).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+};
+function newVoiceRoomLink(base = PAIRUX_URL) {
+  const room = toBase64Url(crypto.getRandomValues(new Uint8Array(16)));
+  const key = toBase64Url(crypto.getRandomValues(new Uint8Array(32)));
+  return `${String(base).replace(/\/$/, "")}/r/${room}#k=${key}`;
+}
+var voiceMessage = (url) => `\uD83C\uDF99️ Join my end-to-end encrypted voice room (no account needed): ${url}`;
+function parseSlashCommand(text, names) {
+  const m = /^\/([a-z]+)(?:\s+(.*))?$/s.exec(String(text).trim());
+  if (!m || !names.includes(m[1]))
+    return null;
+  return { name: m[1], args: (m[2] ?? "").trim() };
+}
+
+export { DEFAULT_URL, configDir, sessionPath, baseUrl, loadSession, unlockSession, storeSession, clearSession, notify, PAIRUX_URL, newVoiceRoomLink, voiceMessage, parseSlashCommand };

package/dist/commands.js

@@ -5,8 +5,8 @@ import {
   parseArgs2,
   findChat2,
   main2
-} from "./chunk-bdg6cmfy.js";
-import"./chunk-g9xn5036.js";
+} from "./chunk-nrv1k5q2.js";
+import"./chunk-zc4n789c.js";
 export {
   HELP2 as HELP,
   errorLine2 as errorLine,

package/dist/mcp.js

@@ -1,7 +1,7 @@
-import"./chunk-g9xn5036.js";
+import"./chunk-zc4n789c.js";
 import {
   findChat2
-} from "./chunk-bdg6cmfy.js";
+} from "./chunk-nrv1k5q2.js";
 
 // src/cli/mcp.js
 import { createInterface } from "node:readline";

package/dist/tui.js

@@ -1,12 +1,26 @@
 import {
   configDir,
-  notify
-} from "./chunk-g9xn5036.js";
+  notify,
+  PAIRUX_URL,
+  newVoiceRoomLink,
+  voiceMessage,
+  parseSlashCommand
+} from "./chunk-zc4n789c.js";
 
 // src/cli/tui.js
 import { createApp, createImageStore, drawIcon, drawRichText, editText, emojify, insertText, stringWidth, truncate, widgets, wrap } from "@profullstack/hqtui";
 import { readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
+
+// src/lib/chat/membership-events.js
+var MEMBERSHIP_EVENTS = {
+  JOINED: "PARTICIPANTS_JOINED",
+  LEFT: "PARTICIPANT_LEFT",
+  ARCHIVED: "CONVERSATION_ARCHIVED"
+};
+var CHAT_LIST_EVENTS = new Set(["CONVERSATION_CREATED", ...Object.values(MEMBERSHIP_EVENTS)]);
+
+// src/cli/tui.js
 var SIDEBAR = 30;
 function initialState(me) {
   return {
@@ -24,9 +38,17 @@ function initialState(me) {
     scrollBack: 0,
     status: "connecting",
     notice: "",
-    loading: true
+    loading: true,
+    showArchived: false
   };
 }
+var listed = (state) => state.conversations.filter((c) => !!c.is_archived === !!state.showArchived);
+var CHAT_LIST_REFRESH_MS = 15000;
+function chatsWithNews(prev, next) {
+  const seen = new Map(prev.map((c) => [c.id, c.updated_at ?? ""]));
+  return next.filter((c) => !seen.has(c.id) || (c.updated_at ?? "") > seen.get(c.id)).map((c) => c.id);
+}
+var SLASH_COMMANDS = ["voice", "archive", "unarchive", "archived"];
 var pad2 = (n) => String(n).padStart(2, "0");
 var timeOf = (iso) => {
   const d = new Date(iso);
@@ -132,10 +154,13 @@ function render({ ui, width, height, theme }, state, on = {}) {
   });
   ui.row({ size: "fill" }, (row) => {
     const listWidth = Math.min(SIDEBAR, Math.max(18, Math.floor(width * 0.3)));
-    row.panel({ title: "Chats", size: listWidth, borderColor: state.focus === "list" ? theme?.borderFocused : undefined }, (p) => {
+    const chats = listed(state);
+    const archivedCount = state.conversations.filter((c) => c.is_archived).length;
+    const listTitle = state.showArchived ? `Archived (${archivedCount})` : archivedCount ? `Chats · ${archivedCount} archived` : "Chats";
+    row.panel({ title: truncate(listTitle, Math.max(4, listWidth - 4)), size: listWidth, borderColor: state.focus === "list" ? theme?.borderFocused : undefined }, (p) => {
       const inner = Math.max(4, listWidth - 5);
       p.list({
-        items: state.conversations.map((c) => {
+        items: chats.map((c) => {
           const unread = state.unread[c.id] || 0;
           const tag = unread ? ` ●${unread > 99 ? "99+" : unread}` : "";
           const name = truncate(c.title, inner - stringWidth(tag));
@@ -177,6 +202,8 @@ function render({ ui, width, height, theme }, state, on = {}) {
       { key: "Ctrl+E", label: "emoji" },
       { key: "Tab", label: state.focus === "list" ? "compose" : "chats" },
       { key: "PgUp", label: "scroll" },
+      ...state.focus === "list" ? [{ key: "a", label: state.showArchived ? "unarchive" : "archive" }] : [],
+      { key: "Ctrl+O", label: state.showArchived ? "chats" : "archived" },
       { key: "Ctrl+C", label: "quit" }
     ],
     size: 1
@@ -241,16 +268,33 @@ async function runTui(client, { initialChat } = {}) {
     }
   }
   let keysChecked = false;
-  async function loadConversations() {
+  let listLoading = false;
+  async function loadConversations({ periodic = false } = {}) {
+    if (listLoading)
+      return;
+    listLoading = true;
     try {
       const before = state.activeId;
+      const prev = state.conversations;
       state.conversations = await client.conversations();
       state.loading = false;
-      if (!state.activeId && state.conversations.length) {
-        const want = initialChat ? state.conversations.findIndex((c) => c.id === initialChat || c.title.toLowerCase().includes(String(initialChat).toLowerCase())) : 0;
+      if (periodic) {
+        for (const id of chatsWithNews(prev, state.conversations)) {
+          if (id === state.activeId)
+            loadMessages(id);
+          else {
+            delete state.messages[id];
+            if (state.status !== "live" && prev.some((c) => c.id === id))
+              state.unread[id] = (state.unread[id] || 0) + 1;
+          }
+        }
+      }
+      const chats = listed(state);
+      if (!state.activeId && chats.length) {
+        const want = initialChat ? chats.findIndex((c) => c.id === initialChat || c.title.toLowerCase().includes(String(initialChat).toLowerCase())) : 0;
         openAt(Math.max(0, want));
       } else {
-        state.selected = Math.max(0, state.conversations.findIndex((c) => c.id === before));
+        state.selected = Math.max(0, chats.findIndex((c) => c.id === before));
       }
       redraw();
       if (!keysChecked) {
@@ -260,11 +304,14 @@ async function runTui(client, { initialChat } = {}) {
       }
     } catch (err) {
       state.loading = false;
-      note(err.status === 401 ? "Session ended: run qc login" : `Could not load chats: ${err.message}`);
+      if (!periodic || err.status === 401)
+        note(err.status === 401 ? "Session ended: run qc login" : `Could not load chats: ${err.message}`);
+    } finally {
+      listLoading = false;
     }
   }
   function openAt(i) {
-    const c = state.conversations[i];
+    const c = listed(state)[i];
     if (!c)
       return;
     state.selected = i;
@@ -285,8 +332,50 @@ async function runTui(client, { initialChat } = {}) {
       client.typing(state.activeId, true);
     }
   }
-  async function send() {
-    const text = emojify(state.field.value.trim(), { mode: "emoji" });
+  function toggleArchivedView() {
+    state.showArchived = !state.showArchived;
+    const chats = listed(state);
+    state.selected = Math.max(0, chats.findIndex((c) => c.id === state.activeId));
+    if (!state.showArchived && !chats.length)
+      note("No chats here yet.");
+    if (state.showArchived && !chats.length)
+      note("Nothing archived. Press a on a chat (or type /archive) to archive it.");
+    redraw();
+  }
+  async function setArchived(chat, on) {
+    try {
+      await client.archive(chat.id, on);
+      chat.is_archived = on;
+      const chats = listed(state);
+      state.selected = Math.max(0, Math.min(state.selected, chats.length - 1));
+      note(on ? `Archived ${chat.title} (Ctrl+O shows archived chats)` : `${chat.title} is back in your chats`);
+    } catch (err) {
+      note(`Could not ${on ? "archive" : "unarchive"}: ${err.message}`);
+    }
+  }
+  function runSlash(raw) {
+    const cmd = parseSlashCommand(raw, SLASH_COMMANDS);
+    if (!cmd)
+      return false;
+    const active = state.conversations.find((c) => c.id === state.activeId);
+    state.field = { value: "", cursor: 0 };
+    if (cmd.name === "archived")
+      toggleArchivedView();
+    else if (!active)
+      note("Pick a chat first");
+    else if (cmd.name === "voice") {
+      const url = newVoiceRoomLink(process.env.PAIRUX_API_URL || PAIRUX_URL);
+      state.field = { value: voiceMessage(url), cursor: 0 };
+      send({ raw: true }).then(() => note("Voice room posted; open the link in a browser to join", { sticky: false }));
+    } else
+      setArchived(active, cmd.name === "archive");
+    redraw();
+    return true;
+  }
+  async function send({ raw = false } = {}) {
+    if (!raw && runSlash(state.field.value))
+      return;
+    const text = raw ? state.field.value.trim() : emojify(state.field.value.trim(), { mode: "emoji" });
     if (!text || !state.activeId)
       return;
     const id = state.activeId;
@@ -350,9 +439,11 @@ async function runTui(client, { initialChat } = {}) {
     } else if (event.key === "pagedown") {
       handlers.scroll(-4);
     } else if (event.key === "ctrl+n" || event.key === "alt+down") {
-      openAt(Math.min(state.conversations.length - 1, state.selected + 1));
+      openAt(Math.min(listed(state).length - 1, state.selected + 1));
     } else if (event.key === "ctrl+p" || event.key === "alt+up") {
       openAt(Math.max(0, state.selected - 1));
+    } else if (event.key === "ctrl+o") {
+      toggleArchivedView();
     } else if (event.key === "ctrl+r") {
       loadConversations();
       if (state.activeId)
@@ -361,9 +452,14 @@ async function runTui(client, { initialChat } = {}) {
       if (event.key === "up" || event.key === "k")
         state.selected = Math.max(0, state.selected - 1);
       else if (event.key === "down" || event.key === "j")
-        state.selected = Math.min(state.conversations.length - 1, state.selected + 1);
+        state.selected = Math.min(listed(state).length - 1, state.selected + 1);
       else if (event.key === "enter" || event.key === "right" || event.key === "l")
         handlers.open(state.selected);
+      else if (event.key === "a") {
+        const c = listed(state)[state.selected];
+        if (c)
+          setArchived(c, !c.is_archived);
+      }
     } else if (event.key === "enter") {
       send();
     } else if (event.key === "up" && !state.field.value) {
@@ -386,7 +482,10 @@ async function runTui(client, { initialChat } = {}) {
     state.field = insertText(state.field, event.text);
     redraw();
   });
+  const listTimer = setInterval(() => loadConversations({ periodic: true }), CHAT_LIST_REFRESH_MS);
+  listTimer.unref?.();
   app.on("exit", () => {
+    clearInterval(listTimer);
     state.images?.clear();
     abort.abort();
   });
@@ -412,7 +511,7 @@ async function runTui(client, { initialChat } = {}) {
       if (i > 0) {
         const [c] = state.conversations.splice(i, 1);
         state.conversations.unshift(c);
-        state.selected = state.conversations.findIndex((x) => x.id === state.activeId);
+        state.selected = Math.max(0, listed(state).findIndex((x) => x.id === state.activeId));
       }
       if (i === -1)
         loadConversations();
@@ -430,7 +529,9 @@ async function runTui(client, { initialChat } = {}) {
         }, 6100);
       } else
         delete room[data.userId];
-    } else if (type === "CONVERSATION_CREATED") {
+    } else if (CHAT_LIST_EVENTS.has(type)) {
+      if (type === MEMBERSHIP_EVENTS.LEFT && data?.userId === client.me?.id && data?.conversationId === state.activeId)
+        state.activeId = null;
       loadConversations();
     }
     redraw();
@@ -442,10 +543,15 @@ async function runTui(client, { initialChat } = {}) {
     }
   }).catch((err) => note(err.message));
   await app.start();
+  clearInterval(listTimer);
   abort.abort();
 }
 export {
+  CHAT_LIST_REFRESH_MS,
+  SLASH_COMMANDS,
+  chatsWithNews,
   initialState,
+  listed,
   render,
   runTui,
   transcriptLines

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@profullstack/qryptchat",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "qc: qrypt.chat in your terminal. A full-screen end-to-end encrypted chat client (ML-KEM-1024), plus a scriptable CLI and an MCP server.",
   "type": "module",
   "bin": {