@profullstack/qryptchat 0.11.0 → 0.13.0

package/README.md

@@ -49,12 +49,14 @@ The mouse works too: click a chat, scroll the transcript, click an emoji. Unread
 ```sh
 qc chats                        # id and name of every chat
 qc read alice -n 20             # the last 20 messages, decrypted
+qc dm @alice "hey, it's me"     # start (or reopen) a direct chat with anyone, by @username
 qc send alice "on my way"       # encrypted to every participant
 qc send ops "@ri deploy is done" # an @partial matching one person is sent as @riotcoder
 qc mentions ops @al             # who @al completes to: @alice, @alina
 echo "deploy done" | qc send ops -
 qc listen --json                # new messages as NDJSON, until you stop it
 qc whoami
+qc keys                         # are this terminal's keys your account's? (qc keys publish puts them back)
 ```
 
 `<chat>` is a chat id or any unique part of its name. Add `--json` for machine output.

package/dist/{chunk-nsn86c8y.js → chunk-8frhjf08.js}

@@ -1,7 +1,7 @@
 import {
   openBrowser2,
   login2
-} from "./chunk-ywyhy3sp.js";
+} from "./chunk-94qf0rg1.js";
 export {
   login2 as login,
   openBrowser2 as openBrowser

package/dist/{chunk-ywyhy3sp.js → chunk-94qf0rg1.js}

@@ -736,6 +736,13 @@ class QcClient {
       return "unknown";
     }
   }
+  async publishKey() {
+    const mine = this.session.keys?.keys1024?.publicKey;
+    if (!mine)
+      throw new QcError("This terminal holds no keys. Run qc login.");
+    await this.request("/api/crypto/public-keys", { method: "PUT", body: { public_key: mine, key_type: "ML-KEM-1024" } });
+    return this.keyCheck();
+  }
   async profile() {
     const { user } = await this.request(`/api/users/by-username/${encodeURIComponent(this.me?.username ?? "")}`);
     return user;
@@ -788,6 +795,24 @@ class QcClient {
     }));
     return { messages: out, hasMore };
   }
+  async searchUsers(query) {
+    const q = String(query ?? "").trim().replace(/^@/, "");
+    if (!q)
+      return [];
+    const { users = [] } = await this.request(`/api/users/search?q=${encodeURIComponent(q)}`);
+    return users;
+  }
+  async startDirect(who) {
+    const user = pickUser(await this.searchUsers(who), who);
+    const { conversation_id: id } = await this.request("/api/chat/conversations", {
+      method: "POST",
+      body: { type: "direct", participant_ids: [user.id] }
+    });
+    if (!id)
+      throw new QcError(`Could not start a chat with @${user.username}`);
+    const chat = (await this.conversations()).find((c) => c.id === id);
+    return chat ?? { id, title: user.display_name || user.username, participants: [] };
+  }
   async joinGroup(code) {
     return this.request("/api/conversations/join", { method: "POST", body: { code } });
   }
@@ -915,6 +940,18 @@ function sleep(ms, signal) {
     });
   });
 }
+function pickUser(users, query) {
+  const q = String(query ?? "").trim().replace(/^@/, "").toLowerCase();
+  const exact = users.filter((u) => u.username?.toLowerCase() === q || u.unique_identifier?.toLowerCase() === q);
+  if (exact.length === 1)
+    return exact[0];
+  if (users.length === 1)
+    return users[0];
+  if (!users.length)
+    throw new QcError(`Nobody on qrypt.chat matches "${query}"`, 404);
+  const names = users.slice(0, 8).map((u) => `@${u.username}${u.display_name && u.display_name !== u.username ? ` (${u.display_name})` : ""}`);
+  throw new QcError(`"${query}" matches ${users.length} people: ${names.join(", ")}${users.length > 8 ? ", …" : ""}. Use their @username.`, 409);
+}
 function conversationTitle(c, me) {
   if (c.name)
     return c.name;
@@ -1262,6 +1299,8 @@ Usage:
   qc logout               forget this terminal's session and keys
   qc update [--check]     update qc to the latest release (--check only says whether there is one)
   qc whoami               who this terminal is signed in as
+  qc keys [publish]       whether this terminal's keys are your account's; publish makes them the
+                          account's again (when another device published keys qc does not hold)
   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
@@ -1276,10 +1315,12 @@ 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);
                           an @partial that matches one person becomes their @username
