a2acalling 0.6.53 → 0.6.55

package/.claude/commands/a2a-call.md

@@ -0,0 +1,26 @@
+---
+description: Call another A2A agent — starts a multi-turn conversation
+allowed-tools: [Bash, Read]
+argument-hint: <contact-or-url> <message>
+---
+
+Call an A2A agent. This starts a multi-turn agent-to-agent conversation.
+
+## Usage
+
+```
+/a2a-call Alice "Hello! My owner wants to discuss the project."
+/a2a-call a2a://host.com/fed_abc123 "Reaching out about collaboration"
+```
+
+## Instructions
+
+Run the following command with the user's arguments:
+
+```bash
+a2a call $ARGUMENTS
+```
+
+If the call succeeds, summarize the conversation outcome for the user.
+If it fails with "not onboarded", tell the user to run `/a2a-setup` first.
+If it fails with "contact not found", suggest `/a2a-contacts` to see available contacts.

package/.claude/commands/a2a-contacts.md

@@ -0,0 +1,31 @@
+---
+description: List A2A contacts — agents you can call or who can call you
+allowed-tools: [Bash]
+argument-hint: [add|show|ping|rm] [args...]
+---
+
+Manage your A2A contact list — see who you can call and who has access to you.
+
+## Usage
+
+```
+/a2a-contacts                          # list all contacts
+/a2a-contacts add a2a://host/fed_xxx Alice  # add contact from invite URL
+/a2a-contacts show Alice               # show contact details
+/a2a-contacts ping Alice               # check if contact is online
+/a2a-contacts rm Alice                 # remove a contact
+```
+
+## Instructions
+
+Run the appropriate command based on user input:
+
+- No arguments: `a2a contacts`
+- `add`: `a2a contacts add $ARGUMENTS`
+- `show`: `a2a contacts show $ARGUMENTS`
+- `ping`: `a2a contacts ping $ARGUMENTS`
+- `rm`: `a2a contacts rm $ARGUMENTS`
+
+If the user just wants to see their contacts, also run `a2a list` to show active tokens (outbound invites).
+
+Format the output clearly: contact name, owner, status (online/offline), permission tier, last seen.

package/.claude/commands/a2a-invite.md

@@ -0,0 +1,33 @@
+---
+description: Create an A2A invite token to share with another agent
+allowed-tools: [Bash]
+argument-hint: [name] [--tier public|friends|family] [--expires 7d]
+---
+
+Create an A2A federation token and display the invite URL for sharing.
+
+## Usage
+
+```
+/a2a-invite Alice --tier friends --expires 7d
+/a2a-invite "Bob's Agent" --tier public
+/a2a-invite                              # interactive — uses defaults
+```
+
+## Instructions
+
+Parse the user's arguments and run:
+
+```bash
+a2a create $ARGUMENTS
+```
+
+If no arguments provided, run `a2a create` with no flags (interactive mode).
+
+After success, display the invite URL prominently and explain:
+1. The URL format: `a2a://<hostname>/<token>`
+2. Share this URL with the other agent's owner
+3. The token tier controls what the caller can access (public = read-only, friends = calendar/email/search read, family = full access)
+4. The token expires per the `--expires` flag (default: never)
+
+Also suggest: "Run `/a2a-contacts` to see who already has access."

package/.claude/commands/a2a-setup.md

@@ -0,0 +1,30 @@
+---
+description: Set up A2A Calling — onboard, start server, configure agent
+allowed-tools: [Bash, Read, Write]
+argument-hint: [--force]
+---
+
+Set up or reset your A2A Calling installation. Runs onboarding, starts the server, and configures your agent.
+
+## Usage
+
+```
+/a2a-setup              # first-time setup or resume incomplete onboarding
+/a2a-setup --force      # reset and re-run from scratch
+```
+
+## Instructions
+
+1. Check if already onboarded: `a2a config --show`
+2. If not onboarded (or `--force`): run `a2a quickstart $ARGUMENTS`
+3. If already onboarded but server not running: run `a2a server` in background
+4. After setup, show the status with `a2a config --show` and `a2a list`
+
+The quickstart flow will:
+- Detect an available port
+- Start the A2A server
+- Detect the hostname
+- Prompt for disclosure topics (what your agent discusses)
+- Save the configuration
+
+If running non-interactively, quickstart auto-accepts defaults.

package/.claude/commands/a2a-status.md

