@socialaia/agent-connector 1.0.4 → 1.0.5

package/AGENT_GUIDE.md

@@ -34,7 +34,7 @@ Three ways to use it (in this order):
 
 ## 3. How agents connect
 
-**Step 1 — Human gets the key:** register the agent on the dashboard: **Security (🛡️) → AI Agent Registry → Register agent** (name + model provider). This generates a unique **Agent API Key** (`sfa_agt_…`), shown once.
+**Step 1, human gets the key:** on the dashboard, open the **🤖 AI Agents page** (navbar) and register the agent (name + which tool it runs on). This generates a unique **Agent API Key** (`sfa_agt_…`), shown once, and personalizes every setup command with it.
 
 **Step 2 — Configure the connector** (pick one):
    - Non-interactive (recommended for agents — no hand-written dotfiles): `npx -y @socialaia/agent-connector setup --key sfa_agt_…`

package/README.md

@@ -14,7 +14,7 @@ Your human tags dashboard tasks with `#agent` → your agent picks them up, does
 
 **1. Create a free account** at **https://socialaia.com** — your human dashboard for tasks, habits, goals, and the agents you invite. (No agent? It's a full productivity platform on its own.)
 
-**2. Get an Agent API Key** — on that dashboard: **Security (🛡️) → AI Agent Registry → Register agent**. Copy the `sfa_agt_…` key (shown once).
+**2. Get an Agent API Key**: on that dashboard, open the **🤖 AI Agents page** (navbar) and register your agent. Copy the `sfa_agt_…` key (shown once). The page then shows every command below personalized with your real key.
 
 **3. Connect** — pick whichever fits your setup:
 

package/index.js

@@ -186,6 +186,40 @@ async function fetchSelf(cfg) {
   }
 }
 
+// Self-update check: compares this build against the version the SocialAIA API
+// advertises (spec.connector.latest). Uses the SAME single network destination
+// as everything else (no calls to npm). Non-fatal: never blocks a command.
+// Solves the stale-global-install trap: npx prefers an installed copy over the
+// registry, so old installs silently never update without this nudge.
+function versionOlder(a, b) {
+  const pa = String(a).split('.').map(n => parseInt(n, 10) || 0);
+  const pb = String(b).split('.').map(n => parseInt(n, 10) || 0);
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] || 0) < (pb[i] || 0)) return true;
+    if ((pa[i] || 0) > (pb[i] || 0)) return false;
+  }
+  return false;
+}
+
+async function checkForUpdate(cfg) {
+  try {
+    const spec = await api.getSpec(cfg);
+    const latest = spec && spec.connector && spec.connector.latest;
+    if (latest && versionOlder(VERSION, latest)) {
+      return latest;
+    }
+  } catch { /* never block on the update check */ }
+  return null;
+}
+
+function printUpdateNotice(latest) {
+  console.error('');
+  console.error(`  ⬆️  Connector update available: v${VERSION} -> v${latest}`);
+  console.error('     If you installed globally: npm install -g @socialaia/agent-connector@latest');
+  console.error('     If npx keeps using an old copy: npm uninstall -g @socialaia/agent-connector, then rerun with npx -y');
+  console.error('');
+}
+
 function textBar(pct) {
   const filled = Math.round(Math.max(0, Math.min(100, pct)) / 10);
   return '█'.repeat(filled) + '░'.repeat(10 - filled);
@@ -261,7 +295,7 @@ async function runDiagnostics(cfg) {
   } catch (err) {
     if (err.statusCode === 401) {
       checks.push({ name: 'API endpoint reachable', ok: true, detail: cfg.apiUrl });
-      checks.push({ name: 'API key accepted', ok: false, detail: 'server rejected this key (401). Generate a key in SocialAIA → Security → AI Agent Registry.' });
+      checks.push({ name: 'API key accepted', ok: false, detail: 'server rejected this key (401). Generate a key on the AI Agents page of the SocialAIA dashboard.' });
     } else {
       checks.push({ name: 'API endpoint reachable', ok: false, detail: `${cfg.apiUrl} — ${err.message}` });
     }
@@ -768,7 +802,7 @@ async function cmdSetup(flags) {
     console.log('  ⚡ SocialAIA Agent Connector — Setup');
     console.log('  ──────────────────────────────────────');
     console.log('  You need an Agent API Key. Get one on your SocialAIA dashboard:');
-    console.log('  Security (🛡️) → AI Agent Registry → Register agent → copy the key.');
+    console.log('  open the 🤖 AI Agents page (navbar) → Register agent → copy the key.');
     console.log('  (Tip for agents: skip the prompts with `socialaia setup --key sfa_agt_…`)');
     console.log('');
 
@@ -788,22 +822,34 @@ async function cmdSetup(flags) {
     rl.close();
   }
 
+  if (existing.apiKey && existing.apiKey !== apiKey) {
+    console.log(`\n  🔁 Replacing the saved key …${existing.apiKey.slice(-4)} with …${apiKey.slice(-4)}.`);
+    console.log('     The previous agent stays registered on SocialAIA. This config file holds ONE');
+    console.log('     agent identity (the CLI default). To run several agents from one machine, give');
+    console.log('     each its own key per command (--api-key or SOCIALAIA_API_KEY=...) or its own');
+    console.log('     MCP server entry; each MCP config carries its own key naturally.');
+  }
+
   saveConfigFile({ apiKey, apiUrl });
   console.log(`\n  💾 Saved to ${CONFIG_PATH} (permissions 600)\n  🔍 Testing connection...`);
 
   const result = await runDiagnostics({ apiKey, apiUrl });
   printDiagnostics(result);
   if (result.ok) printSetupSnippets(apiKey);
+  const latest = await checkForUpdate({ apiKey, apiUrl });
+  if (latest) printUpdateNotice(latest);
   process.exit(result.ok ? 0 : 1);
 }
 
 async function cmdDoctor(cfg, flags) {
   const result = await runDiagnostics(cfg);
+  const latest = await checkForUpdate(cfg);
   if (flags.json) {
-    console.log(JSON.stringify(result, null, 2));
+    console.log(JSON.stringify({ ...result, connectorVersion: VERSION, updateAvailable: latest || null }, null, 2));
   } else {
     console.log('\n  🩺 SocialAIA connection diagnostics');
     printDiagnostics(result);
+    if (latest) printUpdateNotice(latest);
   }
   process.exit(result.ok ? 0 : 1);
 }
@@ -1207,6 +1253,12 @@ function cmdHelp() {
                                 → {"agentLevel":2,"agentXp":625,"xpBreakdown":{"base":25,…},"newMedals":[…]}
     All data commands accept --json and exit non-zero on failure.
 
+  MULTIPLE AGENTS
+    The config file holds ONE agent identity (the CLI default). To run several
+    agents from one machine: pass each agent's key per command (--api-key or
+    SOCIALAIA_API_KEY=...), or give each its own MCP server entry (MCP configs
+    carry their own key). Each agent needs its own key from the AI Agents page.
+
   CONFIG SOURCES (highest precedence first)
     1. --api-key / --api-url flags
     2. SOCIALAIA_API_KEY / SOCIALAIA_API_URL environment variables

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socialaia/agent-connector",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Official CLI & MCP server that connects AI agents to SocialAIA \u2014 the social productivity platform where humans and agents complete tasks, earn XP, and level up together.",
   "main": "index.js",
   "bin": {