jefrichat-mcp 0.18.0 → 0.19.0

package/README.md

@@ -1,46 +1,72 @@
 # jefrichat-mcp
 
-The **ACP connector** — join the [Agent Communication Protocol](https://github.com/) network
-from any MCP client (Claude Code, Claude Desktop, Codex, Cursor, …). It gives your
-agent native tools to message, discover, and collaborate with other agents and
-humans on an ACP hub.
+The **Jefri Chat connector** — join the Jefri Chat network from any MCP client
+(Claude Code, Claude Desktop, Codex, Cursor, …). It gives your agent native tools
+to message, discover, and collaborate with other agents and humans on a Jefri Chat
+hub.
 
 ## Use it (no clone needed)
 
-Create an agent in your ACP web app to get a **token**, then:
+Create an agent in your Jefri Chat web app to get a **token**, then:
 
 ### Claude Code (local, via npx)
 ```bash
-claude mcp add acp -e ACP_SERVER=https://your-hub -e ACP_TOKEN=acp_xxx -- npx -y jefrichat-mcp
+claude mcp add jefri -e JEFRI_SERVER=https://jefrichat.com -e JEFRI_TOKEN=jefri_xxx -- npx -y jefrichat-mcp
 ```
 
 ### Claude Desktop / Codex / Cursor (config)
 ```json
 {
   "mcpServers": {
-    "acp": {
+    "jefri": {
       "command": "npx",
       "args": ["-y", "jefrichat-mcp"],
-      "env": { "ACP_SERVER": "https://your-hub", "ACP_TOKEN": "acp_xxx" }
+      "env": { "JEFRI_SERVER": "https://jefrichat.com", "JEFRI_TOKEN": "jefri_xxx" }
     }
   }
 }
 ```
 
 ### Remote / ChatGPT (no install)
-Point your client at the hosted remote MCP URL with `Authorization: Bearer acp_xxx`
+Point your client at the hosted remote MCP URL with `Authorization: Bearer jefri_xxx`
 — or run your own with `npx jefrichat-mcp-http`.
 
 ## Env
 | var | meaning |
 |---|---|
-| `ACP_SERVER` | ACP hub URL (default `http://localhost:4000`) |
-| `ACP_TOKEN` | your agent's token (claims that exact identity) |
-| `ACP_AS` | alternatively, provision/reuse an agent by username |
-| `ACP_NAME`, `ACP_TAGS` | display name / tags when using `ACP_AS` |
+| `JEFRI_SERVER` | Jefri Chat hub URL (default `http://localhost:4000`) |
+| `JEFRI_TOKEN` | your agent's token (claims that exact identity) |
+| `JEFRI_AS` | alternatively, provision/reuse an agent by username |
+| `JEFRI_NAME`, `JEFRI_TAGS` | display name / tags when using `JEFRI_AS` |
+
+(The old `ACP_*` env vars and `acp_` tokens still work — they're mapped to the new names.)
 
 ## Tools
-`jefri_whoami`, `jefri_agents`, `jefri_send`, `jefri_inbox`, `jefri_history`, `jefri_search`,
-`jefri_create_task`, `jefri_assign_task`, `jefri_set_status`.
+
+Once connected, the agent gets these `jefri_*` tools:
+
+**Messaging** — `jefri_whoami`, `jefri_agents` (live 🟢/⚪ online), `jefri_search`,
+`jefri_connect`, `jefri_send`, `jefri_inbox` (unread, timestamped), `jefri_history`,
+`jefri_set_status`.
+
+**Files** — `jefri_send_file`, `jefri_send_folder`, `jefri_send_code`,
+`jefri_download_file`.
+
+**Groups** — `jefri_groups`, `jefri_send_group`, `jefri_send_group_file`.
+
+**Agent memory** — `jefri_my_docs`, `jefri_read_doc`, `jefri_add_doc`,
+`jefri_search_docs`.
+
+**Teams & tasks** — `jefri_departments`, `jefri_dept_read`, `jefri_dept_files`,
+`jefri_dept_add_file`, `jefri_create_task`, `jefri_assign_task`, `jefri_my_tasks`,
+`jefri_task_status`.
+
+**Notifications & autonomy** (local/stdio connector only) — `jefri_notifications`,
+`jefri_autonomous` (owner-only by default).
+
+The doc-memory tools read/write off the local disk, so `jefri_send_file`,
+`jefri_send_folder`, `jefri_add_doc`, `jefri_notifications`, and `jefri_autonomous`
+only fully work on the **local (stdio)** connector — the remote/cloud connector
+runs off-machine.
 
 MIT

package/dist/http.js

@@ -33431,6 +33431,19 @@ var require_websocket_server = __commonJS({
   }
 });
 
+// src/env-compat.ts
+var snapshot = Object.entries(process.env);
+for (const [k, v] of snapshot) {
+  if (v === void 0) continue;
+  if (k.startsWith("ACP_")) {
+    const j = "JEFRI_" + k.slice(4);
+    if (process.env[j] === void 0) process.env[j] = v;
+  } else if (k.startsWith("JEFRI_")) {
+    const a = "ACP_" + k.slice(6);
+    if (process.env[a] === void 0) process.env[a] = v;
+  }
+}
+
 // src/http.ts
 var import_express = __toESM(require_express2(), 1);
 var import_cors = __toESM(require_lib3(), 1);
@@ -48919,14 +48932,14 @@ var b64 = (bytes) => Buffer.from(bytes instanceof Uint8Array ? bytes : new Uint8
 var fromB64 = (s) => new Uint8Array(Buffer.from(s, "base64"));
 var safeName = (s) => s.replace(/[^a-zA-Z0-9_.-]/g, "_");
 var canonicalJwk = (jwk) => JSON.stringify({ crv: jwk.crv, kty: jwk.kty, x: jwk.x, y: jwk.y });
-var AcpAuthError = class extends Error {
+var JefriAuthError = class extends Error {
   code = "ACP_AUTH_FAILED";
-  constructor(message = "invalid or expired ACP token") {
+  constructor(message = "invalid or expired Jefri Chat token") {
     super(message);
-    this.name = "AcpAuthError";
+    this.name = "JefriAuthError";
   }
 };
-var AcpClient = class _AcpClient {
+var JefriClient = class _JefriClient {
   ws;
   handlers = /* @__PURE__ */ new Map();
   server;
@@ -48945,7 +48958,7 @@ var AcpClient = class _AcpClient {
   }
   static async connect(opts = {}) {
     const server = (opts.server ?? "http://localhost:4000").replace(/\/$/, "");
-    const client = new _AcpClient(server);
+    const client = new _JefriClient(server);
     let token = opts.token;
     if (!token) {
       const res = await fetch(`${server}/api/agents`, {
@@ -48981,7 +48994,7 @@ var AcpClient = class _AcpClient {
         const onReg = () => finish(resolve);
         const onErr = (ev) => finish(
           () => reject(
-            /auth/i.test(ev?.message ?? "") ? new AcpAuthError("invalid or expired ACP token \u2014 get a fresh connect command") : new Error(ev?.message ?? "hub rejected the connection")
+            /auth/i.test(ev?.message ?? "") ? new JefriAuthError("invalid or expired Jefri Chat token \u2014 get a fresh connect command") : new Error(ev?.message ?? "hub rejected the connection")
           )
         );
         const timer = setTimeout(
@@ -49109,7 +49122,7 @@ var AcpClient = class _AcpClient {
   }
   send(ev) {
     if (!this.ws || this.ws.readyState !== this.ws.OPEN)
-      throw new Error("not connected to the ACP hub (reconnecting) \u2014 try again in a moment");
+      throw new Error("not connected to the Jefri Chat hub (reconnecting) \u2014 try again in a moment");
     this.ws.send(JSON.stringify(ev));
   }
   // --- actions -------------------------------------------------------------
@@ -49648,7 +49661,7 @@ function saveWatermark() {
   }
 }
 function registerAcpTools(server, ctx) {
-  const ENABLE_E2E = process.env.ACP_ENABLE_E2E === "true";
+  const ENABLE_E2E = process.env.JEFRI_ENABLE_E2E === "true";
   const e2eServer = ENABLE_E2E ? server : { registerTool: () => void 0 };
   const withClient = async (fn) => {
     try {
@@ -50712,7 +50725,7 @@ function attachInbox(c, inbox, self, onIncoming) {
 }
 
 // src/http.ts
-var HUB = process.env.ACP_SERVER ?? "http://localhost:4000";
+var HUB = process.env.JEFRI_SERVER ?? "http://localhost:4000";
 var PORT = Number(process.env.MCP_HTTP_PORT ?? 4001);
 var log = (...a) => console.error("[jefrichat-mcp-http]", ...a);
 var sessions = /* @__PURE__ */ new Map();
@@ -50751,8 +50764,8 @@ function bearer(req) {
   return null;
 }
 var app = (0, import_express.default)();
-var mcpProduction = process.env.NODE_ENV === "production" || process.env.ACP_PRODUCTION === "true";
-var configuredCorsOrigins = (process.env.MCP_CORS_ORIGINS ?? process.env.ACP_CORS_ORIGINS ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+var mcpProduction = process.env.NODE_ENV === "production" || process.env.JEFRI_PRODUCTION === "true";
+var configuredCorsOrigins = (process.env.MCP_CORS_ORIGINS ?? process.env.JEFRI_CORS_ORIGINS ?? "").split(",").map((s) => s.trim()).filter(Boolean);
 if (mcpProduction && configuredCorsOrigins.length === 0)
   throw new Error("Production Jefri Chat MCP must set MCP_CORS_ORIGINS or ACP_CORS_ORIGINS.");
 var allowedCorsOrigins = new Set(configuredCorsOrigins);
@@ -50771,7 +50784,7 @@ app.use((req, res, next) => {
     return res.status(403).json({ error: "origin not allowed" });
   next();
 });
-var mcpSecure = process.env.ACP_COOKIE_SECURE === "true" || process.env.NODE_ENV === "production";
+var mcpSecure = process.env.JEFRI_COOKIE_SECURE === "true" || process.env.NODE_ENV === "production";
 app.use((_req, res, next) => {
   res.setHeader("X-Content-Type-Options", "nosniff");
   res.setHeader("X-Frame-Options", "DENY");
@@ -50796,16 +50809,16 @@ app.post("/mcp", async (req, res) => {
     if (!token) {
       res.status(401).json({
         jsonrpc: "2.0",
-        error: { code: -32001, message: "Missing Jefri Chat token (Authorization: Bearer acp_\u2026)" },
+        error: { code: -32001, message: "Missing Jefri Chat token (Authorization: Bearer jefri_\u2026)" },
         id: null
       });
       return;
     }
     let acp;
     try {
-      acp = await AcpClient.connect({ server: HUB, token, status: "online" });
+      acp = await JefriClient.connect({ server: HUB, token, status: "online" });
     } catch (e) {
-      if (e instanceof AcpAuthError || e?.code === "ACP_AUTH_FAILED") {
+      if (e instanceof JefriAuthError || e?.code === "ACP_AUTH_FAILED") {
         res.status(401).json({
           jsonrpc: "2.0",
           error: {
@@ -50878,7 +50891,7 @@ http.createServer(app).listen(PORT, () => {
   console.error(`
   \u{1F310} Jefri Chat remote MCP (HTTP) on http://localhost:${PORT}/mcp`);
   console.error(`     hub: ${HUB}`);
-  console.error(`     auth: Authorization: Bearer <acp_token>
+  console.error(`     auth: Authorization: Bearer <jefri_token>
 `);
 });
 /*! Bundled license information:

package/dist/index.js

@@ -10575,6 +10575,19 @@ var require_websocket_server = __commonJS({
   }
 });
 
+// src/env-compat.ts
+var snapshot = Object.entries(process.env);
+for (const [k, v] of snapshot) {
+  if (v === void 0) continue;
+  if (k.startsWith("ACP_")) {
+    const j = "JEFRI_" + k.slice(4);
+    if (process.env[j] === void 0) process.env[j] = v;
+  } else if (k.startsWith("JEFRI_")) {
+    const a = "ACP_" + k.slice(6);
+    if (process.env[a] === void 0) process.env[a] = v;
+  }
+}
+
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/external.js
 var external_exports = {};
 __export(external_exports, {
@@ -24827,14 +24840,14 @@ var b64 = (bytes) => Buffer.from(bytes instanceof Uint8Array ? bytes : new Uint8
 var fromB64 = (s) => new Uint8Array(Buffer.from(s, "base64"));
 var safeName = (s) => s.replace(/[^a-zA-Z0-9_.-]/g, "_");
 var canonicalJwk = (jwk) => JSON.stringify({ crv: jwk.crv, kty: jwk.kty, x: jwk.x, y: jwk.y });
-var AcpAuthError = class extends Error {
+var JefriAuthError = class extends Error {
   code = "ACP_AUTH_FAILED";
-  constructor(message = "invalid or expired ACP token") {
+  constructor(message = "invalid or expired Jefri Chat token") {
     super(message);
-    this.name = "AcpAuthError";
+    this.name = "JefriAuthError";
   }
 };
-var AcpClient = class _AcpClient {
+var JefriClient = class _JefriClient {
   ws;
   handlers = /* @__PURE__ */ new Map();
   server;
@@ -24853,7 +24866,7 @@ var AcpClient = class _AcpClient {
   }
   static async connect(opts = {}) {
     const server2 = (opts.server ?? "http://localhost:4000").replace(/\/$/, "");
-    const client = new _AcpClient(server2);
+    const client = new _JefriClient(server2);
     let token = opts.token;
     if (!token) {
       const res = await fetch(`${server2}/api/agents`, {
@@ -24889,7 +24902,7 @@ var AcpClient = class _AcpClient {
         const onReg = () => finish(resolve);
         const onErr = (ev) => finish(
           () => reject(
-            /auth/i.test(ev?.message ?? "") ? new AcpAuthError("invalid or expired ACP token \u2014 get a fresh connect command") : new Error(ev?.message ?? "hub rejected the connection")
+            /auth/i.test(ev?.message ?? "") ? new JefriAuthError("invalid or expired Jefri Chat token \u2014 get a fresh connect command") : new Error(ev?.message ?? "hub rejected the connection")
           )
         );
         const timer = setTimeout(
@@ -25017,7 +25030,7 @@ var AcpClient = class _AcpClient {
   }
   send(ev) {
     if (!this.ws || this.ws.readyState !== this.ws.OPEN)
-      throw new Error("not connected to the ACP hub (reconnecting) \u2014 try again in a moment");
+      throw new Error("not connected to the Jefri Chat hub (reconnecting) \u2014 try again in a moment");
     this.ws.send(JSON.stringify(ev));
   }
   // --- actions -------------------------------------------------------------
@@ -25763,7 +25776,7 @@ function saveWatermark() {
   }
 }
 function registerAcpTools(server2, ctx) {
-  const ENABLE_E2E = process.env.ACP_ENABLE_E2E === "true";
+  const ENABLE_E2E = process.env.JEFRI_ENABLE_E2E === "true";
   const e2eServer = ENABLE_E2E ? server2 : { registerTool: () => void 0 };
   const withClient = async (fn) => {
     try {
@@ -26889,8 +26902,8 @@ async function fetchWithTimeout(url, opts, ms) {
   }
 }
 async function runDoctor() {
-  const SERVER2 = process.env.ACP_SERVER ?? "http://localhost:4000";
-  const TOKEN2 = process.env.ACP_TOKEN ?? "";
+  const SERVER2 = process.env.JEFRI_SERVER ?? "http://localhost:4000";
+  const TOKEN2 = process.env.JEFRI_TOKEN ?? "";
   console.log(`
 ${C.b}\u{1FA7A} Jefri Chat connector \u2014 setup check${C.x}
 `);
@@ -26900,9 +26913,9 @@ ${C.b}\u{1FA7A} Jefri Chat connector \u2014 setup check${C.x}
   pass(`Connector jefrichat-mcp v${connectorVersion()}`, "npm i -g jefrichat-mcp@latest to update");
   pass(`Hub URL ${SERVER2}`);
   if (!TOKEN2)
-    fail2("No ACP_TOKEN set", "Get your token from jefrichat.com \u2192 Connect, then re-add the connector");
-  else if (!TOKEN2.startsWith("acp_"))
-    warn(`Token doesn't look right (${mask(TOKEN2)})`, "Tokens start with acp_ \u2014 check you copied the whole thing");
+    fail2("No JEFRI_TOKEN set", "Get your token from jefrichat.com \u2192 Connect, then re-add the connector");
+  else if (!TOKEN2.startsWith("jefri_") && !TOKEN2.startsWith("acp_"))
+    warn(`Token doesn't look right (${mask(TOKEN2)})`, "Tokens start with jefri_ \u2014 check you copied the whole thing");
   else pass(`Token present (${mask(TOKEN2)})`);
   if (TOKEN2) {
     try {
@@ -26955,20 +26968,25 @@ ${C.b}\u{1FA7A} Jefri Chat connector \u2014 setup check${C.x}
 }
 
 // src/index.ts
-var SERVER = process.env.ACP_SERVER ?? "http://localhost:4000";
-var TOKEN = process.env.ACP_TOKEN;
-var USERNAME = process.env.ACP_AS ?? "claude_agent";
-var NAME = process.env.ACP_NAME ?? USERNAME;
-var TAGS = (process.env.ACP_TAGS ?? "").split(",").map((s) => s.trim()).filter(Boolean);
-var CAPS = (process.env.ACP_CAPABILITIES ?? "coding").split(",").map((s) => s.trim()).filter(Boolean);
+var SERVER = process.env.JEFRI_SERVER ?? "http://localhost:4000";
+var TOKEN = process.env.JEFRI_TOKEN;
+var USERNAME = process.env.JEFRI_AS ?? "claude_agent";
+var NAME = process.env.JEFRI_NAME ?? USERNAME;
+var TAGS = (process.env.JEFRI_TAGS ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+var CAPS = (process.env.JEFRI_CAPABILITIES ?? "coding").split(",").map((s) => s.trim()).filter(Boolean);
 var log = (...a) => console.error("[jefrichat-mcp]", ...a);
-var TOKEN_CACHE = path2.join(os5.homedir(), ".acp", "tokens.json");
+var TOKEN_CACHE = path2.join(os5.homedir(), ".jefri", "tokens.json");
+var LEGACY_TOKEN_CACHE = path2.join(os5.homedir(), ".acp", "tokens.json");
 var cacheKey = `${SERVER}::${USERNAME}`;
 function readTokenCache() {
   try {
     return JSON.parse(fs6.readFileSync(TOKEN_CACHE, "utf8"));
   } catch {
-    return {};
+    try {
+      return JSON.parse(fs6.readFileSync(LEGACY_TOKEN_CACHE, "utf8"));
+    } catch {
+      return {};
+    }
   }
 }
 function cacheToken(tok) {
@@ -26983,21 +27001,21 @@ function ensureClient() {
   if (!clientPromise) {
     clientPromise = (async () => {
       const known = TOKEN ?? readTokenCache()[cacheKey];
-      const provision = () => AcpClient.connect({
+      const provision = () => JefriClient.connect({
         server: SERVER,
         username: USERNAME,
         name: NAME,
         tags: TAGS,
         capabilities: CAPS,
         status: "online",
-        ownerToken: process.env.ACP_OWNER_TOKEN
+        ownerToken: process.env.JEFRI_OWNER_TOKEN
         // owned by you → shows in your observability
       });
       let c;
       if (known) {
-        c = await AcpClient.connect({ server: SERVER, token: known, status: "online" });
+        c = await JefriClient.connect({ server: SERVER, token: known, status: "online" });
         if (!c.identity) {
-          if (TOKEN) throw new Error("ACP_TOKEN was rejected by the server");
+          if (TOKEN) throw new Error("JEFRI_TOKEN was rejected by the server");
           log("cached token rejected, re-provisioning by username");
           c = await provision();
           if (c.identity) cacheToken(c.token);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jefrichat-mcp",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Jefri Chat connector — join the Jefri Chat network (WhatsApp for AI agents) from any MCP client (Claude, Codex, Cursor, …).",
   "type": "module",
   "bin": {
@@ -36,7 +36,7 @@
     "@types/cors": "^2.8.17",
     "@types/express": "^4.17.21",
     "@types/node": "^22.10.2",
-    "acp-sdk": "workspace:*",
+    "jefri-sdk": "workspace:*",
     "cors": "^2.8.5",
     "esbuild": "^0.28.1",
     "express": "^4.21.2",