a2acalling 0.6.16 → 0.6.18

package/SKILL.md

@@ -27,53 +27,26 @@ metadata:
 
 Enable agent-to-agent communication across OpenClaw instances.
 
-## FIRST RUN GATE (Check Before EVERY /a2a Command)
+## Install & Onboarding
 
-Before processing any `/a2a` command that depends on tiers/disclosure (tokens, invites, calls), check onboarding status.
+```bash
+npm install -g a2acalling
+```
 
-Exceptions (do not gate):
-- `/a2a gui` / `/a2a dashboard`
-- `/a2a uninstall`
+Onboarding is automatic. The first time you run any `a2a` command after install, the app detects that setup is incomplete and runs the full onboarding flow inline — port configuration, server start, and a disclosure prompt that tells you which workspace files to scan and how to submit tiered topics.
 
-Onboarding check:
+To manually trigger onboarding (or re-run it):
 
 ```bash
-node - <<'NODE'
-const fs = require('fs');
-const path = require('path');
-
-const dir = process.env.A2A_CONFIG_DIR ||
-  process.env.OPENCLAW_CONFIG_DIR ||
-  path.join(process.env.HOME || '/tmp', '.config', 'openclaw');
-const file = path.join(dir, 'a2a-config.json');
-
-let ok = false;
-try {
-  const cfg = JSON.parse(fs.readFileSync(file, 'utf8'));
-  ok = cfg.onboarding &&
-    cfg.onboarding.version === 2 &&
-    cfg.onboarding.step === 'complete';
-} catch (e) {}
-
-process.stdout.write(ok ? 'onboarded\n' : 'not_onboarded\n');
-NODE
+a2a quickstart          # run onboarding
+a2a quickstart --force  # re-run from scratch
 ```
 
-**If it prints `not_onboarded`:**
-- DO NOT process the requested command yet
-- Tell the user: "A2A needs initial setup. Let me configure your agent's disclosure topics first."
-- Run the deterministic Quickstart flow below to completion (flags-based, step-by-step)
-- Only THEN proceed with the user's original command
-
-**If it prints `onboarded`:** proceed normally.
+After the onboarding walkthrough prints, scan your workspace files (USER.md, SOUL.md, etc.), build the disclosure JSON, and submit:
 
-**Context gathering for onboarding:** Read ALL available context to generate personalized tier topics:
-- **Primary:** USER.md, HEARTBEAT.md, SOUL.md
-- **Skills:** SKILL.md files (workspace + ~/.openclaw/skills/*)
-- **Memory:** memory/*.md files
-- **Project:** CLAUDE.md
-
-Extract: professional context, interests, goals, skills, sensitive areas. Group them into Public/Friends/Family tiers based on sensitivity.
+```bash
+a2a quickstart --submit '<json>'
+```
 
 ## Network Ingress (Internet-Facing Invites)
 

package/bin/cli.js

@@ -1402,10 +1402,37 @@ https://github.com/onthegonow/a2a_calling`;
     if (externalIp) {
       const verifyUrl = `http://${publicHost}/api/a2a/ping`;
       if (serverPort !== 80) {
-        console.log(`\n  Note: Port ${serverPort} must be reachable externally.`);
-        console.log(`  Reverse-proxy /api/a2a/* to localhost:${serverPort}, or open the port in your firewall.`);
+        // Check what's using port 80
+        const port80Status = await isPortListening(80, '127.0.0.1', { timeoutMs: 250 });
+        
+        console.log(`\n  ━━━ Reverse Proxy Setup ━━━`);
+        console.log(`  Server running on port ${serverPort}, but external callers expect port 80/443.`);
+        if (port80Status.listening) {
+          console.log(`  Port 80: in use (likely nginx, caddy, or another web server)`);
+        } else {
+          console.log(`  Port 80: available (but A2A is on ${serverPort})`);
+        }
+        console.log(`\n  RECOMMENDED: Configure your web server to proxy A2A requests:\n`);
+        console.log(`  For nginx, add to your server block:`);
+        console.log(`    location /api/a2a/ {`);
+        console.log(`      proxy_pass http://127.0.0.1:${serverPort}/api/a2a/;`);
+        console.log(`      proxy_http_version 1.1;`);
+        console.log(`      proxy_set_header Host $host;`);
+        console.log(`    }`);
+        console.log(`\n  For Caddy:`);
+        console.log(`    handle /api/a2a/* {`);
+        console.log(`      reverse_proxy 127.0.0.1:${serverPort}`);
+        console.log(`    }`);
+        console.log(`\n  After configuring, update the invite hostname to use port 80:`);
+        console.log(`    Current: ${publicHost}`);
+        console.log(`    Should be: ${externalIp} (without port, defaults to 80)`);
+        console.log(`\n  Or open port ${serverPort} directly in your firewall if no proxy is used.`);
+        console.log(`  ━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
+        console.log(`\n  ACTION REQUIRED: Ask your owner if they want to configure a reverse proxy.`);
+        console.log(`  If they say yes, help them add the nginx/caddy config above.`);
+        console.log(`  If they say no or skip, the invite will use port ${serverPort} directly.`);
       }
-      console.log(`  Verify: curl -s ${verifyUrl}`);
+      console.log(`\n  Verify: curl -s ${verifyUrl}`);
     }
 
     // Save server config and advance onboarding state to awaiting_disclosure.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "a2acalling",
-  "version": "0.6.16",
+  "version": "0.6.18",
   "description": "Agent-to-agent calling for OpenClaw - A2A agent communication",
   "main": "src/index.js",
   "bin": {