+  qc dm <@user> [text]    start (or reopen) a direct chat with anyone on qrypt.chat and send
+                          text if given ("-" reads stdin); qc msg is the same. In the client: /msg @user
   qc mentions <chat> [@partial]   who @ completes to in a chat, best match first (one per line)
   qc react <chat> <message-id> <emoji> [--remove]   react to a message
   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, list_mentions)
+  qc mcp                  run as an MCP server on stdio (list_chats, read_chat, send_message, start_direct_chat, list_mentions)
   qc join <link>          join a group chat from its invite link (https://qrypt.chat/join/...)
   qc invite <chat>        print a group's invite link (group admins) [--reset makes a new one, --off turns it off]
 
@@ -1379,7 +1420,7 @@ async function main2(argv, { version = "0.0.0" } = {}) {
     }
     case "agent": {
       if (rest[0] === "call") {
-        const { runVoiceAgent } = await import("./chunk-wkjs9anq.js");
+        const { runVoiceAgent } = await import("./chunk-qcszcng8.js");
         return runVoiceAgent(await client(flags), {
           brain: typeof flags.brain === "string" ? flags.brain : undefined,
           voice: typeof flags.voice === "string" ? flags.voice : undefined,
@@ -1442,6 +1483,35 @@ ${ok("Installed OpenEmoji. Restart the terminal, then run: qc fonts status")}`);
       }
       return;
     }
+    case "keys": {
+      const c = await client(flags);
+      const status = await c.keyCheck();
+      if (rest[0] !== "publish") {
+        if (flags.json)
+          return json({ keys: status });
+        if (status === "ok")
+          return out(ok("This terminal's keys are your account's keys."));
+        if (status === "mismatch")
+          return out(warn("Your account publishes a different key, so messages sent to you since then won't decrypt here. If older messages read fine in qc read, run qc keys publish."));
+        return out(info("Could not compare keys (no key on file, or the check failed)."));
+      }
+      if (status === "ok")
+        return out(ok("Already published: nothing to do."));
+      if (!flags.yes) {
+        if (!process.stdin.isTTY)
+          throw new Error("qc keys publish replaces the key everyone encrypts to. Add --yes to confirm.");
+        const { createInterface } = await import("node:readline/promises");
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await rl.question("Publish this terminal's key? Devices holding the other key will stop decrypting new messages until they restore your keys. [y/N] ");
+        rl.close();
+        if (!/^y(es)?$/i.test(answer.trim()))
+          return out(info("Left the published key alone."));
+      }
+      const after = await c.publishKey();
+      if (flags.json)
+        return json({ published: true, keys: after });
+      return out(ok("Published. New messages are encrypted to this terminal's key again; other devices on the other key should restore from Settings > Keys."));
+    }
     case "logout":
       clearSession();
       return out(ok("Signed out. This terminal no longer holds your keys."));
@@ -1514,7 +1584,7 @@ ${info("Set: qc profile --emoji :telescope: --pronouns she/her --website https:/
         throw new Error('Usage: qc call <number>   (e.g. qc call "(415) 555-1234" or qc call +442079460958)');
       const c = await client(flags);
       const url = `${c.base}/phone?to=${encodeURIComponent(rest.join(" "))}`;
-      const { openBrowser } = await import("./chunk-nsn86c8y.js");
+      const { openBrowser } = await import("./chunk-8frhjf08.js");
       const opened = openBrowser(url);
       return out(`${mark("send")}${opened === false ? "Open" : "Opened"} ${url}
   Calls to phones need your browser for the audio; tap Call there.`);
@@ -1615,6 +1685,20 @@ ${info("Set: qc profile --emoji :telescope: --pronouns she/her --website https:/
         out(warn(`@${a.query} could be ${a.matches.join(", ")}: sent as typed.`));
       return out(`${mark("send")}Sent to ${chat.title}.`);
     }
+    case "dm":
+    case "msg": {
+      if (!rest[0])
+        throw new Error(`Usage: qc ${cmd} <@user> [text]   (a username, or a name only one person has)`);
+      const text = rest[1] === "-" && rest.length === 2 ? (await readStdin()).trim() : rest.slice(1).join(" ");
+      const c = await client(flags);
+      const chat = await c.startDirect(rest[0]);
+      const sent = text ? await c.send(chat.id, text) : null;
+      if (flags.json)
+        return json({ conversation: chat.id, title: chat.title, ...sent ? { id: sent.message?.id, skipped: sent.skipped } : {} });
+      if (sent?.skipped)
+        out(warn(`${chat.title} has no key yet and will not see it until they sign in.`));
+      return out(`${mark("send")}${sent ? `Sent to ${chat.title}` : `Chat with ${chat.title} is open (qc send "${chat.title}" <text>)`}.`);
+    }
     case "listen": {
       const c = await client(flags);
       const chats = await c.conversations();

package/dist/{chunk-wkjs9anq.js → chunk-qcszcng8.js}

@@ -1,7 +1,7 @@
 import {
   CALL_TYPE,
   parseCall
-} from "./chunk-ywyhy3sp.js";
+} from "./chunk-94qf0rg1.js";
 
 // src/cli/voice-agent.js
 import { spawn } from "node:child_process";

package/dist/commands.js

@@ -7,7 +7,7 @@ import {
   mentionMatches2,
   withMentions2,
   main2
-} from "./chunk-ywyhy3sp.js";
+} from "./chunk-94qf0rg1.js";
 import"./chunk-4ea1xy2c.js";
 export {
   HELP2 as HELP,

package/dist/mcp.js

@@ -3,7 +3,7 @@ import {
   findChat2,
   mentionMatches2,
   withMentions2
-} from "./chunk-ywyhy3sp.js";
+} from "./chunk-94qf0rg1.js";
 
 // src/cli/mcp.js
 import { createInterface } from "node:readline";
@@ -40,6 +40,19 @@ var TOOLS = [
       additionalProperties: false
     }
   },
+  {
+    name: "start_direct_chat",
+    description: "Start (or reopen) an end-to-end encrypted direct chat with anyone on qrypt.chat, by @username or a name only one person has, and optionally send the first message. Returns the chat id for read_chat/send_message.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        user: { type: "string", description: "Their @username (or a name that matches only them)" },
+        text: { type: "string", description: "Optional: the first message" }
+      },
+      required: ["user"],
+      additionalProperties: false
+    }
+  },
   {
     name: "list_mentions",
     description: "Who an @mention can complete to in a conversation, best match first (like typing @ali then Tab). Without partial: everyone you can mention.",
@@ -98,6 +111,13 @@ async function callTool(client, name, args = {}) {
     const { message, skipped } = await client.send(chat.id, m.text, { replyTo: typeof args.reply_to === "string" ? args.reply_to : undefined });
     return { sent: true, id: message?.id, chat: chat.title, skipped, ...m.mentions.length ? { mentions: m.mentions } : {}, ...m.ambiguous.length ? { ambiguous: m.ambiguous } : {} };
   }
+  if (name === "start_direct_chat") {
+    if (!args.user || typeof args.user !== "string")
+      throw new Error("user is required");
+    const chat = await client.startDirect(args.user);
+    const sent = typeof args.text === "string" && args.text.trim() ? await client.send(chat.id, args.text.trim()) : null;
+    return { chat: chat.title, id: chat.id, ...sent ? { sent: true, message_id: sent.message?.id, skipped: sent.skipped } : {} };
+  }
   if (name === "list_mentions") {
     const chat = findChat2(await client.conversations(), args.chat);
     const matches = mentionMatches2(chat, client.me, typeof args.partial === "string" ? args.partial : "");

package/dist/tui.js

@@ -74,7 +74,12 @@ 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", "names", "list"];
+var SLASH_COMMANDS = ["voice", "archive", "unarchive", "archived", "names", "list", "msg", "dm", "query", "new"];
+var NEW_CHAT_COMMANDS = ["msg", "dm", "query", "new"];
+function parseNewChat(args) {
+  const m = /^(\S+)(?:\s+([\s\S]*))?$/.exec(String(args ?? "").trim());
+  return m ? { who: m[1], text: (m[2] ?? "").trim() } : null;
+}
 var pad2 = (n) => String(n).padStart(2, "0");
 var timeOf = (iso) => {
   const d = new Date(iso);
@@ -132,7 +137,8 @@ function drawTranscript(surface, state) {
   const theme = surface.theme;
   const messages = state.messages[state.activeId] || [];
   if (!state.activeId) {
-    surface.text(1, 1, state.loading ? "Loading your chats…" : "Pick a chat on the left.", { fg: theme.muted });
+    const hint = state.loading ? "Loading your chats…" : state.conversations.length ? "Pick a chat on the left, or type /msg @name to start one." : "No chats yet. Type /msg @name to message someone.";
+    surface.text(1, 1, hint, { fg: theme.muted });
     return;
   }
   if (!messages.length) {
@@ -217,7 +223,7 @@ function render({ ui, width, height, theme }, state, on = {}) {
       p.textInput({
         value: state.field.value,
         cursor: state.field.cursor,
-        placeholder: active ? `Message ${active.title}  (@name Tab, Ctrl+E emoji, :rocket: works too)` : "Pick a chat first",
+        placeholder: active ? `Message ${active.title}  (@name Tab, Ctrl+E emoji, /msg @name for a new chat)` : "/msg @name to start a chat",
         focused: state.focus === "compose" && !state.picker,
         size: 1
       });
@@ -229,7 +235,7 @@ function render({ ui, width, height, theme }, state, on = {}) {
       { key: "Ctrl+E", label: "emoji" },
       { key: "Tab", label: state.focus === "list" ? "compose" : mention?.matches.length ? "complete @" : "chats" },
       { key: "PgUp", label: "scroll" },
-      ...state.focus === "list" ? [{ key: "a", label: state.showArchived ? "unarchive" : "archive" }] : [],
+      ...state.focus === "list" ? [{ key: "n", label: "new chat" }, { key: "a", label: state.showArchived ? "unarchive" : "archive" }] : [],
       { key: "Ctrl+O", label: state.showArchived ? "chats" : "archived" },
       { key: "Ctrl+C", label: "quit" }
     ],
@@ -262,7 +268,7 @@ function saveRecent(list) {
     writeFileSync(recentFile(), JSON.stringify(list), { mode: 384 });
   } catch {}
 }
-var KEY_MISMATCH = "Keys don't match your account, so messages can't decrypt. Run qc login and approve from a browser that can read your chats.";
+var KEY_MISMATCH = "Keys don't match your account, so new messages can't decrypt. If your history reads here, run qc keys publish; else qc login from a browser that reads your chats.";
 async function runTui(client, { initialChat } = {}) {
   const state = initialState(client.me);
   state.recent = loadRecent();
@@ -381,13 +387,43 @@ async function runTui(client, { initialChat } = {}) {
       note(`Could not ${on ? "archive" : "unarchive"}: ${err.message}`);
     }
   }
+  function openById(id) {
+    const chat = state.conversations.find((c) => c.id === id);
+    if (!chat)
+      return;
+    state.showArchived = !!chat.is_archived;
+    openAt(listed(state).findIndex((c) => c.id === id));
+    state.focus = "compose";
+  }
+  async function startChat(args) {
+    const want = parseNewChat(args);
+    if (!want)
+      return note("Usage: /msg @name [message]  (a username, or a name only one person has)");
+    note(`Looking up ${want.who}…`, { sticky: true });
+    try {
+      const chat = await client.startDirect(want.who);
+      if (!state.conversations.some((c) => c.id === chat.id))
+        state.conversations = [chat, ...state.conversations];
+      openById(chat.id);
+      note(`Chat with ${chat.title} is open`);
+      if (want.text) {
+        state.field = { value: want.text, cursor: want.text.length };
+        await send({ text: true });
+      }
+    } catch (err) {
+      note(err.message, { sticky: err.status === 409 });
+    }
+    redraw();
+  }
   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")
+    if (NEW_CHAT_COMMANDS.includes(cmd.name))
+      startChat(cmd.args);
+    else if (cmd.name === "archived")
       toggleArchivedView();
     else if (!active)
       note("Pick a chat first");
@@ -407,8 +443,8 @@ async function runTui(client, { initialChat } = {}) {
     redraw();
     return true;
   }
-  async function send({ raw = false } = {}) {
-    if (!raw && runSlash(state.field.value))
+  async function send({ raw = false, text: plain = false } = {}) {
+    if (!raw && !plain && runSlash(state.field.value))
       return;
     const text = raw ? state.field.value.trim() : emojify(state.field.value.trim(), { mode: "emoji" });
     if (!text || !state.activeId)
@@ -492,7 +528,10 @@ async function runTui(client, { initialChat } = {}) {
         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") {
+      else if (event.key === "n") {
+        state.field = { value: "/msg @", cursor: 6 };
+        state.focus = "compose";
+      } else if (event.key === "a") {
         const c = listed(state)[state.selected];
         if (c)
           setArchived(c, !c.is_archived);
@@ -585,11 +624,13 @@ async function runTui(client, { initialChat } = {}) {
 }
 export {
   CHAT_LIST_REFRESH_MS,
+  NEW_CHAT_COMMANDS,
   SLASH_COMMANDS,
   chatsWithNews,
   initialState,
   listed,
   mentionSuggestions,
+  parseNewChat,
   render,
   runTui,
   tabComplete,

package/package.json

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