a2acalling 0.6.75 → 0.6.76

package/CONVENTIONS.md

@@ -159,6 +159,45 @@ For native macOS server process management in `native/macos/src-tauri/src/server
 - Emit status/log events to the frontend for observability; do not silently retry in background
 - During shutdown, set explicit shutdown state to prevent unintended auto-restart
 
+## Native Onboarding Wizard (A2A-99)
+
+The onboarding wizard at `/api/a2a/dashboard/onboarding` runs on fresh installs (no `a2a-config.json`). Key patterns:
+- Wizard routes (`/onboarding`, `/onboarding/status`, `/onboarding/complete`, `/onboarding/detect-port`) are placed BEFORE `ensureDashboardAccess` middleware — they must work without auth
+- Config/disclosure writes use existing `A2AConfig` and `disclosure.js` APIs — do not duplicate validation
+- `DiscoveryResult` in `discovery.rs` includes `onboarding_complete: bool` to let `native/macos/index.html` route to wizard vs dashboard
+- Topics selected in the wizard populate the `public` tier only — users refine per-tier topics in Settings
+
+## Native App Auto-Updater (A2A-100)
+
+The Tauri app uses `tauri-plugin-updater` to check for and install updates from GitHub Releases:
+- Update manifest (`latest.json`) is uploaded as a GitHub Release asset by CI
+- Background check runs 5 seconds after app launch, rate-limited to once per hour via `UpdateCheckState`
+- Manual check available from View → Check for Updates menu and Settings tab
+- Updates require user consent — banner shows in dashboard, user clicks "Update Now"
+- Signing key pair: private key in `TAURI_SIGNING_PRIVATE_KEY` GitHub secret, public key in `tauri.conf.json`
+- Do NOT auto-restart without user consent
+
+## DMG Installer Polish (A2A-101)
+
+The macOS DMG installer uses Tauri's built-in DMG bundler with custom configuration:
+- Background images: `dmg-background.png` (600x400) and `@2x` retina variant (1200x800) in `native/macos/src-tauri/`
+- DMG config in `tauri.conf.json` under `bundle.macOS.dmg`: window size, app/Applications positions
+- Icon set: all standard sizes (32, 128, 256, 512, 512@2x) in `native/macos/src-tauri/icons/`
+- Do NOT use third-party DMG tools — Tauri's bundler handles everything
+- Background design uses dashboard dark theme colors (#0B0E14, #151B28, #3B82F6)
+
+## Standalone App E2E Tests (A2A-103)
+
+End-to-end tests for the standalone app user journey live in `test/e2e/standalone-*.test.js`:
+- `standalone-onboarding` — first-run wizard flow via API
+- `standalone-workflows` — core dashboard operations after onboarding
+- `standalone-sidecar` — server lifecycle and crash recovery
+- `standalone-updater` — update manifest detection with mock server
+- Shared env: `test/e2e/helpers/standalone-env.js` creates isolated server instances with temp config
+- Run with `npm run test:e2e:standalone` or `node test/run.js --e2e --filter standalone`
+- All tests use `A2A_CONFIG_DIR` for isolation — no interference with real config
+- Tests must clean up spawned processes and temp files in afterEach
+
 ## Anti-Patterns
 
 - Do NOT use `console.log` outside the logger sink in `src/lib/logger.js`

package/docs/app.js

@@ -0,0 +1,30 @@
+// A2A-102: Landing page platform detection and dynamic download URL
+(function () {
+  'use strict';
+
+  var btn = document.getElementById('download-btn');
+  if (!btn) return;
+
+  // Only show "Download for macOS" on macOS
+  var isMac = /Mac|iPhone|iPad/.test(navigator.platform || '') ||
+    (navigator.userAgentData && navigator.userAgentData.platform === 'macOS');
+
+  if (!isMac) {
+    btn.textContent = 'View on GitHub';
+    btn.href = 'https://github.com/onthegonow/a2a_calling';
+    return;
+  }
+
+  // Try to get latest release URL from GitHub API
+  fetch('https://api.github.com/repos/onthegonow/a2a_calling/releases/latest')
+    .then(function (res) { return res.ok ? res.json() : null; })
+    .then(function (data) {
+      if (!data || !data.assets) return;
+      var dmg = data.assets.find(function (a) { return a.name.endsWith('.dmg'); });
+      if (dmg && dmg.browser_download_url) {
+        btn.href = dmg.browser_download_url;
+        btn.textContent = 'Download ' + data.tag_name + ' for macOS';
+      }
+    })
+    .catch(function () { /* keep default link */ });
+})();

package/docs/index.html

@@ -0,0 +1,117 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>A2A Callbook — Agent-to-Agent Communication</title>
+  <link rel="icon" href="assets/icon-32.png" type="image/png">
+  <link rel="stylesheet" href="style.css">
+</head>
+<body>
+  <nav class="nav">
+    <div class="nav-inner">
+      <a href="/" class="nav-brand">
+        <img src="assets/icon-64.png" alt="A2A" width="32" height="32">
+        <span>A2A Callbook</span>
+      </a>
+      <div class="nav-links">
+        <a href="#features">Features</a>
+        <a href="#get-started">Get Started</a>
+        <a href="https://github.com/onthegonow/a2a_calling" target="_blank" rel="noopener">GitHub</a>
+      </div>
+    </div>
+  </nav>
+
+  <section class="hero">
+    <h1>Agent-to-Agent<br>Communication</h1>
+    <p class="hero-sub">Give your AI agent a phone number. Create invite tokens, manage permissions, and let agents call each other — securely.</p>
+    <div class="hero-actions">
+      <a id="download-btn" href="https://github.com/onthegonow/a2a_calling/releases/latest" class="btn btn-primary">Download for macOS</a>
+      <code class="install-cmd">npm i -g a2acalling</code>
+    </div>
+  </section>
+
+  <section id="features" class="features">
+    <h2>What it does</h2>
+    <div class="feature-grid">
+      <div class="feature-card">
+        <span class="feature-icon">🔑</span>
+        <h3>Token-Based Access</h3>
+        <p>Create expiring invite tokens with scoped permissions. Share a URL, control who calls in.</p>
+      </div>
+      <div class="feature-card">
+        <span class="feature-icon">📞</span>
+        <h3>Multi-Turn Calls</h3>
+        <p>Agents have real conversations — not single-shot requests. Configurable turn limits and auto-summaries.</p>
+      </div>
+      <div class="feature-card">
+        <span class="feature-icon">🛡️</span>
+        <h3>Permission Tiers</h3>
+        <p>Public, Friends, Family — each tier unlocks different capabilities. You decide what each caller can access.</p>
+      </div>
+      <div class="feature-card">
+        <span class="feature-icon">🖥️</span>
+        <h3>Native Dashboard</h3>
+        <p>macOS app with live call monitoring, contact management, and system notifications.</p>
+      </div>
+    </div>
+  </section>
+
+  <section id="get-started" class="get-started">
+    <h2>Get started in 3 steps</h2>
+    <div class="steps">
+      <div class="step">
+        <div class="step-num">1</div>
+        <div>
+          <h3>Install</h3>
+          <code>npm i -g a2acalling</code>
+        </div>
+      </div>
+      <div class="step">
+        <div class="step-num">2</div>
+        <div>
+          <h3>Set up</h3>
+          <code>a2a quickstart</code>
+        </div>
+      </div>
+      <div class="step">
+        <div class="step-num">3</div>
+        <div>
+          <h3>Create an invite</h3>
+          <code>a2a create --name "MyAgent" --expires 7d</code>
+        </div>
+      </div>
+    </div>
+  </section>
+
+  <section class="cli-section">
+    <h2>Full CLI</h2>
+    <div class="cli-grid">
+      <div class="cli-group">
+        <h3>Tokens</h3>
+        <code>a2a create --name "Alice" --permissions friends</code>
+        <code>a2a list</code>
+        <code>a2a revoke &lt;id&gt;</code>
+      </div>
+      <div class="cli-group">
+        <h3>Calling</h3>
+        <code>a2a call Alice "Hello!"</code>
+        <code>a2a call --single Alice "Quick question"</code>
+        <code>a2a ping &lt;url&gt;</code>
+      </div>
+      <div class="cli-group">
+        <h3>Contacts</h3>
+        <code>a2a contacts</code>
+        <code>a2a contacts add &lt;url&gt; --name "Bob"</code>
+        <code>a2a contacts ping Bob</code>
+      </div>
+    </div>
+  </section>
+
+  <footer class="footer">
+    <p>A2A Callbook is open source. <a href="https://github.com/onthegonow/a2a_calling" target="_blank" rel="noopener">View on GitHub</a></p>
+  </footer>
+
+  <script src="app.js"></script>
+</body>
+</html>