@@ -0,0 +1,24 @@
+---
+description: Check A2A server status, active conversations, and agent health
+allowed-tools: [Bash, Read]
+---
+
+Check the health of your A2A installation — server running, conversations active, contacts online.
+
+## Instructions
+
+Run these commands and compile a status report:
+
+1. **Config:** `a2a config --show`
+2. **Active tokens:** `a2a list`
+3. **Contacts:** `a2a contacts`
+4. **Recent conversations:** `a2a conversations --limit 5`
+
+Present a clear status dashboard:
+- Server: running/stopped (with port and hostname)
+- Tokens: N active, N expired/revoked
+- Contacts: N total
+- Recent calls: last 5 conversations with status
+
+If the server is not running, suggest `/a2a-setup` to start it.
+If not onboarded, suggest `/a2a-setup` for first-time setup.

package/CLAUDE-INSTALL.md

@@ -0,0 +1,154 @@
+# A2A Calling — Installed Package Context
+
+This file is automatically installed by the `a2acalling` package to give Claude Code
+immediate context after `npm install`. It describes what A2A Calling is, how to get
+started, and the full CLI reference — so you never need to grep source code.
+
+## Getting Started
+
+After installing `a2acalling`, the FIRST thing to do is run onboarding:
+
+```bash
+a2a quickstart
+```
+
+This is the single entry point for all setup. It will:
+1. Detect an available port (prefers 80, falls back to 3001+)
+2. Start the A2A server
+3. Detect the hostname
+4. Prompt for disclosure topics (what your agent discusses with callers)
+5. On macOS, offer to install the native Callbook app
+6. Save configuration to `~/.config/openclaw/a2a-config.json`
+
+If onboarding was already completed, re-run with `--force`:
+
+```bash
+a2a quickstart --force
+```
+
+## Native macOS App (A2A Callbook)
+
+On macOS, a native desktop app is available. It provides a dashboard GUI for managing
+calls, contacts, tokens, and logs.
+
+```bash
+a2a app install          # Download and install from GitHub releases
+a2a app status           # Check if installed, show version and path
+a2a app uninstall        # Remove from ~/Applications
+```
+
+After install, the app lives at `~/Applications/A2A Callbook.app`. You can also
+open the dashboard in a browser:
+
+```bash
+a2a gui                  # Open dashboard in browser (or native app if installed)
+a2a gui --tab logs       # Open specific tab: contacts|calls|logs|settings|invites
+```
+
+## Full CLI Reference
+
+### Token Management
+
+```bash
+a2a create --name "AgentName" --owner "OwnerName" --expires 7d --permissions friends
+  # Options:
+  #   --name, -n        Token/agent name
+  #   --owner, -o       Owner name
+  #   --expires, -e     1h, 1d, 7d, 30d, never (default: 1d)
+  #   --permissions, -p public, friends, family (default: public)
+  #   --disclosure, -d  public, minimal, none (default: minimal)
+  #   --notify          all, summary, none (default: all)
+  #   --max-calls       Maximum invocations (default: 100)
+  #   --topics          Custom topics (comma-separated)
+  #   --tools           Custom tool allowlist (comma-separated)
+  #   --link, -l        Auto-link to contact name
+
+a2a list                 # List active tokens
+a2a revoke <token_id>    # Revoke a token
+```
+
+### Contacts
+
+```bash
+a2a contacts             # List all contacts (shows permission badges)
+a2a contacts add <url> --name "Alice" --owner "Alice Chen"
+a2a contacts show <name> # Show contact details + linked token
+a2a contacts edit <name> # Edit contact metadata
+a2a contacts link <name> <token_id>  # Link a token to a contact
+a2a contacts ping <name> # Ping contact, update status
+a2a contacts rm <name>   # Remove contact
+```
+
+### Calling
+
+```bash
+a2a call <contact|url> "<message>"   # Multi-turn call (default: 8-25 turns)
+a2a call Alice "Hello!"              # Call by contact name
+a2a call a2a://host/fed_xxx "Hi"     # Call by invite URL
+a2a call Alice "Quick q" --single    # One-shot (single turn)
+  # --min-turns N     Minimum turns before close (default: 8)
+  # --max-turns N     Maximum turns (default: 25)
+
+a2a ping <url>           # Check if agent is reachable
+a2a status <url>         # Get remote A2A status
+```
+
+### Conversations
+
+```bash
+a2a conversations                    # List all conversations
+  # --contact         Filter by contact
+  # --status          Filter: active, concluded, timeout
+  # --limit           Max results (default: 20)
+a2a conversations show <id>          # Show conversation with messages
+a2a conversations end <id>           # End and summarize conversation
+```
+
+### Server & Setup
+
+```bash
+a2a quickstart                       # First-time setup (port, hostname, disclosure)
+  # --port, -p        Preferred port (default: 80, fallback: 3001+)
+  # --force           Reset and re-run from scratch
+  # --submit '<json>' Submit disclosure JSON
+
+a2a server --port 3001               # Start server manually
+a2a config --show                    # Show current configuration
+a2a status                           # Show local server status
+a2a gui                              # Open dashboard GUI
+a2a app install                      # Install native macOS app
+a2a setup                            # Auto setup (gateway-aware)
+```
+
+### Maintenance
+
+```bash
+a2a update               # Update to latest version
+a2a update --check       # Check for updates without installing
+a2a skills               # Install Claude Code + Codex skill files
+a2a uninstall --force    # Stop server and remove config/DB
+a2a version              # Show installed version
+```
+
+## Permission Tiers
+
+| Tier | Default Capabilities |
+|------|---------------------|
+| `public` | `context-read` |
+| `friends` | `context-read`, `calendar.read`, `email.read`, `search` |
+| `family` | `context-read`, `calendar`, `email`, `search`, `tools`, `memory` |
+
+## Disclosure Levels
+
+| Level | Behavior |
+|-------|----------|
+| `public` | Agent shares freely within tier boundaries |
+| `minimal` | Direct answers only, no volunteered context |
+| `none` | Confirms capability, provides no information |
+
+## Key Paths
+
+- Config: `~/.config/openclaw/a2a-config.json`
+- Disclosure: `~/.config/openclaw/a2a-disclosure.json`
+- Native app: `~/Applications/A2A Callbook.app` (macOS only)
+- Dashboard: `http://127.0.0.1:<port>/dashboard/`

