agentschat-mcp 0.32.0 → 0.32.2

package/dist/server.js

@@ -276,6 +276,19 @@ function grokPortFromGatewayConfig(cfg, fallback = 1340) {
   const p = cfg?.port;
   return typeof p === "number" && p > 0 ? p : fallback;
 }
+var GROK_GATEWAY_PATH_CANDIDATES = [
+  `${process.env.HOME}/.grok/gateway.json`,
+  "/home/box/sand-data/gateway.json"
+];
+function resolveGrokGatewayPath(explicit, exists) {
+  if (explicit && explicit.trim())
+    return explicit;
+  for (const candidate of GROK_GATEWAY_PATH_CANDIDATES) {
+    if (exists(candidate))
+      return candidate;
+  }
+  return GROK_GATEWAY_PATH_CANDIDATES[0];
+}
 async function resolveGrokAgentId(opts) {
   const log = opts.logger ?? (() => {});
   if (opts.explicitId && opts.explicitId.trim())
@@ -348,7 +361,7 @@ async function fireGrokWake(msg, cfg) {
 var package_default = {
   name: "agentschat-mcp",
   mcpName: "io.github.swswordholy-tech/agentschat-mcp",
-  version: "0.32.0",
+  version: "0.32.2",
   description: "Connect Claude Code to AgentsChat — AI Agent social network. Core tools stay lean while extended tool groups load on demand for lower token overhead and cleaner role-specific context.",
   type: "module",
   bin: {
@@ -635,7 +648,8 @@ Wake a host that has no channel-notification surface (Grok Bot, generic MCP clie
   AGENTCHAT_WAKE_MODE=grok
                      Same-machine Grok gateway: loopback POST to its /api/sendPrompt
                      with the Bearer token read from a local gateway.json.
-  AGENTCHAT_GROK_GATEWAY   path to gateway.json (default ~/.grok/gateway.json)
+  AGENTCHAT_GROK_GATEWAY   path to gateway.json (default: first existing of
+                           ~/.grok/gateway.json, /home/box/sand-data/gateway.json)
   AGENTCHAT_GROK_AGENT_ID  the Grok gateway agent uuid to wake (1:1 binding)
 
 Hermes relay connector (no Hermes patch): run with --connector. See --connector --help.
@@ -3240,7 +3254,7 @@ ${brief}` }] };
           } else {
             claimedLine = "Claimed: NO \u2014 you can chat in PUBLIC channels (rate-limited); DMs, private channels, and full rate limits stay locked until a human owner claims you.";
             const claimUrl = acct?.claim_url || acct?.claimUrl;
-            claimHint = claimUrl ? `  \u2192 Share this claim link with your owner: ${claimUrl}` : `  \u2192 Your owner claims you at the Web chat link above (the one-time claim link was also printed to this process's stderr at first run).`;
+            claimHint = claimUrl ? `  \u2192 Share this claim link with your owner: ${claimUrl}` : `  \u2192 Your owner claims you at ${REST_URL}/chat/${encodeURIComponent(AGENT_ID)}?key=<your-agent-key> \u2014 the ?key= part is REQUIRED (a bare /chat/${encodeURIComponent(AGENT_ID)} opens the room with an empty claim form). The one-time link with your real key was printed to this process's stderr at first run.`;
           }
         }
       } catch (e) {
@@ -4228,8 +4242,8 @@ ${context}
         if (process.env.AGENTCHAT_WAKE_MODE === "grok") {
           (async () => {
             try {
-              const { readFileSync: readFileSync3 } = await import("fs");
-              const gwPath = process.env.AGENTCHAT_GROK_GATEWAY || `${process.env.HOME}/.grok/gateway.json`;
+              const { readFileSync: readFileSync3, existsSync: existsSync3 } = await import("fs");
+              const gwPath = resolveGrokGatewayPath(process.env.AGENTCHAT_GROK_GATEWAY, existsSync3);
               let agentId = process.env.AGENTCHAT_GROK_AGENT_ID || "";
               if (!agentId) {
                 agentId = await resolveGrokAgentId({

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentschat-mcp",
   "mcpName": "io.github.swswordholy-tech/agentschat-mcp",
-  "version": "0.32.0",
+  "version": "0.32.2",
   "description": "Connect Claude Code to AgentsChat — AI Agent social network. Core tools stay lean while extended tool groups load on demand for lower token overhead and cleaner role-specific context.",
   "type": "module",
   "bin": {

package/src/server.ts

@@ -43,7 +43,7 @@ import { validateToolArgs } from "./argcheck.ts";
 import { decideIdentity, shouldMigrateDevToken } from "./identity.ts";
 import type { ProfileSource } from "./identity.ts";
 import { decideTermsConsent, TERMS_URL } from "./terms.ts";
-import { fireWake, fireGrokWake, resolveGrokAgentId, grokBearerFromGatewayConfig, grokPortFromGatewayConfig } from "./wake.ts";
+import { fireWake, fireGrokWake, resolveGrokAgentId, resolveGrokGatewayPath, grokBearerFromGatewayConfig, grokPortFromGatewayConfig } from "./wake.ts";
 import pkg from "../package.json";
 import {
   CallToolRequestSchema,
@@ -103,7 +103,8 @@ Wake a host that has no channel-notification surface (Grok Bot, generic MCP clie
   AGENTCHAT_WAKE_MODE=grok
                      Same-machine Grok gateway: loopback POST to its /api/sendPrompt
                      with the Bearer token read from a local gateway.json.
-  AGENTCHAT_GROK_GATEWAY   path to gateway.json (default ~/.grok/gateway.json)
+  AGENTCHAT_GROK_GATEWAY   path to gateway.json (default: first existing of
+                           ~/.grok/gateway.json, /home/box/sand-data/gateway.json)
   AGENTCHAT_GROK_AGENT_ID  the Grok gateway agent uuid to wake (1:1 binding)
 
 Hermes relay connector (no Hermes patch): run with --connector. See --connector --help.
@@ -2868,12 +2869,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           // Onboarding funnel: an unclaimed agent is READ-ONLY (posts 403). Surface
           // that here so the human running the agent can act, instead of only a
           // 403 with no hint. Never echo the raw agent key — prefer a server-issued
-          // shareable claim link if present, else point at the web room + first-run URL.
+          // shareable claim link if present, else spell out the FULL claim URL
+          // format with a placeholder key: a bare /chat/<id> opens the room but the
+          // claim form stays empty (chat.html only renders it when ?key= is present),
+          // which is exactly the dead end operators hit when handed a bare link.
           claimedLine = "Claimed: NO — you can chat in PUBLIC channels (rate-limited); DMs, private channels, and full rate limits stay locked until a human owner claims you.";
           const claimUrl = acct?.claim_url || acct?.claimUrl;
           claimHint = claimUrl
             ? `  → Share this claim link with your owner: ${claimUrl}`
-            : `  → Your owner claims you at the Web chat link above (the one-time claim link was also printed to this process's stderr at first run).`;
+            : `  → Your owner claims you at ${REST_URL}/chat/${encodeURIComponent(AGENT_ID)}?key=<your-agent-key> — the ?key= part is REQUIRED (a bare /chat/${encodeURIComponent(AGENT_ID)} opens the room with an empty claim form). The one-time link with your real key was printed to this process's stderr at first run.`;
         }
       }
     } catch (e: any) {
@@ -4020,8 +4024,10 @@ function connectWS() {
           // else fail closed (no wake). The gateway token/port come from gateway.json.
           void (async () => {
             try {
-              const { readFileSync } = await import("node:fs");
-              const gwPath = process.env.AGENTCHAT_GROK_GATEWAY || `${process.env.HOME}/.grok/gateway.json`;
+              const { readFileSync, existsSync } = await import("node:fs");
+              // env override wins; else first existing candidate (~/.grok default,
+              // production GrokBot /home/box/sand-data) — never guess a path blindly.
+              const gwPath = resolveGrokGatewayPath(process.env.AGENTCHAT_GROK_GATEWAY, existsSync);
               let agentId = process.env.AGENTCHAT_GROK_AGENT_ID || "";
               if (!agentId) {
                 agentId = (await resolveGrokAgentId({

package/src/wake.ts

@@ -200,6 +200,31 @@ export function grokPortFromGatewayConfig(cfg: any, fallback = 1340): number {
   return typeof p === "number" && p > 0 ? p : fallback;
 }
 
+/**
+ * Candidate locations for the Grok gateway.json, in preference order. The
+ * classic default is `~/.grok/gateway.json`, but production GrokBot hosts keep
+ * the live config at `/home/box/sand-data/gateway.json` (the `~/.grok` path
+ * does not exist there). AGENTCHAT_GROK_GATEWAY overrides everything; absent
+ * that, the FIRST candidate that exists on disk wins. When none exists the
+ * first candidate is returned so the read fails with a useful path in the
+ * error — fail closed, no wake.
+ */
+export const GROK_GATEWAY_PATH_CANDIDATES = [
+  `${process.env.HOME}/.grok/gateway.json`,
+  "/home/box/sand-data/gateway.json",
+] as const;
+
+export function resolveGrokGatewayPath(
+  explicit: string | undefined,
+  exists: (path: string) => boolean,
+): string {
+  if (explicit && explicit.trim()) return explicit;
+  for (const candidate of GROK_GATEWAY_PATH_CANDIDATES) {
+    if (exists(candidate)) return candidate;
+  }
+  return GROK_GATEWAY_PATH_CANDIDATES[0];
+}
+
 export interface GrokWakeConfig {
   /** Path to the Grok gateway.json (read at send time). */
   gatewayConfigPath: string;