@floomhq/signaldash 0.3.0 → 0.5.0

package/README.md

@@ -102,6 +102,10 @@ receive the Unipile access key.
 SignalDash enforces a daily send cap. The safe-usage skill adds the human
 workflow around that runtime control:
 
+- Every successful send includes `rate_limit.limit`, `used`, `remaining`, and
+  `resets_at`, plus matching `X-RateLimit-*` headers. When the per-user cap is
+  exhausted, SignalDash returns HTTP 429 with `code: "rate_limit_exceeded"` and
+  `Retry-After`. Usage is persisted server-side and resets at midnight UTC.
 - Read the exact thread before every send.
 - Never infer a recipient from a partial name.
 - Never send a duplicate or retry an ambiguous timeout without re-reading.

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(`Connection timed out. Manual fallback:\n  signaldash connect ${provider} claim <account_id>`);
+  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 = {}) {
@@ -156,10 +170,64 @@ export async function cmdSkill(dependencies = {}) {
   log("Your agent now knows how to use LinkedIn + WhatsApp safely through SignalDash.");
 }
 
+
+// One-command onboarding: login + skill + MCP registration + connect both channels.
+export async function cmdSetup(code, dependencies = {}) {
+  const log = dependencies.log || console.log;
+  const { execSync } = await import("node:child_process");
+  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;
+  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("  " + chalk.green("+") + " MCP registered with Claude Code");
+  } catch {
+    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"]}}}'));
+  }
+  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;
+  }
+  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 = {}) {
   const [cmd, a, b, c] = argv;
   const log = dependencies.log || console.log;
-  if (cmd === "login") await cmdLogin(a, b === "--backend" ? c : undefined, dependencies);
+  if (cmd === "setup") await cmdSetup(a, dependencies);
+  else if (cmd && /^[0-9a-f]{8,}$/i.test(cmd) && !["login","connect","mcp","skill"].includes(cmd)) await cmdSetup(cmd, dependencies);
+  else if (cmd === "login") await cmdLogin(a, b === "--backend" ? c : undefined, dependencies);
   else if (cmd === "connect" && b === "claim") await cmdClaim(a, c, dependencies);
   else if (cmd === "connect") await cmdConnect(a, dependencies);
   else if (cmd === "mcp") await runMcp(dependencies);
@@ -167,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.3.0",
+  "version": "0.5.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"
+  }
 }