a2acalling 0.6.24 → 0.6.26

package/bin/cli.js

@@ -1480,26 +1480,48 @@ https://github.com/onthegonow/a2a_calling`;
         console.log(`\n  RECOMMENDED: Configure reverse proxy to route /api/a2a/* to port ${serverPort}`);
         
         if (hasNginx) {
-          console.log(`\n  ── nginx config (add to /etc/nginx/sites-available/default) ──`);
+          console.log(`\n  ┌─────────────────────────────────────────────────────────────────┐`);
+          console.log(`  │  nginx config — add inside your server {} block                 │`);
+          console.log(`  │  File: /etc/nginx/sites-available/default                       │`);
+          console.log(`  └─────────────────────────────────────────────────────────────────┘`);
+          console.log(``);
+          console.log(`  # ══════════════════════════════════════════════════════════════`);
+          console.log(`  # A2A (Agent-to-Agent) Protocol Proxy`);
+          console.log(`  # ══════════════════════════════════════════════════════════════`);
+          console.log(`  # A2A enables AI agents to communicate across different instances.`);
+          console.log(`  # This proxy routes federation requests from port 80 to the local`);
+          console.log(`  # A2A server on port ${serverPort}.`);
+          console.log(`  #`);
+          console.log(`  # Protocol: https://github.com/onthegonow/a2a_calling`);
+          console.log(`  # All requests to /api/a2a/* are agent-to-agent API calls.`);
+          console.log(`  # ══════════════════════════════════════════════════════════════`);
           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(`      proxy_set_header X-Real-IP $remote_addr;`);
+          console.log(`      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;`);
+          console.log(`      proxy_set_header X-Forwarded-Proto $scheme;`);
           console.log(`  }`);
-          console.log(`  ────────────────────────────────────────────────────────────`);
-          console.log(`\n  To apply:`);
-          console.log(`    sudo nano /etc/nginx/sites-available/default`);
-          console.log(`    (add the location block inside your server {})`);
-          console.log(`    sudo nginx -t && sudo systemctl reload nginx`);
+          console.log(``);
+          console.log(`  To apply:`);
+          console.log(`    1. sudo nano /etc/nginx/sites-available/default`);
+          console.log(`    2. Add the config above inside your server { } block`);
+          console.log(`    3. sudo nginx -t`);
+          console.log(`    4. sudo systemctl reload nginx`);
         }
         
         if (hasCaddy) {
-          console.log(`\n  ── Caddy config ──`);
+          console.log(`\n  ┌─────────────────────────────────────────────────────────────────┐`);
+          console.log(`  │  Caddy config                                                   │`);
+          console.log(`  └─────────────────────────────────────────────────────────────────┘`);
+          console.log(``);
+          console.log(`  # A2A (Agent-to-Agent) Protocol Proxy`);
+          console.log(`  # Routes federation requests to local A2A server on port ${serverPort}`);
+          console.log(`  # Protocol: https://github.com/onthegonow/a2a_calling`);
           console.log(`  handle /api/a2a/* {`);
           console.log(`      reverse_proxy 127.0.0.1:${serverPort}`);
           console.log(`  }`);
-          console.log(`  ───────────────────`);
         }
         
         console.log(`\n  After reverse proxy is configured:`);

package/package.json

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

package/src/routes/dashboard.js

@@ -502,7 +502,7 @@ function createDashboardApiRouter(options = {}) {
       manifest_file: require('../lib/disclosure').MANIFEST_FILE,
       public_base_url: publicBaseUrl,
       public_dashboard_url: publicBaseUrl ? `${publicBaseUrl}/dashboard/` : null,
-      callbook_install_base: publicBaseUrl ? `${publicBaseUrl}/callbook/install` : null,
+      callbook_install_base: publicBaseUrl ? `${publicBaseUrl}/api/a2a/callbook/install` : null,
       invite_host: inviteResolution ? {
         host: inviteResolution.host,
         source: inviteResolution.source || null,
@@ -570,7 +570,7 @@ function createDashboardApiRouter(options = {}) {
     const schemeOverride = String(process.env.A2A_PUBLIC_SCHEME || '').trim();
     const scheme = schemeOverride || (isHttpsRequest(req) ? 'https' : 'http');
     const baseUrl = resolvedHost ? `${scheme}://${resolvedHost}` : null;
-    const installUrl = baseUrl ? `${baseUrl}/callbook/install#code=${created.code}` : null;
+    const installUrl = baseUrl ? `${baseUrl}/api/a2a/callbook/install#code=${created.code}` : null;
 
     return res.json({
       success: true,

package/src/server.js

@@ -717,18 +717,28 @@ const app = express();
 app.use(express.json());
 
 // Minimal owner dashboard (local by default unless A2A_ADMIN_TOKEN is provided)
+// All routes under /api/a2a/* so reverse proxy config stays simple.
 app.use('/api/a2a/dashboard', createDashboardApiRouter({
   tokenStore,
   agentContext,
   logger: logger.child({ component: 'a2a.dashboard' })
 }));
-app.use('/dashboard', createDashboardUiRouter({
+app.use('/api/a2a/dashboard', createDashboardUiRouter({
   tokenStore,
   agentContext,
   logger: logger.child({ component: 'a2a.dashboard' })
 }));
 
 // Callbook Remote pairing flow (public install page).
+// Mounted under /api/a2a/ for reverse proxy compatibility.
+app.use('/api/a2a/callbook', createCallbookRouter());
+
+// Legacy routes for backwards compatibility (direct access without reverse proxy)
+app.use('/dashboard', createDashboardUiRouter({
+  tokenStore,
+  agentContext,
+  logger: logger.child({ component: 'a2a.dashboard' })
+}));
 app.use('/callbook', createCallbookRouter());
 
 app.use('/api/a2a', createRoutes({