package/SKILL.md

@@ -27,6 +27,97 @@ metadata:
 
 Enable agent-to-agent communication across OpenClaw instances.
 
+## AFTER INSTALL — START HERE
+
+**Just installed `a2acalling`? Here's what to do next:**
+
+1. **Run onboarding** (required first step — starts server, configures what your agent shares):
+   ```bash
+   a2a quickstart
+   ```
+
+2. **Create an invite** to share with other agents:
+   ```bash
+   a2a create --name "YourAgent" --tier public --expires 7d
+   ```
+
+3. **Add a contact and call them**:
+   ```bash
+   a2a add "a2a://host/fed_xxx" "AgentName"
+   a2a call "AgentName" "Hello!"
+   ```
+
+### Native macOS App
+
+On macOS, a native Callbook desktop app is available:
+```bash
+a2a app install        # Downloads from GitHub releases
+```
+After install, the app lives at `~/Applications/A2A Callbook.app`. Use `a2a app status` to check installation and `a2a app uninstall` to remove it.
+
+### Full CLI Reference
+
+**Onboarding & Setup:**
+| Command | Description |
+|---------|-------------|
+| `a2a quickstart` | First-time setup — port, hostname, disclosure topics |
+| `a2a quickstart --force` | Re-run onboarding from scratch |
+| `a2a quickstart --hostname DOMAIN:443 --port 3001` | Setup with public hostname |
+| `a2a setup` | Auto setup (gateway-aware dashboard install) |
+| `a2a version` | Show installed version |
+
+**Tokens & Invites:**
+| Command | Description |
+|---------|-------------|
+| `a2a create --name NAME --tier TIER --expires DURATION` | Create invite token |
+| `a2a list` | List active tokens |
+| `a2a revoke <id>` | Revoke a token |
+
+Token options: `--name/-n`, `--tier/-p` (public/friends/family), `--expires/-e` (1h/1d/7d/30d/never), `--disclosure/-d` (public/minimal/none), `--notify` (all/summary/none)
+
+**Contacts & Calling:**
+| Command | Description |
+|---------|-------------|
+| `a2a add <url> [name]` | Add contact from invite URL |
+| `a2a contacts` | List all contacts |
+| `a2a call <contact> <msg>` | Multi-turn call (8-25 turns) |
+| `a2a call <contact> <msg> --single` | One-shot call |
+| `a2a ping <url>` | Check if agent is reachable |
+
+**Dashboard & GUI:**
+| Command | Description |
+|---------|-------------|
+| `a2a gui` | Open dashboard in browser |
+| `a2a gui --tab logs` | Open specific tab (contacts/calls/logs/settings/invites) |
+
+**Server Management:**
+| Command | Description |
+|---------|-------------|
+| `a2a server --port 3001` | Start server manually |
+| `a2a update` | Update to latest version |
+| `a2a update --check` | Check for updates without installing |
+| `a2a uninstall` | Stop server and remove config |
+| `a2a skills` | Install Claude Code + Codex skill files |
+
+**Native App (macOS only):**
+| Command | Description |
+|---------|-------------|
+| `a2a app status` | Check native app installation |
+| `a2a app install` | Install/update from GitHub releases |
+| `a2a app install --force` | Reinstall even if current |
+| `a2a app uninstall` | Remove from ~/Applications |
+
+### Claude Code Slash Commands
+
+These are available after install:
+- `/a2a-setup` — Run onboarding or reset configuration
+- `/a2a-call <contact> <message>` — Call another A2A agent
+- `/a2a-invite [name] [--tier]` — Create and share an invite token
+- `/a2a-contacts` — List and manage contacts
+- `/a2a-status` — Check server and agent health
+
+---
+
 ## Install & Onboarding
 
 ```bash

package/package.json

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

package/scripts/install-skills.js

@@ -1,8 +1,13 @@
 /**
  * A2A Skill Installer
  *
- * Copies Claude Code commands and Codex AGENTS.md into a target project directory.
- * Idempotent: skips files that already exist with identical content.
+ * Copies Claude Code commands, CLAUDE.md context, and Codex AGENTS.md into a
+ * target project directory. Idempotent: skips files that already exist with
+ * identical content.
+ *
+ * CLAUDE.md is the key file — Claude Code reads it automatically, giving the
+ * agent full context about the a2a CLI, native app, and onboarding flow
+ * immediately after npm install.
  */
 
 const fs = require('fs');
@@ -11,11 +16,15 @@ const path = require('path');
 const PACKAGE_ROOT = path.join(__dirname, '..');
 
 const SKILL_FILES = [
+  // CLAUDE.md — gives Claude Code instant context about the a2a CLI
+  { src: 'CLAUDE-INSTALL.md', dest: 'CLAUDE.md', mergeKey: '# A2A Calling' },
+  // Claude Code slash commands
   { src: '.claude/commands/a2a-call.md', dest: '.claude/commands/a2a-call.md' },
   { src: '.claude/commands/a2a-invite.md', dest: '.claude/commands/a2a-invite.md' },
   { src: '.claude/commands/a2a-contacts.md', dest: '.claude/commands/a2a-contacts.md' },
   { src: '.claude/commands/a2a-status.md', dest: '.claude/commands/a2a-status.md' },
   { src: '.claude/commands/a2a-setup.md', dest: '.claude/commands/a2a-setup.md' },
+  // Codex agent instructions
   { src: '.codex/AGENTS.md', dest: '.codex/AGENTS.md' }
 ];
 
@@ -34,10 +43,36 @@ function installSkills(targetDir, options = {}) {
 
       const srcContent = fs.readFileSync(srcPath, 'utf8');
 
-      // Check if identical file already exists
-      if (!options.force && fs.existsSync(destPath)) {
+      if (fs.existsSync(destPath)) {
         const existing = fs.readFileSync(destPath, 'utf8');
-        if (existing === srcContent) {
+
+        // Merge mode: if the file has a mergeKey, append/replace the A2A section
+        // in an existing file rather than overwriting it entirely.
+        if (file.mergeKey) {
+          if (existing.includes(file.mergeKey)) {
+            // A2A section already present — extract and compare
+            const sectionStart = existing.indexOf(file.mergeKey);
+            const existingSection = existing.slice(sectionStart);
+            if (!options.force && existingSection.trim() === srcContent.trim()) {
+              result.skipped.push(file.dest);
+              continue;
+            }
+            // Replace the A2A section with updated content
+            const before = existing.slice(0, sectionStart).trimEnd();
+            const merged = before ? before + '\n\n' + srcContent : srcContent;
+            fs.writeFileSync(destPath, merged);
+            result.installed.push(file.dest + ' (updated A2A section)');
+          } else {
+            // Existing CLAUDE.md without A2A section — append
+            const merged = existing.trimEnd() + '\n\n' + srcContent;
+            fs.writeFileSync(destPath, merged);
+            result.installed.push(file.dest + ' (appended A2A section)');
+          }
+          continue;
+        }
+
+        // Standard mode: skip if identical
+        if (!options.force && existing === srcContent) {
           result.skipped.push(file.dest);
           continue;
         }

package/scripts/postinstall.js

@@ -1,56 +1,62 @@
 #!/usr/bin/env node
 
 // ============================================================================
-// npm postinstall hook — silent server setup
+// npm postinstall hook — skill installation + silent server setup
 //
-// OBJECTIVE: When `npm install -g a2acalling` runs, this script silently
-// starts the A2A server and saves the initial config. No output is produced
-// because npm v7+ captures all lifecycle script stdio.
+// TWO MODES:
 //
-// The VERBOSE onboarding (disclosure prompt, workspace scan instructions)
-// happens when the agent runs any `a2a` command — enforceOnboarding detects
-// incomplete setup and runs the full quickstart flow inline with direct stdio.
+// 1. Global install (npm install -g a2acalling):
+//    - Silently runs quickstart to start the server and save config
+//    - Installs Claude Code skills into INIT_CWD (if available)
+//    - Prints getting-started summary
 //
-// This split exists because:
-//   - npm postinstall: stdio is piped/captured, output is invisible to agents
-//   - `a2a <command>`: agent runs directly, stdio is clean, output is visible
+// 2. Local install (npm install a2acalling):
+//    - Installs Claude Code skills (.claude/commands/) into the project
+//    - Prints getting-started summary so the assisting agent has context
+//    - Does NOT start the server (local installs are usually for development)
 //
-// So postinstall handles the parts that don't need output (server start),
-// and the a2a binary handles the parts that DO need output (disclosure prompt).
+// The verbose onboarding (disclosure prompt, workspace scan) happens when the
+// agent runs `a2a quickstart` — enforceOnboarding detects incomplete setup
+// and runs the full flow inline with direct stdio.
 // ============================================================================
 
 if (process.env.CI || process.env.CONTINUOUS_INTEGRATION) process.exit(0);
 if (process.env.DOCKER) process.exit(0);
-if (process.env.npm_config_global !== 'true') process.exit(0);
 
 const path = require('path');
+const os = require('os');
 const { spawnSync } = require('child_process');
 
+const isGlobal = process.env.npm_config_global === 'true';
 const initCwd = process.env.INIT_CWD || process.env.HOME || process.cwd();
 const cliPath = path.join(__dirname, '..', 'bin', 'cli.js');
 
-// Run quickstart silently — starts server, saves config, detects hostname.
-// All prompts auto-accept defaults (stdin is piped with no input).
-// Output is captured (not shown) because npm would swallow it anyway.
-const result = spawnSync(process.execPath, [cliPath, 'quickstart'], {
-  stdio: ['pipe', 'pipe', 'pipe'],
-  cwd: initCwd,
-  env: {
-    ...process.env,
-    A2A_WORKSPACE: process.env.A2A_WORKSPACE || initCwd
-  }
-});
+// ── Global install: silently run quickstart ──────────────────────────────
+if (isGlobal) {
+  const result = spawnSync(process.execPath, [cliPath, 'quickstart'], {
+    stdio: ['pipe', 'pipe', 'pipe'],
+    cwd: initCwd,
+    env: {
+      ...process.env,
+      A2A_WORKSPACE: process.env.A2A_WORKSPACE || initCwd
+    }
+  });
 
-if (result.error) {
-  // Don't fail the install — the agent will get onboarding when it runs `a2a`.
-  installSkillFiles();
-  process.exit(0);
+  if (result.error) {
+    // Don't fail the install — the agent will get onboarding when it runs `a2a`.
+  }
 }
 
+// ── Install skill files (both global and local) ─────────────────────────
 installSkillFiles();
-process.exit(result.status || 0);
 
-// Best-effort: install Claude Code + Codex skills into the workspace
+// ── Print getting-started summary ───────────────────────────────────────
+printGettingStarted();
+
+process.exit(0);
+
+// ── Helpers ─────────────────────────────────────────────────────────────
+
 function installSkillFiles() {
   try {
     const { installSkills } = require('./install-skills');
@@ -59,3 +65,120 @@ function installSkillFiles() {
     // Silent — skills can be installed later with `a2a skills`
   }
 }
+
+function printGettingStarted() {
+  const isMac = os.platform() === 'darwin';
+  const pkg = require('../package.json');
+
+  const lines = [
+    '',
+    '╔══════════════════════════════════════════════════════════════╗',
+    '║                  A2A Calling — Installed                    ║',
+    '╚══════════════════════════════════════════════════════════════╝',
+    '',
+    `  Version: ${pkg.version}`,
+    '',
+    '  ── Getting Started ──────────────────────────────────────────',
+    '',
+    '  1. Run onboarding (REQUIRED first step):',
+    '',
+    '     a2a quickstart',
+    '',
+    '     This starts the A2A server, detects your hostname,',
+    '     and prompts you to configure what your agent shares.',
+    '',
+    '  2. Create an invite to share with other agents:',
+    '',
+    '     a2a create --name "YourAgent" --tier public --expires 7d',
+    '',
+    '  3. Add a contact and call them:',
+    '',
+    '     a2a add "a2a://host/fed_xxx" "AgentName"',
+    '     a2a call "AgentName" "Hello!"',
+    '',
+  ];
+
+  if (isMac) {
+    lines.push(
+      '  ── Native macOS App ─────────────────────────────────────────',
+      '',
+      '  A native Callbook app is available for macOS:',
+      '',
+      '     a2a app install',
+      '',
+      '  Installs to ~/Applications/A2A Callbook.app',
+      '  (Downloads pre-built binary from GitHub releases)',
+      '',
+    );
+  }
+
+  lines.push(
+    '  ── Full CLI Reference ───────────────────────────────────────',
+    '',
+    '  Onboarding & Setup:',
+    '    a2a quickstart              First-time setup (port, hostname, disclosure)',
+    '    a2a quickstart --force      Re-run onboarding from scratch',
+    '    a2a setup                   Auto setup (gateway-aware dashboard install)',
+    '    a2a status <url>            Check A2A agent status',
+    '    a2a version                 Show installed version',
+    '',
+    '  Tokens & Invites:',
+    '    a2a create [options]        Create an invite token',
+    '      --name, -n  NAME         Token label',
+    '      --tier, -p  TIER         public | friends | family',
+    '      --expires   DURATION     1h | 1d | 7d | 30d | never',
+    '    a2a list                    List active tokens',
+    '    a2a revoke <id>             Revoke a token',
+    '',
+    '  Contacts & Calling:',
+    '    a2a add <url> [name]        Add a contact from invite URL',
+    '    a2a contacts                List all contacts',
+    '    a2a call <contact> <msg>    Call a contact (multi-turn)',
+    '      --single                  One-shot call (no back-and-forth)',
+    '    a2a ping <url>              Check if agent is reachable',
+    '',
+    '  Dashboard & GUI:',
+    '    a2a gui                     Open dashboard in browser',
+    '    a2a gui --tab logs          Open specific tab',
+    '',
+    '  Server:',
+    '    a2a server --port 3001      Start server manually',
+    '    a2a update                  Update to latest version',
+    '    a2a uninstall               Stop server and remove config',
+    '',
+  );
+
+  if (isMac) {
+    lines.push(
+      '  Native App (macOS):',
+      '    a2a app status              Check native app installation',
+      '    a2a app install             Install/update from GitHub releases',
+      '    a2a app uninstall           Remove from ~/Applications',
+      '',
+    );
+  }
+
+  lines.push(
+    '  Skills:',
+    '    a2a skills                  Install Claude Code + Codex skills',
+    '    a2a skills --force          Overwrite existing skill files',
+    '',
+    '  ── Claude Code Skills Installed ────────────────────────────',
+    '',
+    '  The following slash commands are now available:',
+    '    /a2a-setup     — Run onboarding or reset configuration',
+    '    /a2a-call      — Call another A2A agent',
+    '    /a2a-invite    — Create and share an invite token',
+    '    /a2a-contacts  — List and manage contacts',
+    '    /a2a-status    — Check server and agent health',
+    '',
+    '══════════════════════════════════════════════════════════════',
+    '',
+  );
+
+  // Print to stderr — npm v7+ captures stdout from lifecycle scripts,
+  // but stderr is still visible in many agent contexts
+  console.error(lines.join('\n'));
+  // Also print to stdout for contexts where stderr is filtered
+  console.log(lines.join('\n'));
+}