@floomhq/signaldash 0.4.0 → 0.6.0

package/bin/sd.mjs

@@ -8,6 +8,13 @@ import { homedir } from "node:os";
 import { createInterface } from "node:readline";
 import { fileURLToPath } from "node:url";
 
+// Lazy-load presentation deps so `mcp` (stdio, machine-facing) stays clean/fast.
+async function ui() {
+  const [{ default: chalk }, { default: prompts }, { default: ora }, { default: open }] =
+    await Promise.all([import("chalk"), import("prompts"), import("ora"), import("open")]);
+  return { chalk, prompts, ora, open };
+}
+
 const DEFAULT_BACKEND = process.env.SIGNALDASH_BACKEND || "https://signaldash-api.floom.dev";
 
 function configPaths() {
@@ -77,8 +84,12 @@ export async function cmdConnect(provider, dependencies = {}) {
     process.exitCode = 1;
     return;
   }
-  log(`Open this to connect your ${provider}:\n\n  ${r.json.url}\n`);
-  log("Waiting for authentication to complete...");
+  const { chalk, ora, open } = await ui();
+  log("\n  " + chalk.dim("Opening your browser. If it does not open, use this link:"));
+  log("  " + chalk.cyan(r.json.url) + "\n");
+  try { await open(r.json.url); } catch {}
+  const spin = ora({ text: `Waiting for ${provider} authentication...`, indent: 2 }).start();
+  dependencies._spin = spin;
 
   const timeoutMs = positiveMilliseconds("SIGNALDASH_CONNECT_TIMEOUT_MS", 5 * 60 * 1000);
   const pollMs = positiveMilliseconds("SIGNALDASH_CONNECT_POLL_MS", 2000);
@@ -86,10 +97,12 @@ export async function cmdConnect(provider, dependencies = {}) {
   while (now() < deadline) {
     const status = await request(`/connect/${provider}/status`, undefined, { method: "GET" });
     if (status.status === 200 && status.json.connected) {
-      log(`Connected ${provider}${status.json.name ? `: ${status.json.name}` : ""}`);
+      if (dependencies._spin) dependencies._spin.succeed(`Connected ${provider}${status.json.name ? `: ${status.json.name}` : ""}`);
+      else log(`Connected ${provider}`);
       return;
     }
     if (status.status !== 202) {
+      if (dependencies._spin) dependencies._spin.fail("connect failed");
       error("connect status failed:", status.json.error || status.status);
       process.exitCode = 1;
       return;
@@ -97,7 +110,8 @@ export async function cmdConnect(provider, dependencies = {}) {
     await sleep(Math.min(pollMs, Math.max(0, deadline - now())));
   }
 
-  error(`Not connected yet. The link above stays valid — open it, finish authenticating, then run:\n  npx @floomhq/signaldash connect ${provider}`);
+  if (dependencies._spin) dependencies._spin.stop();
+  error(`Not connected yet. The link above stays valid; open it, finish authenticating, then run:\n  npx @floomhq/signaldash connect ${provider}\nManual fallback:\n  signaldash connect ${provider} claim <account_id>`);
   process.exitCode = 1;
 }
 export async function cmdClaim(provider, accountId, dependencies = {}) {
@@ -161,23 +175,51 @@ export async function cmdSkill(dependencies = {}) {
 export async function cmdSetup(code, dependencies = {}) {
   const log = dependencies.log || console.log;
   const { execSync } = await import("node:child_process");
-  log("SignalDash setup\n");
-  await cmdLogin(code, undefined, dependencies);
+  const { chalk, prompts } = await ui();
+
+  log("");
+  log("  " + chalk.bold.cyan("SignalDash") + chalk.dim("  secure LinkedIn + WhatsApp access for your agent"));
+  log("");
+
+  await cmdLogin(code, undefined, { ...dependencies, log: () => {} });
   if (process.exitCode === 1) return;
-  await cmdSkill(dependencies);
+  log("  " + chalk.green("+") + " logged in");
+
+  await cmdSkill({ ...dependencies, log: () => {} });
+  log("  " + chalk.green("+") + " agent skill installed");
+
   try {
     execSync("claude mcp add signaldash -- npx -y @floomhq/signaldash mcp", { stdio: "ignore" });
-    log("Registered the MCP with Claude Code.");
+    log("  " + chalk.green("+") + " MCP registered with Claude Code");
   } catch {
-    log("To finish in Cursor, add to .cursor/mcp.json:");
-    log('  {"mcpServers":{"signaldash":{"command":"npx","args":["-y","@floomhq/signaldash","mcp"]}}}');
+    log("  " + chalk.yellow("!") + " Claude Code not found. For Cursor, add to .cursor/mcp.json:");
+    log("    " + chalk.dim('{"mcpServers":{"signaldash":{"command":"npx","args":["-y","@floomhq/signaldash","mcp"]}}}'));
   }
-  for (const provider of ["linkedin", "whatsapp"]) {
-    log(`\n--- connect ${provider} ---`);
+  log("");
+
+  const choice = dependencies.choice ?? (await prompts({
+    type: "select",
+    name: "value",
+    message: "Which accounts do you want to connect?",
+    choices: [
+      { title: "WhatsApp only", value: ["whatsapp"] },
+      { title: "LinkedIn only", value: ["linkedin"] },
+      { title: "Both", value: ["linkedin", "whatsapp"] },
+      { title: "Skip for now", value: [] },
+    ],
+    initial: 0,
+  })).value;
+
+  if (!choice || choice.length === 0) {
+    log("\n  " + chalk.dim("Nothing connected. Run `signaldash connect whatsapp` or `connect linkedin` anytime."));
+    return;
+  }
+  for (const provider of choice) {
+    log("");
     await cmdConnect(provider, dependencies);
-    process.exitCode = 0; // a skipped channel should not fail the whole setup
+    process.exitCode = 0;
   }
-  log("\nDone. Ask your agent: \"list my recent LinkedIn chats and draft replies.\"");
+  log("\n  " + chalk.dim("Try: ") + chalk.white('"list my recent whatsapp chats and draft replies"') + "\n");
 }
 
 export async function main(argv = process.argv.slice(2), dependencies = {}) {
@@ -193,9 +235,13 @@ export async function main(argv = process.argv.slice(2), dependencies = {}) {
   else log(`SignalDash — secure LinkedIn + WhatsApp access for your agent.\n\n  signaldash login <invite-code> [--backend URL]\n  signaldash connect linkedin|whatsapp\n  signaldash connect linkedin|whatsapp claim <account_id>\n  signaldash mcp\n  signaldash skill            install the agent skill\n\nThe agent reaches channels only through SignalDash. No keys on your machine.`);
 }
 
-if (
-  process.argv[1] &&
-  realpathSync(process.argv[1]) === fileURLToPath(import.meta.url)
-) {
+function isDirectRun() {
+  try {
+    return Boolean(process.argv[1]) && realpathSync(process.argv[1]) === fileURLToPath(import.meta.url);
+  } catch {
+    return false;
+  }
+}
+if (isDirectRun()) {
   await main();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floomhq/signaldash",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Secure LinkedIn and WhatsApp MCP access for AI agents",
   "type": "module",
   "bin": {
@@ -27,5 +27,11 @@
     "unipile",
     "ai-agent"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "5.3.0",
+    "prompts": "2.4.2",
+    "ora": "8.0.1",
+    "open": "10.1.0"
+  }
 }

package/skills/signaldash/SKILL.md

@@ -34,6 +34,16 @@ Cursor: add to `.cursor/mcp.json` →
 | `wa_read_messages` | read a WhatsApp thread (`chat_id`) |
 | `wa_send_message` | send a WhatsApp message (`chat_id`, `text`) |
 
+## Enforced by the server (you cannot bypass these)
+
+- **Read before send.** Sending to a chat you have not read recently returns
+  `428 read_before_send_required`. Call `*_read_messages` on that chat first.
+- **No double-send.** An identical message to the same chat returns
+  `409 duplicate_send`.
+- **Daily send cap + pacing.** Exceeding it returns `429 rate_limit_exceeded`.
+
+These are server-side guards, not suggestions. Do not try to work around them.
+
 ## The rules you MUST follow
 
 These protect the user's accounts from being restricted or banned, and protect