a2acalling 0.6.49 → 0.6.51

package/bin/cli.js

@@ -11,6 +11,7 @@
  *   a2a call <url> <msg>     Call a contact (or invite URL)
  *   a2a ping <url>           Ping an invite URL
  *   a2a gui                  Open the local dashboard GUI in a browser
+ *   a2a app <action>         Manage native macOS app (status/install/uninstall)
  *   a2a setup                Auto setup (gateway-aware dashboard install)
  *   a2a uninstall            Stop server and remove local A2A config
  */
@@ -37,7 +38,9 @@ const ONBOARDING_EXEMPT = new Set([
   'dashboard',
   'server',
   'setup',
-  'install'
+  'app',
+  'install',
+  'skills'
 ]);
 
 function isOnboarded() {
@@ -167,6 +170,100 @@ function findNativeApp() {
   return null;
 }
 
+function getNativeAppPaths() {
+  return {
+    appDir: path.join(os.homedir(), 'Applications'),
+    appPath: path.join(os.homedir(), 'Applications', 'A2A Callbook.app')
+  };
+}
+
+function parseInstalledNativeAppVersion(appPath) {
+  if (!appPath) return null;
+  const plistPath = path.join(appPath, 'Contents', 'Info.plist');
+  if (!fs.existsSync(plistPath)) return null;
+  try {
+    const plist = fs.readFileSync(plistPath, 'utf8');
+    const m = plist.match(/<key>CFBundleShortVersionString<\/key>\s*<string>([^<]+)<\/string>/);
+    return m && m[1] ? m[1].trim() : null;
+  } catch (_) {
+    return null;
+  }
+}
+
+function installNativeMacApp(options = {}) {
+  if (os.platform() !== 'darwin') {
+    return { success: false, skipped: 'not_macos' };
+  }
+  const quiet = Boolean(options.quiet);
+  const force = Boolean(options.force);
+  const version = require('../package.json').version;
+  const { appDir, appPath } = getNativeAppPaths();
+  const installedVersion = parseInstalledNativeAppVersion(appPath);
+  if (!force && installedVersion === version) {
+    return { success: true, installed: false, version, appPath, reason: 'already_current' };
+  }
+
+  const tarUrl = `https://github.com/onthegonow/a2a_calling/releases/download/v${version}/A2A-Callbook-${version}.app.tar.gz`;
+  const tmpFile = path.join(os.tmpdir(), `a2a-callbook-${version}.app.tar.gz`);
+  const { execFileSync } = require('child_process');
+
+  try {
+    fs.mkdirSync(appDir, { recursive: true });
+    execFileSync('curl', ['-fL', '-o', tmpFile, tarUrl], { timeout: 120000, stdio: quiet ? 'ignore' : 'inherit' });
+    if (!fs.existsSync(tmpFile) || fs.statSync(tmpFile).size < 1000) {
+      return { success: false, error: 'download_failed' };
+    }
+    if (fs.existsSync(appPath)) {
+      fs.rmSync(appPath, { recursive: true, force: true });
+    }
+    execFileSync('tar', ['-xzf', tmpFile, '-C', appDir], { timeout: 60000, stdio: quiet ? 'ignore' : 'inherit' });
+    try { fs.unlinkSync(tmpFile); } catch (_) {}
+    return { success: true, installed: true, version, appPath };
+  } catch (err) {
+    try { fs.unlinkSync(tmpFile); } catch (_) {}
+    return { success: false, error: err.message || 'install_failed' };
+  }
+}
+
+function uninstallNativeMacApp() {
+  if (os.platform() !== 'darwin') {
+    return { success: false, skipped: 'not_macos' };
+  }
+  const candidates = [
+    path.join(os.homedir(), 'Applications', 'A2A Callbook.app'),
+    '/Applications/A2A Callbook.app'
+  ];
+  const existing = candidates.filter((candidate) => {
+    try {
+      return fs.existsSync(candidate);
+    } catch (_) {
+      return false;
+    }
+  });
+  if (existing.length === 0) {
+    return { success: true, removed: false, appPath: candidates[0] };
+  }
+
+  const removed = [];
+  const failed = [];
+  for (const appPath of existing) {
+    try {
+      fs.rmSync(appPath, { recursive: true, force: true });
+      removed.push(appPath);
+    } catch (err) {
+      failed.push({ appPath, error: err && err.message ? err.message : 'uninstall_failed' });
+    }
+  }
+  if (failed.length > 0) {
+    return {
+      success: false,
+      error: failed.map((f) => `${f.appPath}: ${f.error}`).join('; '),
+      appPath: removed[0] || existing[0]
+    };
+  }
+  return { success: true, removed: true, appPath: removed[0] || existing[0] };
+}
+
 async function findLocalServerPort(preferredPorts = []) {
   const http = require('http');
 
@@ -710,6 +807,8 @@ const commands = {
     
     // Get objectives from disclosure
     const objectives = tierTopics.objectives || [];
+    const timeoutMsRaw = args.flags['timeout-ms'] || args.flags.timeout_ms;
+    const timeoutMs = timeoutMsRaw ? Number.parseInt(String(timeoutMsRaw), 10) : null;
 
     const { token, record } = store.create({
       name: args.flags.name || args.flags.n || 'unnamed',
@@ -720,7 +819,8 @@ const commands = {
       notify: args.flags.notify || 'all',
       maxCalls,
       allowedTopics,
-      allowedGoals: objectives.map(o => o.objective || o)
+      allowedGoals: objectives.map(o => o.objective || o),
+      timeoutMs
     });
 
     const resolvedHost = await resolveInviteHostname();
@@ -759,6 +859,7 @@ const commands = {
     console.log(`Disclosure: ${record.disclosure}`);
     console.log(`Notify: ${record.notify}`);
     console.log(`Max calls: ${record.max_calls || 'unlimited'}`);
+    if (record.timeout_ms) console.log(`Turn timeout: ${record.timeout_ms}ms`);
     if (linkContact) console.log(`Linked to: ${linkContact}`);
     console.log(`\nTo revoke: a2a revoke ${record.id}`);
     console.log(`\n${'─'.repeat(50)}`);
@@ -1355,11 +1456,15 @@ a2a add "${inviteUrl}" "${ownerText || 'friend'}" && a2a call "${ownerText || 'f
 
       // Build owner context from config for summarizer
       let ownerContext = {};
+      let configTurnTimeoutMs = null;
       try {
         const { A2AConfig } = require('../src/lib/config');
         const config = new A2AConfig();
         const configAll = config.getAll();
         const tierGoals = configAll.tiers?.public?.goals || [];
+        configTurnTimeoutMs = configAll.defaults?.turnTimeoutMs
+          || configAll.defaults?.turn_timeout_ms
+          || null;
         ownerContext = {
           goals: tierGoals,
           agentName: agentContext.name,
@@ -1378,6 +1483,7 @@ a2a add "${inviteUrl}" "${ownerText || 'friend'}" && a2a call "${ownerText || 'f
         disclosure,
         minTurns,
         maxTurns,
+        configTurnTimeoutMs,
         ownerContext,
         onTurn: (info) => {
           const preview = info.messagePreview.length >= 80
@@ -2149,6 +2255,74 @@ a2a add "${inviteUrl}" "${ownerText || 'friend'}" && a2a call "${ownerText || 'f
     require('../scripts/install-openclaw.js');
   },
 
+  app: (args) => {
+    const action = String(args._[1] || 'status').trim().toLowerCase();
+    const force = Boolean(args.flags.force || args.flags.f);
+    const quiet = Boolean(args.flags.quiet || args.flags.q);
+    const pkgVersion = require('../package.json').version;
+
+    if (action === 'status') {
+      const installedAppPath = findNativeApp();
+      const preferredPath = getNativeAppPaths().appPath;
+      const version = installedAppPath ? parseInstalledNativeAppVersion(installedAppPath) : null;
+      console.log('A2A Native App Status\n');
+      console.log(`  Platform:      ${os.platform()}`);
+      console.log(`  CLI version:   ${pkgVersion}`);
+      if (os.platform() !== 'darwin') {
+        console.log('  Native app:    Not supported on this platform');
+        return;
+      }
+      console.log(`  Installed:     ${installedAppPath ? 'yes' : 'no'}`);
+      console.log(`  App path:      ${installedAppPath || preferredPath}`);
+      console.log(`  App version:   ${version || '(unknown)'}`);
+      if (!installedAppPath) {
+        console.log('\nInstall with: a2a app install');
+      }
+      return;
+    }
+
+    if (action === 'install') {
+      const result = installNativeMacApp({ force, quiet });
+      if (result.skipped === 'not_macos') {
+        console.error('Native app install is only available on macOS.');
+        process.exit(1);
+      }
+      if (!result.success) {
+        console.error(`Native app install failed: ${result.error || 'unknown error'}`);
+        process.exit(1);
+      }
+      if (result.reason === 'already_current') {
+        console.log(`Native app already installed at current version (${result.version}).`);
+        console.log(`Path: ${result.appPath}`);
+        return;
+      }
+      console.log(`Native app installed (v${result.version}).`);
+      console.log(`Path: ${result.appPath}`);
+      return;
+    }
+
+    if (action === 'uninstall') {
+      const result = uninstallNativeMacApp();
+      if (result.skipped === 'not_macos') {
+        console.error('Native app uninstall is only available on macOS.');
+        process.exit(1);
+      }
+      if (!result.success) {
+        console.error(`Native app uninstall failed: ${result.error || 'unknown error'}`);
+        process.exit(1);
+      }
+      if (!result.removed) {
+        console.log('Native app is not installed.');
+        return;
+      }
+      console.log(`Native app removed: ${result.appPath}`);
+      return;
+    }
+
+    console.error('Usage: a2a app <status|install|uninstall> [--force] [--quiet]');
+    process.exit(1);
+  },
+
   uninstall: async (args) => {
     const fs = require('fs');
     const path = require('path');
@@ -2625,6 +2799,46 @@ a2a add "${inviteUrl}" "${ownerText || 'friend'}" && a2a call "${ownerText || 'f
     return commands.quickstart(args);
   },
 
+  skills: (args) => {
+    const { installSkills, SKILL_FILES } = require('../scripts/install-skills');
+    const check = args.flags.check || args.flags.c;
+    const force = args.flags.force;
+    const targetDir = process.cwd();
+
+    if (check) {
+      console.log('A2A skills for this project:\n');
+      for (const file of SKILL_FILES) {
+        const destPath = path.join(targetDir, file.dest);
+        const exists = fs.existsSync(destPath);
+        const icon = exists ? '  \u2713' : '  \u2717';
+        console.log(`${icon} ${file.dest}${exists ? ' (installed)' : ' (not installed)'}`);
+      }
+      console.log(`\nRun "a2a skills" to install missing files.`);
+      return;
+    }
+
+    const result = installSkills(targetDir, { force });
+
+    if (result.installed.length) {
+      console.log(`\n  Installed ${result.installed.length} A2A skill file(s):\n`);
+      result.installed.forEach(f => console.log(`    + ${f}`));
+    }
+    if (result.skipped.length) {
+      console.log(`\n  Skipped ${result.skipped.length} unchanged file(s)`);
+    }
+    if (result.errors.length) {
+      console.error(`\n  Errors:`);
+      result.errors.forEach(e => console.error(`    ! ${e.file}: ${e.error}`));
+    }
+
+    if (result.installed.length === 0 && result.skipped.length > 0) {
+      console.log('\n  All skills already installed. Use --force to overwrite.\n');
+    } else if (result.installed.length > 0) {
+      console.log('\n  Skills ready. In Claude Code, type /a2a- to see available commands.');
+      console.log('  In Codex CLI, A2A instructions are in .codex/AGENTS.md\n');
+    }
+  },
+
   version: () => {
     const pkg = require('../package.json');
     console.log(pkg.version);
@@ -2645,6 +2859,7 @@ Commands:
     --disclosure, -d  Disclosure level (public, minimal, none)
     --notify          Owner notification (all, summary, none)
     --max-calls       Maximum invocations (default: 100)
+    --timeout-ms      Per-token Claude turn timeout in milliseconds
     --link, -l        Auto-link to contact name
 
   list                List active tokens
@@ -2686,6 +2901,12 @@ Calling:
   status <url>        Get A2A status
   gui                 Open the local dashboard GUI in a browser
     --tab, -t         Optional: contacts|calls|logs|settings|invites
+  app                 Manage native macOS app
+    status            Show native app installation status (default)
+    install           Install/update native app from GitHub release
+      --force, -f     Reinstall even when current version is present
+      --quiet, -q     Suppress download/extract output
+    uninstall         Remove native app from ~/Applications
 
 Server:
   server              Start the A2A server
@@ -2710,6 +2931,9 @@ Server:
   uninstall           Stop server and remove local config/DB
     --keep-config     Preserve config/DB (for reinstall)
     --force           Skip confirmation prompt
+  skills              Install Claude Code + Codex CLI skills
+    --check, -c       Show what would be installed
+    --force           Overwrite existing files
   version             Show installed package version
 
 Examples:
@@ -2719,6 +2943,8 @@ Examples:
   a2a contacts link Alice tok_abc123
   a2a call Alice "Hello!"
   a2a conversations show conv_abc123
+  a2a app status
+  a2a app install --force
   a2a server --port 3001
 `);
   }

package/docs/protocol.md

@@ -388,6 +388,48 @@ module.exports = function (test, assert, helpers) {
 };
 ```
 
+## CLI Skills (Claude Code & Codex)
+
+A2A ships with slash commands for Claude Code and agent instructions for Codex CLI.
+
+### Installation
+
+```bash
+a2a skills              # Install into current project
+a2a skills --check      # See what would be installed
+a2a skills --force      # Overwrite existing files
+```
+
+Skills are also installed automatically on `npm install -g a2acalling`.
+
+### Claude Code Commands
+
+| Command | Description |
+|---------|-------------|
+| `/a2a-call <contact> <msg>` | Call another agent (multi-turn) |
+| `/a2a-invite [name] [--tier]` | Create invite token |
+| `/a2a-contacts [add\|show\|ping\|rm]` | Manage contacts |
+| `/a2a-status` | Server and agent health dashboard |
+| `/a2a-setup` | First-time setup and onboarding |
+
+Files installed to: `.claude/commands/a2a-*.md`
+
+### Codex CLI
+
+A2A agent instructions are installed to `.codex/AGENTS.md`. Codex reads this file automatically to understand available A2A commands, permission tiers, and workflows.
+
+### Manual Installation
+
+If the automatic install didn't work, copy the files manually:
+
+```bash
+# Claude Code commands
+cp node_modules/a2acalling/.claude/commands/a2a-*.md .claude/commands/
+
+# Codex instructions
+cp node_modules/a2acalling/.codex/AGENTS.md .codex/AGENTS.md
+```
+
 ## Future Protocol Extensions (v1+)
 
 - **Capability advertisement**: Agents declare what they can help with

package/native/macos/index.html

@@ -71,7 +71,7 @@
         Server not running
       </p>
       <p class="port-info" id="last-port">No a2a server found on common ports</p>
-      <button id="btn-start">Start Server</button>
+      <button id="btn-start">How to start server</button>
       <button id="btn-retry" class="secondary">Retry</button>
       <p id="error-detail"></p>
     </div>
@@ -120,15 +120,10 @@
     }
 
     document.getElementById('btn-start')?.addEventListener('click', async () => {
-      try {
-        await invoke('start_server');
-        // Wait for server to boot, then retry
-        setTimeout(checkServer, 2000);
-      } catch (err) {
-        const detail = document.getElementById('error-detail');
-        detail.textContent = `Failed to start: ${err}`;
-        detail.style.display = 'block';
-      }
+      const detail = document.getElementById('error-detail');
+      // v1 design decision: app links/status only; no app-owned server lifecycle management yet.
+      detail.textContent = 'Run `a2a server` (or `a2a quickstart`) in Terminal, then click Retry.';
+      detail.style.display = 'block';
     });
 
     document.getElementById('btn-retry')?.addEventListener('click', checkServer);