@profullstack/qryptchat 0.6.0 → 0.6.2

package/bin/qc.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 // qc: qrypt.chat in the terminal. `qc` opens the chat client; `qc --help` lists the rest.
 import { readFileSync } from 'node:fs';
-import { main } from '../dist/commands.js';
+import { errorLine, 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(
 	() => process.exit(0),
 	(err) => {
-		process.stderr.write(`qc: ${err?.message ?? err}\n`);
+		process.stderr.write(`${errorLine(err)}\n`);
 		process.exit(1);
 	},
 );

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

@@ -187,4 +187,31 @@ function clearSession(env = process.env) {
     rmSync(file);
 }
 
-export { DEFAULT_URL, configDir, sessionPath, baseUrl, loadSession, unlockSession, storeSession, clearSession };
+// src/cli/notify.js
+var ESC = "\x1B";
+var BEL = "\x07";
+var ST = `${ESC}\\`;
+var clean = (s) => String(s ?? "").replace(/[\x00-\x1f\x7f;]/g, " ").trim();
+function notifySequence(title, body, env = process.env) {
+  const mode = String(env.QC_NOTIFY ?? "1").toLowerCase();
+  if (["0", "off", "false", "no"].includes(mode))
+    return "";
+  if (mode === "bell")
+    return BEL;
+  const t = clean(title);
+  const b = clean(body);
+  const kitty = env.KITTY_WINDOW_ID || env.TERM === "xterm-kitty";
+  let osc = kitty ? `${ESC}]99;i=qc:d=0:o=unfocused;${t}${ST}${ESC}]99;i=qc:d=1:p=body;${b}${ST}` : `${ESC}]9;${t}: ${b}${BEL}`;
+  if (env.TMUX)
+    osc = `${ESC}Ptmux;${osc.replaceAll(ESC, ESC + ESC)}${ST}`;
+  return osc + BEL;
+}
+function notify(title, body, { env = process.env, streams = [process.stdout, process.stderr] } = {}) {
+  const seq = notifySequence(title, body, env);
+  const tty = streams.find((s) => s?.isTTY);
+  if (seq && tty)
+    tty.write(seq);
+  return Boolean(seq && tty);
+}
+
+export { DEFAULT_URL, configDir, sessionPath, baseUrl, loadSession, unlockSession, storeSession, clearSession, notify };

package/dist/{chunk-074nrnc8.js → chunk-s0qccr26.js}

@@ -5,8 +5,9 @@ import {
   loadSession,
   unlockSession,
   storeSession,
-  clearSession
-} from "./chunk-menzxtw0.js";
+  clearSession,
+  notify
+} from "./chunk-g9xn5036.js";
 
 // src/cli/crypto.js
 import { MlKem1024 as MlKem10242 } from "mlkem";
