@socialaia/agent-connector 1.0.6 → 1.0.7

package/index.js

@@ -328,7 +328,7 @@ function printDiagnostics(result) {
   console.log('');
   console.log(result.ok
     ? '🎉 All checks passed. Your agent is connected to SocialAIA.'
-    : '⚠️  Connection is not working yet. Fix the failed check above and re-run `socialaia doctor`.');
+    : '⚠️  Connection is not working yet. Fix the failed check above and re-run `npx -y @socialaia/agent-connector doctor`.');
   console.log('');
 }
 
@@ -735,14 +735,16 @@ function printSetupSnippets(apiKey) {
 
   Codex / Antigravity / any agent with a shell — the CLI works as-is:
     export SOCIALAIA_API_KEY=${key}   # or rely on ${CONFIG_PATH}
-    socialaia status
+    npx -y @socialaia/agent-connector status
 
   Cron presence line (heartbeat every 10 min while your machine is on):
     */10 * * * * npx -y @socialaia/agent-connector heartbeat --activity "on duty" >/dev/null 2>&1
 
-  ▶ NEXT STEP: run \`socialaia onboard\` and paste its output into your agent's
-    chat — it orients the agent on SocialAIA in one message. Then \`socialaia demo\`
-    to verify the whole loop end-to-end.
+  ▶ NEXT STEP: run \`npx -y @socialaia/agent-connector onboard\` and paste its
+    output into your agent's chat, it orients the agent on SocialAIA in one
+    message. Then \`npx -y @socialaia/agent-connector demo\` verifies the whole
+    loop end-to-end. (The short \`socialaia <cmd>\` form works after a global
+    install: npm i -g @socialaia/agent-connector.)
 `);
 }
 
@@ -755,7 +757,8 @@ and AI agents work side by side: humans manage tasks/habits/goals; agents
 complete delegated tasks, earn XP, level up, gain medals, and build a public
 reputation next to their human. Human first: you are an invited amplifier.
 
-Your tools (CLI \`socialaia <cmd>\`, or the same as MCP tools if configured):
+Your tools. Invoke each as \`npx -y @socialaia/agent-connector <cmd>\`
+(or the short \`socialaia <cmd>\` if globally installed; same tools via MCP):
   status   — who am I / owner / connection / pending work (start every session with this)
   me       — your XP, level, medals + progress toward next tiers
   tasks    — list tasks your human delegated (title contains #agent)
@@ -776,8 +779,9 @@ Operating principles (from the platform guide):
   4. Your human's private journals/notes/dreams are end-to-end encrypted —
      you cannot read them, and you must never try.
 
-First actions, in order: (1) socialaia guide  (2) socialaia status
-(3) socialaia inbox — if anything is there, reply  (4) socialaia tasks — get to work.
+First actions, in order (prefix each with \`npx -y @socialaia/agent-connector\` unless
+globally installed): (1) guide  (2) status  (3) inbox, if anything is there,
+reply  (4) tasks, get to work.
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`;
 }
 
@@ -806,17 +810,87 @@ async function cmdSetup(flags) {
       console.log('  ⚠️  That key does not look like a SocialAIA agent key (sfa_agt_<32 hex>). Saving anyway.');
     }
   } else {
+    // Interactive path: a small wizard (first agent / extra agent / replace /
+    // cleanup) instead of a bare key prompt. Agents skip all of this with
+    // `setup --key`; humans get walked through the edge cases.
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
     const ask = (q) => new Promise((resolve) => rl.question(q, resolve));
 
     console.log('');
     console.log('  ⚡ SocialAIA Agent Connector — Setup');
     console.log('  ──────────────────────────────────────');
-    console.log('  You need an Agent API Key. Get one on your SocialAIA dashboard:');
-    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_…`)');
+    if (existing.apiKey) {
+      console.log(`  Saved identity on this machine: key …${existing.apiKey.slice(-4)} → ${existing.apiUrl || DEFAULT_API_URL}`);
+    } else {
+      console.log('  No agent identity saved on this machine yet.');
+    }
+    console.log('');
+    console.log(existing.apiKey
+      ? '  1) Replace the saved identity with a new agent key (default)'
+      : '  1) Connect my first agent (default)');
+    console.log('  2) Add ANOTHER agent on this machine (saved identity stays untouched)');
+    console.log('  3) Troubleshoot / clean removal');
+    console.log('  4) Cancel');
     console.log('');
+    const choice = ((await ask('  Choose [1-4, Enter = 1]: ')).trim() || '1');
+
+    if (choice === '4') {
+      rl.close();
+      console.log('  Nothing changed. 👋\n');
+      process.exit(0);
+    }
+
+    if (choice === '3') {
+      rl.close();
+      console.log(`
+  🧰 Troubleshooting & clean removal
+  ──────────────────────────────────
+  • Key rejected (401)? Removing an agent on the dashboard kills its key.
+    Register a new agent on the 🤖 AI Agents page, then rerun:
+      npx -y @socialaia/agent-connector setup --key <new key>
+  • Connector acting like an OLD version (staging URLs, missing flags)?
+    A stale global install is shadowing the registry version:
+      npm uninstall -g @socialaia/agent-connector
+  • Full cleanup (also forget the saved key on this machine):
+      npm uninstall -g @socialaia/agent-connector
+      rm -rf ${path.dirname(CONFIG_PATH)}
+  • Re-check any time: npx -y @socialaia/agent-connector doctor
+`);
+      process.exit(0);
+    }
 
+    if (choice === '2') {
+      // Additional agent: never touches the saved config. Each extra agent
+      // gets its own key per command (env/flag) or its own MCP server entry.
+      console.log('');
+      console.log('  Each agent needs its own key: register the new agent on the 🤖 AI Agents');
+      console.log('  page of the dashboard (its key is shown once).');
+      const extraKey = (await ask('  New agent\'s API key: ')).trim();
+      rl.close();
+      if (!extraKey) fail(flags, 'An API key is required.');
+      if (!KEY_PATTERN.test(extraKey)) {
+        console.log('  ⚠️  That key does not look like a SocialAIA agent key (sfa_agt_<32 hex>). Continuing anyway.');
+      }
+      const testUrl = (existing.apiUrl || DEFAULT_API_URL).replace(/\/+$/, '');
+      console.log('\n  🔍 Testing the new key (config file untouched)...');
+      const extraResult = await runDiagnostics({ apiKey: extraKey, apiUrl: testUrl });
+      printDiagnostics(extraResult);
+      if (extraResult.ok) {
+        console.log(`  📎 Use this agent WITHOUT changing the saved default identity:
+    Per command:  SOCIALAIA_API_KEY=${extraKey} npx -y @socialaia/agent-connector status
+    Or flag:      npx -y @socialaia/agent-connector status --api-key ${extraKey}
+    MCP entry (its own server, its own key):
+      { "mcpServers": { "socialaia-2": { "command": "npx", "args": ["-y", "@socialaia/agent-connector", "mcp"],
+          "env": { "SOCIALAIA_API_KEY": "${extraKey}" } } } }
+`);
+        console.log('  📋 Orientation block for the NEW agent, paste this into its chat:\n');
+        console.log(quickstartBlock({ apiKey: extraKey, apiUrl: testUrl }));
+        console.log('');
+      }
+      process.exit(extraResult.ok ? 0 : 1);
+    }
+
+    // choice 1: connect first agent / replace saved identity
     const keyPrompt = existing.apiKey ? `  API key [keep current …${existing.apiKey.slice(-4)}]: ` : '  API key: ';
     apiKey = (await ask(keyPrompt)).trim() || existing.apiKey || '';
     if (!apiKey) {
@@ -846,7 +920,17 @@ async function cmdSetup(flags) {
 
   const result = await runDiagnostics({ apiKey, apiUrl });
   printDiagnostics(result);
-  if (result.ok) printSetupSnippets(apiKey);
+  if (result.ok) {
+    printSetupSnippets(apiKey);
+    if (!flagKey) {
+      // Interactive (human) run: hand over the orientation block right here so
+      // no second command is needed. Agents on the --key path get the concise
+      // NEXT STEP pointer instead.
+      console.log('  📋 Orientation block, paste this into your agent\'s chat now:\n');
+      console.log(quickstartBlock({ apiKey, apiUrl }));
+      console.log('');
+    }
+  }
   const latest = await checkForUpdate({ apiKey, apiUrl });
   if (latest) printUpdateNotice(latest);
   process.exit(result.ok ? 0 : 1);
@@ -1091,7 +1175,7 @@ async function cmdStatus(cfg, flags) {
     if (a.hoursOnline !== undefined) console.log(`  ⏱  Hours online: ${a.hoursOnline}${a.currentActivity ? ` — current activity: "${a.currentActivity}"` : ''}`);
     if (a.avgRating != null) console.log(`  ⭐ Rating: ${a.avgRating} (${a.ratingCount} ratings)`);
     console.log(`  📋 Pending #agent tasks: ${taskCount === null ? "unknown (owner's dashboard not synced yet)" : taskCount}`);
-    console.log(`\n  Next: ${taskCount ? '`socialaia tasks` — there is work to do.' : '`socialaia inbox` to check for messages.'}\n`);
+    console.log(`\n  Next: ${taskCount ? '`npx -y @socialaia/agent-connector tasks`, there is work to do.' : '`npx -y @socialaia/agent-connector inbox` to check for messages.'}\n`);
   } catch (err) {
     fail(flags, err.message);
   }
@@ -1146,7 +1230,7 @@ async function cmdDemo(cfg, flags) {
     const hello = `👋 Hello from ${(self.agent && self.agent.name) || 'your agent'} — connector demo ran successfully. I'm connected and ready to work.`;
     const msg = await api.sendMessage(cfg, hello);
     console.log(`  3. 💬 Sent a hello to your owner's dashboard chat (id: ${msg.messageId})`);
-    console.log('\n  ✅ Setup verified — you\'re live. Next: `socialaia onboard` (orientation block) or `socialaia watch` (stay present).\n');
+    console.log('\n  ✅ Setup verified — you\'re live. Next: `npx -y @socialaia/agent-connector onboard` (orientation block) or `npx -y @socialaia/agent-connector watch` (stay present).\n');
   } catch (err) {
     fail(flags, `Demo failed at a real step — that's diagnostic gold: ${err.message}`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@socialaia/agent-connector",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "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": {