@@ -1135,11 +1136,34 @@ async function joinAsAgent(invite, { name, username, env = process.env, fetchImp
   return { session, conversationId: body.conversation_id, operator: body.operator };
 }
 
+// src/cli/style.js
+import { emojify, icon } from "@profullstack/hqtui";
+var mark = (name) => {
+  const glyph = icon(name);
+  return glyph ? `${glyph} ` : "";
+};
+var em = (text) => emojify(String(text ?? ""), { mode: "emoji" });
+var ok = (text) => `${mark("check-circle")}${em(text)}`;
+var info = (text) => `${mark("info")}${em(text)}`;
+var warn = (text) => `${mark("warning")}${em(text)}`;
+var fail = (text) => `${mark("error")}${em(text)}`;
+function who(user, { agent = false } = {}) {
+  if (!user)
+    return "";
+  const face = user.emoji ? `${user.emoji} ` : agent || user.account_type === "agent" ? "\uD83E\uDD16 " : mark("user");
+  const name = user.display_name || user.displayName || user.username || "";
+  const handle = user.username && name !== user.username ? ` @${user.username}` : "";
+  const pronouns = user.pronouns ? ` (${user.pronouns})` : "";
+  return `${face}${name}${handle}${pronouns}`;
+}
+
 // src/cli/commands.js
+var errorLine2 = (err) => `qc: ${fail(err?.message ?? String(err))}`;
 var HELP2 = `qc: qrypt.chat in your terminal (end-to-end encrypted, ML-KEM-1024)
 
 Usage:
   qc                      open the chat client (signs you in first if needed)
+  qc fonts install|status|remove   our OpenEmoji colour font as the terminal's emoji font
   qc agent join <link>    join as an AI agent from an invite (makes its own keys) [--name --username]
   qc login [--oob]        sign in through your browser; --oob to paste a code (SSH)
   qc logout               forget this terminal's session and keys
@@ -1151,7 +1175,7 @@ Usage:
   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
-  qc listen               print new messages as they arrive (NDJSON with --json)
+  qc listen               print new messages as they arrive (NDJSON with --json; --notify alerts with it)
   qc mcp                  run as an MCP server on stdio (list_chats, read_chat, send_message)
 
 <chat> is a chat id or part of its name. Options: --json, --url <server> (or QC_URL).
@@ -1160,7 +1184,9 @@ OS keychain, or comes from a passphrase (QC_PASSPHRASE for scripts and qc mcp).
 HD: emoji and icons are drawn as our OpenEmoji/OpenIcon images in Kitty, Ghostty, WezTerm and iTerm2.
 Over SSH or in tmux (set -g allow-passthrough on) say which: QC_HD=1 (Kitty/Ghostty) or
 QC_HD=wezterm (WezTerm/iTerm2). QC_HD=0 turns it off. Mosh carries only text, so behind mosh
-emoji stay characters: for images use ssh or WezTerm's multiplexer (wezterm connect).`;
+emoji stay characters: for images use ssh or WezTerm's multiplexer (wezterm connect).
+New messages raise a terminal notification (OSC 9, Kitty OSC 99) and a bell, naming the chat
+but never the text; in tmux set -g allow-passthrough on. QC_NOTIFY=bell rings only, QC_NOTIFY=0 is quiet.`;
 function parseArgs2(argv) {
   const args = { _: [], flags: {} };
   for (let i = 0;i < argv.length; i++) {
@@ -1251,15 +1277,46 @@ async function main2(argv, { version = "0.0.0" } = {}) {
       });
       if (flags.json)
         return json({ user: session.user, conversation_id: conversationId, operator });
-      out(`Joined qrypt.chat as @${session.user?.username} (agent), operated by @${operator?.username ?? "?"}.`);
-      out(`Keys made here and sealed in ${sessionPath()}; only the public key left this machine.`);
+      out(ok(`Joined qrypt.chat as ${who(session.user, { agent: true })}, operated by ${who(operator)}.`));
+      out(`${mark("key")}Keys made here and sealed in ${sessionPath()}; only the public key left this machine.`);
       const chatName = operator?.display_name || operator?.username || "<chat>";
-      out(`Your chat with ${chatName} is open. Try: qc listen   or   qc send "${chatName}" "hello"   or   qc mcp`);
+      out(`${mark("chat")}Your chat with ${chatName} is open. Try: qc listen   or   qc send "${chatName}" "hello"   or   qc mcp`);
       return;
     }
+    case "fonts": {
+      const { installEmojiFont, emojiFontStatus, removeEmojiFont } = await import("@profullstack/hqtui");
+      const action = rest[0] || "status";
+      if (action === "install") {
+        const result = await installEmojiFont();
+        for (const note of result.notes)
+          out(info(note));
+        if (result.snippets?.length) {
+          out(`
+${mark("info")}Terminals that pick their own fonts need one line each:`);
+          for (const sn of result.snippets)
+            out(`  ${sn.terminal} (${sn.file}):
+    ${sn.snippet}`);
+        }
+        return out(`
+${ok("Installed OpenEmoji. Restart the terminal, then run: qc fonts status")}`);
+      }
+      if (action === "status") {
+        const st = await emojiFontStatus();
+        out(`${st.installed ? ok("OpenEmoji installed") : warn("OpenEmoji not installed (qc fonts install)")}`);
+        if (st.emojiFont !== undefined)
+          out(`${mark("info")}Emoji font in use: ${st.emojiFont || "none"}`);
+        return out(st.active ? ok("Active: emoji draw as OpenEmoji") : warn("Not active yet (restart the terminal)"));
+      }
+      if (action === "remove") {
+        const done = await removeEmojiFont();
+        return out(done.length ? ok("Removed the OpenEmoji font setup.") : info("Nothing to remove."));
+      }
+      throw new Error("Usage: qc fonts install|status|remove");
+    }
     case "login": {
       const { session } = await login({ oob: !!flags.oob });
-      out(`Signed in as @${session.user?.username ?? "unknown"} on ${session.base}. Keys sealed (ChaCha20-Poly1305) in ${sessionPath()}.`);
+      out(ok(`Signed in as ${who(session.user)} on ${session.base}.`));
+      out(`${mark("lock")}Keys sealed (ChaCha20-Poly1305) in ${sessionPath()}.`);
       if (await new QcClient(session).keyCheck() === "mismatch") {
         out("Warning: the browser handed over keys that are not your account's current keys, so messages will not decrypt here. Restore your keys in that browser (Settings > Keys) or approve from the device you chat on, then run qc login again.");
       }
@@ -1267,12 +1324,12 @@ async function main2(argv, { version = "0.0.0" } = {}) {
     }
     case "logout":
       clearSession();
-      return out("Signed out. This terminal no longer holds your keys.");
+      return out(ok("Signed out. This terminal no longer holds your keys."));
     case "whoami": {
       const session = loadSession();
       if (!session)
         throw new Error("Not signed in. Run qc login.");
-      return flags.json ? json({ user: session.user, base: session.base }) : out(`@${session.user?.username} (${session.user?.display_name ?? ""}) on ${session.base}`);
+      return flags.json ? json({ user: session.user, base: session.base }) : out(`${who(session.user)} on ${session.base}`);
     }
     case "profile": {
       const c = await client(flags);
@@ -1285,14 +1342,14 @@ async function main2(argv, { version = "0.0.0" } = {}) {
       const p = Object.keys(fields).length ? await c.updateProfile(fields) : await c.profile();
       if (flags.json)
         return json({ username: p.username, emoji: p.emoji ?? null, pronouns: p.pronouns ?? null, website: p.website ?? null, bio: p.bio ?? null });
-      out(`${p.emoji ? `${p.emoji} ` : ""}${p.displayName ?? p.display_name ?? p.username} @${p.username}${p.pronouns ? ` (${p.pronouns})` : ""}`);
+      out(who(p));
       if (p.website)
-        out(p.website);
+        out(`${mark("link")}${p.website}`);
       if (p.bio)
         out(p.bio);
       if (!Object.keys(fields).length)
         out(`
-Set: qc profile --emoji \uD83D\uDD2D --pronouns she/her --website https://you.example  (an empty value clears)`);
+${info("Set: qc profile --emoji :telescope: --pronouns she/her --website https://you.example  (an empty value clears)")}`);
       return;
     }
     case "chats":
@@ -1301,7 +1358,7 @@ Set: qc profile --emoji \uD83D\uDD2D --pronouns she/her --website https://you.ex
       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}  ${c.title}`);
+        out(`${c.id}  ${mark(c.type === "group" ? "users" : "chat")}${c.title}`);
       return;
     }
     case "read": {
@@ -1317,7 +1374,7 @@ Set: qc profile --emoji \uD83D\uDD2D --pronouns she/her --website https://you.ex
         if (m.replyTo)
           out(`    ┃ ${m.replyTo.name ? `${m.replyTo.name}: ` : ""}${m.replyTo.snippet}`);
         const reactions = m.reactions?.length ? `  [${m.reactions.map((r) => `${r.emoji}${r.count > 1 ? r.count : ""}`).join(" ")}]` : "";
-        out(`[${stamp(m.at)}] ${m.mine ? "you" : m.sender}: ${m.text}${reactions}  (${m.id.slice(0, 8)})`);
+        out(`[${stamp(m.at)}] ${m.emoji ? `${m.emoji} ` : ""}${m.mine ? "you" : m.sender}: ${em(m.text)}${reactions}  (${m.id.slice(0, 8)})`);
       }
       return;
     }
@@ -1332,7 +1389,7 @@ Set: qc profile --emoji \uD83D\uDD2D --pronouns she/her --website https://you.ex
       if (target.length !== 1)
         throw new Error(target.length ? `"${messageId}" matches ${target.length} messages` : `No message "${messageId}" in ${chat.title}`);
       await c.react(chat.id, target[0].id, emoji, !!flags.remove);
-      return out(`${flags.remove ? "Removed" : "Reacted"} ${emoji} on ${chat.title}.`);
+      return out(ok(`${flags.remove ? "Removed" : "Reacted"} ${emoji} on ${chat.title}.`));
     }
     case "send": {
       if (!rest[0] || rest.length < 2)
@@ -1345,7 +1402,9 @@ Set: qc profile --emoji \uD83D\uDD2D --pronouns she/her --website https://you.ex
       const { message, skipped } = await c.send(chat.id, text, { replyTo: flags.reply || undefined });
       if (flags.json)
         return json({ id: message?.id, conversation: chat.id, skipped });
-      return out(`Sent to ${chat.title}${skipped ? ` (${skipped} participant(s) have no key yet)` : ""}.`);
+      if (skipped)
+        out(warn(`${skipped} participant(s) have no key yet and will not see it.`));
+      return out(`${mark("send")}Sent to ${chat.title}.`);
     }
     case "listen": {
       const c = await client(flags);
@@ -1363,10 +1422,12 @@ Set: qc profile --emoji \uD83D\uDD2D --pronouns she/her --website https://you.ex
           if (seen.has(m.id) || m.id !== data.message.id)
             continue;
           seen.add(m.id);
+          if (!m.mine && (flags.notify || !flags.json))
+            notify("qrypt.chat", `${m.sender} in ${titles.get(id) ?? "a chat"}`);
           if (flags.json)
             out(JSON.stringify({ chat: id, title: titles.get(id), ...m }));
           else
-            out(`[${stamp(m.at)}] ${titles.get(id) ?? id} · ${m.mine ? "you" : m.sender}: ${m.text}`);
+            out(`[${stamp(m.at)}] ${mark("chat")}${titles.get(id) ?? id} · ${m.emoji ? `${m.emoji} ` : ""}${m.mine ? "you" : m.sender}: ${em(m.text)}`);
         }
       }, { onStatus: (s) => process.stderr.write(`qc: ${s}
 `) });
@@ -1383,4 +1444,4 @@ ${HELP2}`);
   }
 }
 
-export { HELP2, parseArgs2, findChat2, main2 };
+export { errorLine2, HELP2, parseArgs2, findChat2, main2 };

package/dist/commands.js

@@ -1,12 +1,14 @@
 import {
+  errorLine2,
   HELP2,
   parseArgs2,
   findChat2,
   main2
-} from "./chunk-074nrnc8.js";
-import"./chunk-menzxtw0.js";
+} from "./chunk-s0qccr26.js";
+import"./chunk-g9xn5036.js";
 export {
   HELP2 as HELP,
+  errorLine2 as errorLine,
   findChat2 as findChat,
   main2 as main,
   parseArgs2 as parseArgs

package/dist/mcp.js

@@ -1,7 +1,7 @@
-import"./chunk-menzxtw0.js";
+import"./chunk-g9xn5036.js";
 import {
   findChat2
-} from "./chunk-074nrnc8.js";
+} from "./chunk-s0qccr26.js";
 
 // src/cli/mcp.js
 import { createInterface } from "node:readline";

package/dist/tui.js

@@ -1,6 +1,7 @@
 import {
-  configDir
-} from "./chunk-menzxtw0.js";
+  configDir,
+  notify
+} from "./chunk-g9xn5036.js";
 
 // src/cli/tui.js
 import { createApp, createImageStore, drawIcon, drawRichText, editText, emojify, insertText, stringWidth, truncate, widgets, wrap } from "@profullstack/hqtui";
@@ -396,6 +397,10 @@ async function runTui(client, { initialChat } = {}) {
       const id = data?.message?.conversation_id;
       if (!id)
         return;
+      if (data.message.sender_id !== client.me?.id) {
+        const chat = state.conversations.find((c) => c.id === id);
+        notify("qrypt.chat", `new message${chat ? ` in ${chat.title}` : ""}`);
+      }
       if (id === state.activeId)
         loadMessages(id);
       else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@profullstack/qryptchat",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "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": {