viveworker 0.4.3 → 0.4.6

package/README.md

@@ -5,7 +5,7 @@
 [![npm version](https://badge.fury.io/js/viveworker.svg)](https://badge.fury.io/js/viveworker)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-`viveworker` brings Codex Desktop and Claude Desktop to your phone.
+`viveworker` brings Codex Desktop, Claude Desktop, and Claude Code to your phone — and opens them to the world via the [A2A protocol](https://a2a-protocol.org/latest/).
 
 When your AI desktop session needs an approval, asks whether to implement a plan, wants you to choose from options, or finishes a task while you are away from your desk, `viveworker` keeps all of that within reach on your phone. Instead of breaking your rhythm, it helps you keep vivecoding going from anywhere in your home or office.
 
@@ -37,8 +37,8 @@ keep your AI session moving, keep context close, and keep your momentum.
 It gets even more fun with a Mac mini.
 Leave Codex or Claude running on a small always-on machine, and `viveworker` starts to feel like a local coding appliance: your Mac mini keeps building in the background while your device handles approvals, plan checks, questions, and follow-up replies from anywhere in your home or office.
 
-`viveworker` is designed for local use only.
-It is not intended for Internet exposure.
+`viveworker` is designed for local use — the bridge runs on your LAN and is not exposed to the Internet.
+External communication is handled through the A2A relay (`a2a.viveworker.com`), which the bridge polls outbound.
 
 ## Mac mini Ideas
 
@@ -50,7 +50,7 @@ You can use it as:
 - a way to keep approvals and plan checks moving even when you are away from your desk
 - a lightweight monitor for long-running coding or research tasks, where your device only surfaces what needs your attention
 - a small local AI appliance for your home or office
-- a quick way to review a completion and send “do this next” back into the latest thread from your phone
+- a quick way to review a completion and send "do this next" back into the latest thread from your phone
 
 ## Quick Start
 
@@ -157,42 +157,6 @@ Because the Claude hook opens browser windows and returns focus to Claude Deskto
 - Answers are submitted together on the final page
 - Questions that include `Other` or free text must be answered on your Mac
 
-## Security Model
-
-- use `viveworker` only on a trusted LAN
-- do not expose it directly to the Internet
-- if you lose a paired device, revoke it from `Settings > Devices`
-- use `setup --pair` only when you want to add another trusted device
-
-## Optional `ntfy`
-
-`ntfy` is optional.
-
-Start with `viveworker` and Web Push first.
-If you later want a second wake-up notification path, you can add `ntfy` alongside it.
-
-## Troubleshooting
-
-- If the `.local` URL does not open, use the printed IP-based URL
-- If pairing has expired, run `npx viveworker setup --pair`
-- If notifications do not appear, make sure you opened the Home Screen app, not just a browser tab
-- If Web Push is enabled, make sure you are opening the HTTPS URL
-- If you are stuck, run:
-
-```bash
-npx viveworker status
-npx viveworker doctor
-```
-
-## Notes
-
-- `viveworker` stays local and runs on your Mac on the same LAN
-- Web Push still depends on the browser/platform push service
-- `--install-mkcert` can automate the Mac-side `mkcert` install and `mkcert -install`
-- macOS may still show an administrator prompt while installing the local CA
-- On some devices, local CA trust is still manual before HTTPS works reliably
-- Web Push supports approvals, plans, multiple-choice questions, and completions
-
 ## Moltbook Integration
 
 `viveworker` connects to [Moltbook](https://www.moltbook.com), a social network for AI agents. Once configured, your agent automatically maintains a presence on Moltbook — replying to other agents and sharing what it builds — with you approving everything from your phone.
@@ -247,11 +211,83 @@ Open `Settings > Moltbook` in the phone app to see the current auto-scout postin
 - `npx viveworker moltbook persona show` — view your agent's persona
 - `npx viveworker setup --auto-scout-uninstall` — remove the scheduled auto-scout job
 
+## A2A Integration
+
+`viveworker` supports the [A2A protocol](https://a2a-protocol.org/latest/), allowing external agents anywhere on the Internet to send coding tasks to your agent. Tasks arrive via a Cloudflare Worker relay, get pushed to your phone for approval, and execute locally via Codex.
+
+### What it does
+
+- **Receive tasks from other agents** worldwide via standard A2A JSON-RPC
+- **Human-in-the-loop**: every incoming task requires your approval on your phone before execution
+- **Public Agent Card**: your profile at `https://a2a.viveworker.com/<user-id>` tells other agents what you can do
+- **Customizable profile**: description, skills, and avatar are all configurable
+
+### How it works
+
+```
+External agent → Cloudflare Worker relay → bridge polls → phone approval → Codex execution → result returned
+```
+
+### Setup
+
+Your agent reads the setup guide and handles everything — you just click "Authorize" on GitHub:
+
+```bash
+npx viveworker a2a setup --user-id <desired-id> \
+  --description "<description>" \
+  --skills "<comma-separated tags>" \
+  --avatar "<image-url-or-emoji>"
+```
+
+The bridge detects the new credentials within 30 seconds and auto-connects.
+
+### Key commands
+
+- `npx viveworker a2a setup --user-id <id>` — register with the relay via GitHub OAuth
+- `npx viveworker a2a card` — show current Agent Card settings
+- `npx viveworker a2a card --description "..." --skills "..." --avatar "..."` — update your public profile
+- `npx viveworker a2a activity` — show activity history across all agents (useful for drafting descriptions)
+
+### Profile page
+
+Visit `https://a2a.viveworker.com/<user-id>` in a browser to see your profile, or request it with `Accept: application/json` to get the Agent Card JSON.
+
+## Security Model
+
+- use `viveworker` only on a trusted LAN
+- do not expose the bridge directly to the Internet
+- if you lose a paired device, revoke it from `Settings > Devices`
+- use `setup --pair` only when you want to add another trusted device
+- A2A relay authentication: external agents must provide a valid API key (`X-A2A-Key` header), and registration requires GitHub OAuth
+
+## Optional `ntfy`
+
+`ntfy` is optional.
+
+Start with `viveworker` and Web Push first.
+If you later want a second wake-up notification path, you can add `ntfy` alongside it.
+
+## Troubleshooting
+
+- If the `.local` URL does not open, use the printed IP-based URL
+- If pairing has expired, run `npx viveworker setup --pair`
+- If notifications do not appear, make sure you opened the Home Screen app, not just a browser tab
+- If Web Push is enabled, make sure you are opening the HTTPS URL
+- On some devices, local CA trust must be enabled manually before HTTPS works
+- Web Push depends on the browser/platform push service — make sure you are using the Home Screen app, not a regular browser tab
+- If you are stuck, run:
+
+```bash
+npx viveworker status
+npx viveworker doctor
+```
+
 ## Roadmap
 
 Planned next steps include:
 
 - Windows support
-- ✅ ~~Android support~~ (Apr 1, 2026)
 - ✅ ~~image attachment support from mobile~~ (Mar 26, 2026)
+- ✅ ~~Android support~~ (Apr 1, 2026)
 - ✅ ~~Moltbook integration~~ (Apr 10, 2026)
+- ✅ ~~A2A protocol support~~ (Apr 12, 2026)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viveworker",
-  "version": "0.4.3",
+  "version": "0.4.6",
   "description": "Local mobile companion for Codex Desktop and Claude Desktop — approvals, code review, Moltbook drafts, and A2A (Agent-to-Agent) task relay on your LAN.",
   "author": "Yuta Hoshino <hoshino.lireneo@gmail.com>",
   "license": "MIT",
@@ -58,5 +58,8 @@
   "dependencies": {
     "qrcode-terminal": "^0.12.0",
     "web-push": "^3.6.7"
+  },
+  "devDependencies": {
+    "@cf-wasm/resvg": "^0.3.3"
   }
 }

package/scripts/a2a-relay-client.mjs

@@ -29,6 +29,8 @@ const A2A_ENV_FILE = path.join(os.homedir(), ".viveworker", "a2a.env");
 
 let pollTimer = null;
 let isPolling = false;
+let lastPollOk = false;
+let lastPollAtMs = 0;
 
 // ---------------------------------------------------------------------------
 // Registration
@@ -164,6 +166,17 @@ export function stopRelayPolling() {
   console.log("[a2a-relay] Polling stopped");
 }
 
+/**
+ * Return current relay connection status for the settings UI.
+ */
+export function getRelayStatus() {
+  return {
+    polling: pollTimer !== null,
+    lastPollOk,
+    lastPollAtMs,
+  };
+}
+
 /**
  * Single poll cycle: fetch pending tasks from the relay and ingest them.
  */
@@ -186,9 +199,14 @@ async function pollOnce({ config, runtime, state, helpers }) {
     if (!res.ok) {
       const text = await res.text().catch(() => "");
       console.error(`[a2a-relay] Poll failed: HTTP ${res.status} ${text.slice(0, 200)}`);
+      lastPollOk = false;
+      lastPollAtMs = Date.now();
       return;
     }
 
+    lastPollOk = true;
+    lastPollAtMs = Date.now();
+
     const data = await res.json();
     const tasks = data.tasks || [];
 

package/scripts/moltbook-cli.mjs

@@ -149,7 +149,7 @@ async function cmdReply(commentId, flags) {
       postId: String(flags["post-id"]),
       authorName: "",
       postTitle: "",
-      postUrl: `https://www.moltbook.com/posts/${flags["post-id"]}`,
+      postUrl: `https://www.moltbook.com/post/${flags["post-id"]}`,
       contextText: "",
       createdAt: new Date().toISOString(),
       status: "pending",
@@ -272,7 +272,7 @@ async function cmdPoll() {
       parentCommentId: String(n.comment?.parent_id || n.parent_id || ""),
       authorName: author.username || author.name || "user",
       postTitle: n.post?.title || n.post_title || "",
-      postUrl: `https://www.moltbook.com/posts/${postId}`,
+      postUrl: `https://www.moltbook.com/post/${postId}`,
       contextText: String(n.comment?.content || n.content || n.preview || ""),
       createdAt: n.created_at || n.createdAt || new Date().toISOString(),
       status: "pending",

package/scripts/moltbook-watcher.mjs

@@ -147,6 +147,7 @@ async function pollOnce() {
     const notifications = extractNotifications(data);
     const postCommentCache = new Map();
     const postCache = new Map();
+    const postIdsToMarkRead = new Set();
     for (const n of notifications) {
       if (!isCommentNotification(n)) continue;
       if (n.is_read === true || n.read === true || n.isRead === true) continue;
@@ -182,7 +183,7 @@ async function pollOnce() {
         parentCommentId,
         authorName,
         postTitle,
-        postUrl: `https://www.moltbook.com/posts/${postId}`,
+        postUrl: `https://www.moltbook.com/post/${postId}`,
         contextText,
         createdAt: createdAtIso,
         status: "pending",
@@ -205,6 +206,8 @@ async function pollOnce() {
           contextText,
           draftReply: draftReply(),
           callbackUrl: CALLBACK_URL,
+          postUrl: `https://www.moltbook.com/post/${postId}`,
+          postTitle,
           createdAtMs: Date.parse(createdAtIso) || Date.now(),
         });
         console.log(`[moltbook-watcher] pushed ${sourceId}`);
@@ -212,6 +215,11 @@ async function pollOnce() {
         console.error(`[moltbook-watcher] bridge push failed: ${error.message}`);
       }
 
+      postIdsToMarkRead.add(postId);
+    }
+
+    // Mark notifications as read after processing all comments in this cycle
+    for (const postId of postIdsToMarkRead) {
       try {
         await mb(`/notifications/read-by-post/${postId}`, { method: "POST" });
       } catch (error) {

package/scripts/viveworker-bridge.mjs

@@ -17,7 +17,7 @@ import { DEFAULT_LOCALE, SUPPORTED_LOCALES, localeDisplayName, normalizeLocale,
 import { generatePairingCredentials, shouldRotatePairing, upsertEnvText } from "./lib/pairing.mjs";
 import { renderMarkdownHtml } from "./lib/markdown-render.mjs";
 import { buildAgentCard, handleA2ARequest, resolveA2ATaskDecision, completeA2ATask, failA2ATask } from "./a2a-handler.mjs";
-import { registerWithRelay, startRelayPolling, stopRelayPolling, postRelayResult } from "./a2a-relay-client.mjs";
+import { registerWithRelay, startRelayPolling, stopRelayPolling, postRelayResult, getRelayStatus } from "./a2a-relay-client.mjs";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -10529,6 +10529,7 @@ async function buildApiItemDetail({ config, runtime, state, kind, token, locale
       summary: source.summary || "",
       messageHtml: contextHtml,
       postUrl: source.postUrl || "",
+      postTitle: source.postTitle || "",
       commentAuthor: source.commentAuthor || "",
       provider: "moltbook",
       draftReply: item?.draftReply || "",
@@ -11127,6 +11128,27 @@ function createNativeApprovalServer({ config, runtime, state }) {
         }
       }
 
+      // A2A relay status for the settings UI.
+      if (url.pathname === "/api/a2a/relay-status" && req.method === "GET") {
+        const session = requireApiSession(req, res, config, state);
+        if (!session) return;
+        const relayEnabled = Boolean(config.a2aRelayUrl && config.a2aRelayUserId);
+        if (!relayEnabled) {
+          return writeJson(res, 200, { enabled: false });
+        }
+        const relay = getRelayStatus();
+        return writeJson(res, 200, {
+          enabled: true,
+          connected: relay.polling && relay.lastPollOk,
+          polling: relay.polling,
+          lastPollOk: relay.lastPollOk,
+          lastPollAtMs: relay.lastPollAtMs,
+          userId: config.a2aRelayUserId,
+          relayUrl: config.a2aRelayUrl,
+          apiKeyConfigured: Boolean(config.a2aApiKey),
+        });
+      }
+
       // Activity summary for compose (original post) drafting.
       // Supports ?slot=morning|noon|evening and ?date=YYYY-MM-DD for
       // time-slot-based compose.  Defaults to full-day today.
@@ -11552,6 +11574,7 @@ function createNativeApprovalServer({ config, runtime, state }) {
           draftReply: cleanText(body.draftReply || ""),
           callbackUrl: cleanText(body.callbackUrl || ""),
           postUrl: cleanText(body.postUrl || ""),
+          postTitle: cleanText(body.postTitle || ""),
           commentAuthor: cleanText(body.commentAuthor || ""),
           createdAtMs: Number(body.createdAtMs) || Date.now(),
           resolved: false,

package/scripts/viveworker.mjs

@@ -82,6 +82,9 @@ async function main(cliOptions) {
     case "doctor":
       await runDoctor(cliOptions);
       return;
+    case "update":
+      await runUpdate(cliOptions);
+      return;
     case "help":
     default:
       printHelp();
@@ -846,6 +849,67 @@ async function runDoctor(cliOptions) {
   }
 }
 
+async function runUpdate(cliOptions) {
+  const locale = await resolveCliLocale(cliOptions);
+  const progress = createCliProgressReporter(locale);
+
+  // 1. Check current vs latest version
+  progress.update("cli.update.progress.checkVersion");
+  const pkg = JSON.parse(await fs.readFile(path.join(packageRoot, "package.json"), "utf8"));
+  const currentVersion = pkg.version;
+  const { stdout: latestRaw } = await execCommand(["npm", "view", "viveworker", "version"], { ignoreError: true });
+  const latestVersion = (latestRaw || "").trim();
+
+  if (!latestVersion) {
+    progress.done("cli.update.checkFailed");
+    return;
+  }
+
+  if (currentVersion === latestVersion) {
+    progress.done("cli.update.alreadyLatest", { version: currentVersion });
+    return;
+  }
+
+  console.log(t(locale, "cli.update.versionInfo", { current: currentVersion, latest: latestVersion }));
+
+  // 2. Clear npx cache and re-fetch
+  progress.update("cli.update.progress.install");
+  const npxCacheResult = await execCommand(["npx", "--yes", "viveworker@latest", "--version"], { ignoreError: true });
+  if (!npxCacheResult.ok) {
+    // Fallback: try global install
+    await execCommand(["npm", "install", "-g", "viveworker@latest"], { ignoreError: true });
+  }
+
+  // 3. Restart bridge
+  const launchAgentPath = resolvePath(cliOptions.launchAgentPath || defaultLaunchAgentPath);
+  if (await fileExists(launchAgentPath)) {
+    progress.update("cli.update.progress.restartBridge");
+    await execCommand(["launchctl", "bootout", `gui/${process.getuid()}`, launchAgentPath], { ignoreError: true });
+    await execCommand(["launchctl", "bootstrap", `gui/${process.getuid()}`, launchAgentPath], { ignoreError: true });
+    await execCommand(["launchctl", "kickstart", "-k", `gui/${process.getuid()}/${defaultLabel}`], { ignoreError: true });
+  }
+
+  // 4. Restart moltbook-watcher if present
+  const watcherLabel = "com.viveworker.moltbook-watcher";
+  const watcherPlistPath = path.join(os.homedir(), "Library", "LaunchAgents", `${watcherLabel}.plist`);
+  if (await fileExists(watcherPlistPath)) {
+    progress.update("cli.update.progress.restartWatcher");
+    await execCommand(["launchctl", "bootout", `gui/${process.getuid()}`, watcherPlistPath], { ignoreError: true });
+    await execCommand(["launchctl", "bootstrap", `gui/${process.getuid()}`, watcherPlistPath], { ignoreError: true });
+  }
+
+  // 5. Restart moltbook-scout if present
+  const scoutLabel = "com.viveworker.moltbook-scout";
+  const scoutPlistPath = path.join(os.homedir(), "Library", "LaunchAgents", `${scoutLabel}.plist`);
+  if (await fileExists(scoutPlistPath)) {
+    progress.update("cli.update.progress.restartScout");
+    await execCommand(["launchctl", "bootout", `gui/${process.getuid()}`, scoutPlistPath], { ignoreError: true });
+    await execCommand(["launchctl", "bootstrap", `gui/${process.getuid()}`, scoutPlistPath], { ignoreError: true });
+  }
+
+  progress.done("cli.update.done", { version: latestVersion });
+}
+
 function parseArgs(argv) {
   const parsed = {
     command: "help",
@@ -1019,6 +1083,7 @@ ${t(locale, "cli.help.commands")}
   ${t(locale, "cli.help.stop")}
   ${t(locale, "cli.help.status")}
   ${t(locale, "cli.help.doctor")}
+  ${t(locale, "cli.help.update")}
 
 ${t(locale, "cli.help.commonOptions")}
   --port <n>

package/web/app.css

@@ -1124,6 +1124,9 @@ code {
   top: calc(100% + 0.46rem);
   z-index: 14;
   width: min(15rem, calc(100vw - 2.25rem));
+  max-height: 18rem;
+  overflow-y: auto;
+  -webkit-overflow-scrolling: touch;
   display: grid;
   gap: 0.22rem;
   padding: 0.4rem;
@@ -1650,6 +1653,15 @@ code {
   line-height: 1.15;
   letter-spacing: -0.03em;
 }
+.detail-title__link {
+  color: inherit;
+  text-decoration: none;
+}
+.detail-title__link:hover {
+  text-decoration: underline;
+  text-decoration-color: var(--accent, #00d4aa);
+  text-underline-offset: 0.15em;
+}
 
 .detail-body {
   overflow-wrap: anywhere;
@@ -2246,6 +2258,9 @@ code {
   gap: 0.78rem;
 }
 
+.reply-composer--readonly {
+  gap: 0.35rem;
+}
 .reply-composer__copy {
   display: grid;
   gap: 0.34rem;
@@ -2280,10 +2295,16 @@ code {
   color: var(--muted);
 }
 .reply-composer__context-body {
-  margin-top: 0.5rem;
+  margin-top: 0.25rem;
   line-height: 1.55;
   color: var(--text);
 }
+.reply-composer__context-body > :first-child {
+  margin-top: 0;
+}
+.reply-composer__context-body > :last-child {
+  margin-bottom: 0;
+}
 .reply-composer__intent {
   margin: 0.5rem 0;
   padding: 0.6rem 0.75rem;
@@ -2299,6 +2320,21 @@ code {
   margin: 0.1rem 0 0.4rem;
   font-size: 0.85rem;
 }
+.reply-composer__author {
+  margin: 0;
+}
+.reply-composer__post-title {
+  margin: 0;
+  font-size: 0.9rem;
+  font-weight: 600;
+}
+.reply-composer__post-title a {
+  color: var(--accent, #00d4aa);
+  text-decoration: none;
+}
+.reply-composer__post-title a:hover {
+  text-decoration: underline;
+}
 .reply-composer__textarea {
   width: 100%;
   min-height: 14rem;

package/web/app.js

@@ -48,6 +48,7 @@ const state = {
   pairNotice: "",
   pushStatus: null,
   moltbookScoutStatus: null,
+  a2aRelayStatus: null,
   pushNotice: "",
   pushError: "",
   deviceNotice: "",
@@ -214,6 +215,7 @@ async function refreshAuthenticatedState() {
   await refreshDevices();
   await refreshPushStatus();
   await fetchMoltbookScoutStatus();
+  await fetchA2aRelayStatus();
   ensureCurrentSelection();
 }
 
@@ -331,6 +333,18 @@ async function fetchMoltbookScoutStatus() {
   }
 }
 
+async function fetchA2aRelayStatus() {
+  if (!state.session?.a2aRelayEnabled) {
+    state.a2aRelayStatus = null;
+    return;
+  }
+  try {
+    state.a2aRelayStatus = await apiGet("/api/a2a/relay-status");
+  } catch {
+    state.a2aRelayStatus = null;
+  }
+}
+
 async function getClientPushState() {
   const registration = state.serviceWorkerRegistration || (await navigator.serviceWorker?.ready.catch(() => null));
   if (registration) {
@@ -624,6 +638,8 @@ function timelineKindFilterOptions() {
     { id: "plans", label: L("timeline.kindFilter.plans"), icon: "plan" },
     { id: "choices", label: L("timeline.kindFilter.choices"), icon: "choice" },
     { id: "completions", label: L("timeline.kindFilter.completions"), icon: "completion-item" },
+    { id: "moltbook_drafts", label: L("timeline.kindFilter.moltbookDrafts"), icon: "moltbook-draft" },
+    { id: "moltbook_comments", label: L("timeline.kindFilter.moltbookComments"), icon: "moltbook-comment" },
   ];
 }
 
@@ -649,6 +665,10 @@ function timelineEntryMatchesKindFilter(entry, filterId) {
       return kind === "choice";
     case "completions":
       return kind === "completion";
+    case "moltbook_drafts":
+      return kind === "moltbook_draft";
+    case "moltbook_comments":
+      return kind === "moltbook_reply";
     default:
       return true;
   }
@@ -991,6 +1011,9 @@ function shouldDeferRenderForActiveInteraction() {
   ) {
     return true;
   }
+  if (state.timelineKindFilterOpen) {
+    return true;
+  }
   return state.threadFilterInteractionUntilMs > Date.now();
 }
 
@@ -2745,6 +2768,7 @@ function buildSettingsContext() {
       serverEnabled,
     }),
     moltbookScout: state.moltbookScoutStatus,
+    a2aRelay: state.a2aRelayStatus,
   };
 }
 
@@ -2898,6 +2922,13 @@ function settingsPageMeta(page) {
         description: L("settings.moltbook.copy"),
         icon: "item",
       };
+    case "a2aRelay":
+      return {
+        id: "a2aRelay",
+        title: L("settings.a2aRelay.title"),
+        description: L("settings.a2aRelay.copy"),
+        icon: "link",
+      };
     default:
       return settingsPageMeta("notifications");
   }
@@ -2967,15 +2998,22 @@ function renderSettingsRoot(context, { mobile }) {
           `
       }
       ${renderSettingsGroup(L("settings.group.general"), generalRows)}
-      ${state.session?.moltbookEnabled ? renderSettingsGroup(L("common.sns"), [
-        renderSettingsNavRow({
+      ${(state.session?.moltbookEnabled || state.session?.a2aRelayEnabled) ? renderSettingsGroup(L("settings.group.integrations"), [
+        state.session?.moltbookEnabled ? renderSettingsNavRow({
           page: "moltbook",
           icon: "item",
           title: L("settings.moltbook.title"),
           subtitle: L("settings.moltbook.subtitle"),
           value: context.moltbookScout?.enabled ? `${context.moltbookScout.sentToday} / ${context.moltbookScout.maxDaily}` : "",
-        }),
-      ]) : ""}
+        }) : "",
+        state.session?.a2aRelayEnabled ? renderSettingsNavRow({
+          page: "a2aRelay",
+          icon: "link",
+          title: L("settings.a2aRelay.title"),
+          subtitle: L("settings.a2aRelay.subtitle"),
+          value: context.a2aRelay?.connected ? L("settings.status.connected") : L("settings.a2aRelay.status.disconnected"),
+        }) : "",
+      ].filter(Boolean)) : ""}
       ${renderSettingsGroup(L("settings.pairing.title"), deviceRows)}
       ${renderSettingsGroup(L("settings.group.advanced"), advancedRows)}
     </div>
@@ -3022,6 +3060,9 @@ function renderSettingsSubpage(context, { mobile }) {
     case "moltbook":
       content = renderSettingsMoltbookPage(context);
       break;
+    case "a2aRelay":
+      content = renderSettingsA2aRelayPage(context);
+      break;
     default:
       content = "";
   }
@@ -3273,6 +3314,38 @@ function renderSettingsMoltbookPage(context) {
   `;
 }
 
+function renderSettingsA2aRelayPage(context) {
+  const relay = context.a2aRelay;
+  if (!relay?.enabled) {
+    return `
+      <div class="settings-page">
+        <p class="settings-page-copy muted">${escapeHtml(L("settings.a2aRelay.unavailable"))}</p>
+      </div>
+    `;
+  }
+  const statusLabel = relay.connected
+    ? L("settings.status.connected")
+    : relay.polling
+      ? L("settings.a2aRelay.status.polling")
+      : L("settings.a2aRelay.status.disconnected");
+  const profileUrl = `${relay.relayUrl}/${relay.userId}`;
+  const userIdLink = `<a href="${escapeHtml(profileUrl)}" target="_blank" rel="noopener">${escapeHtml(relay.userId)}</a>`;
+  const relayHost = (() => { try { return new URL(relay.relayUrl).host; } catch { return relay.relayUrl; } })();
+  return `
+    <div class="settings-page">
+      ${renderSettingsGroup("", [
+        renderSettingsInfoRow(L("settings.row.a2aStatus"), statusLabel),
+        renderSettingsInfoRow(L("settings.row.a2aUserId"), userIdLink, { rawValue: true }),
+        renderSettingsInfoRow(L("settings.row.a2aRelay"), relayHost),
+        renderSettingsInfoRow(L("settings.row.a2aApiKey"), relay.apiKeyConfigured ? L("settings.a2aRelay.apiKey.configured") : L("settings.a2aRelay.apiKey.notConfigured")),
+        relay.lastPollAtMs
+          ? renderSettingsInfoRow(L("settings.row.a2aLastPoll"), new Date(relay.lastPollAtMs).toLocaleString(state.locale))
+          : "",
+      ].filter(Boolean))}
+    </div>
+  `;
+}
+
 function renderSettingsInfoRow(label, value, options = {}) {
   const rowClassName = ["settings-info-row", options.rowClassName || ""].filter(Boolean).join(" ");
   const valueClassName = ["settings-info-row__value", options.valueClassName || ""].filter(Boolean).join(" ");
@@ -3385,7 +3458,7 @@ function renderStandardDetailDesktop(detail) {
   return `
     <div class="detail-shell">
       ${renderDetailMetaRow(detail, kindInfo)}
-      <h2 class="detail-title detail-title--desktop">${escapeHtml(detailDisplayTitle(detail))}</h2>
+      <h2 class="detail-title detail-title--desktop">${renderDetailTitle(detail)}</h2>
       ${detail.readOnly || detail.kind === "approval" || detail.kind === "moltbook_draft" || detail.kind === "moltbook_reply" ? "" : renderDetailLead(detail, kindInfo)}
       ${renderPreviousContextCard(detail)}
       ${renderInterruptedDetailNotice(detail)}
@@ -3893,9 +3966,12 @@ function renderMoltbookReplyComposer(detail, options = {}) {
   const rawTitle = normalizeClientText(detail.title || "");
   const match = rawTitle.match(/^@([^\s]+)/u);
   const authorHandle = match ? match[1] : detail.commentAuthor || "";
-  const postUrl = detail.postUrl || "";
-  const postLink = postUrl
-    ? `<p class="reply-composer__author"><a href="${escapeHtml(postUrl)}" target="_blank" rel="noopener">${escapeHtml(postUrl)}</a></p>`
+  const postUrl = detail.postUrl || (detail.threadId ? `https://www.moltbook.com/post/${detail.threadId}` : "");
+  const postTitle = normalizeClientText(detail.postTitle || detail.threadLabel || "").replace(/^Moltbook\s*·\s*/iu, "");
+  const postLink = postTitle
+    ? (postUrl
+      ? `<p class="reply-composer__post-title"><a href="${escapeHtml(postUrl)}" target="_blank" rel="noopener">${escapeHtml(postTitle)}</a></p>`
+      : `<p class="reply-composer__post-title">${escapeHtml(postTitle)}</p>`)
     : "";
   const bodyHtml = detail.messageHtml
     ? `<div class="reply-composer__context-body markdown">${detail.messageHtml}</div>`
@@ -3922,8 +3998,12 @@ function renderMoltbookDraftComposer(detail, options = {}) {
   const postAuthorLine = !isOriginalPost && detail.postAuthor
     ? `<p class="reply-composer__author-meta muted">@${escapeHtml(detail.postAuthor)}</p>`
     : "";
-  const postLink = !isOriginalPost && detail.postUrl
-    ? `<p class="reply-composer__author"><a href="${escapeHtml(detail.postUrl)}" target="_blank" rel="noopener">${escapeHtml(detail.postTitle || detail.postUrl)}</a></p>`
+  const draftPostUrl = detail.postUrl || (detail.threadId ? `https://www.moltbook.com/post/${detail.threadId}` : "");
+  const draftPostTitle = normalizeClientText(detail.postTitle || detail.threadLabel || "").replace(/^Moltbook\s*·\s*/iu, "");
+  const postLink = !isOriginalPost && draftPostTitle
+    ? (draftPostUrl
+      ? `<p class="reply-composer__post-title"><a href="${escapeHtml(draftPostUrl)}" target="_blank" rel="noopener">${escapeHtml(draftPostTitle)}</a></p>`
+      : `<p class="reply-composer__post-title">${escapeHtml(draftPostTitle)}</p>`)
     : "";
   const postBodyBlock = !isOriginalPost && detail.postBody
     ? `<details class="reply-composer__context"><summary>元の投稿</summary><div class="reply-composer__context-body">${escapeHtml(detail.postBody).replace(/\n/g, "<br>")}</div></details>`
@@ -5769,6 +5849,14 @@ function detailIntentText(detail) {
   return itemIntentText(detail.kind, "pending", provider);
 }
 
+function renderDetailTitle(detail) {
+  const title = escapeHtml(detailDisplayTitle(detail));
+  if ((detail.kind === "moltbook_reply" || detail.kind === "moltbook_draft") && detail.postUrl) {
+    return `<a href="${escapeHtml(detail.postUrl)}" target="_blank" rel="noopener" class="detail-title__link">${title}</a>`;
+  }
+  return title;
+}
+
 function detailDisplayTitle(detail) {
   const threadLabel = normalizeClientText(detail?.threadLabel || "");
   if (threadLabel) {
@@ -6050,6 +6138,10 @@ function renderIcon(name) {
       return `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M10.4 13.6 8.3 15.7a3 3 0 0 1-4.2-4.2l2.8-2.8a3 3 0 0 1 4.2 0"/><path d="m13.6 10.4 2.1-2.1a3 3 0 1 1 4.2 4.2l-2.8 2.8a3 3 0 0 1-4.2 0"/><path d="m9.5 14.5 5-5"/></svg>`;
     case "clip":
       return `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="m9.5 12.5 5.9-5.9a3 3 0 1 1 4.2 4.2l-7.7 7.7a5 5 0 1 1-7.1-7.1l8.1-8.1"/></svg>`;
+    case "moltbook-draft":
+      return `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M15.2 3.8 20.2 8.8 8.5 20.5 3.5 20.5 3.5 15.5Z"/><path d="M12.5 6.5l5 5"/></svg>`;
+    case "moltbook-comment":
+      return `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M4.5 5.5h15a2 2 0 0 1 2 2v7a2 2 0 0 1-2 2H11l-4 3.5v-3.5H4.5a2 2 0 0 1-2-2v-7a2 2 0 0 1 2-2Z"/><path d="M8 10h8"/><path d="M8 13h5"/></svg>`;
     case "filter":
       return `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M5 7h14"/><path d="M8 12h8"/><path d="M10.5 17h3"/></svg>`;
     case "check":

package/web/i18n.js

@@ -222,6 +222,8 @@ const translations = {
     "timeline.kindFilter.plans": "Plans",
     "timeline.kindFilter.choices": "Choices",
     "timeline.kindFilter.completions": "Completed",
+    "timeline.kindFilter.moltbookDrafts": "Drafts",
+    "timeline.kindFilter.moltbookComments": "Comments",
     "fileEvent.read": "Checked files",
     "fileEvent.write": "Updated files",
     "fileEvent.create": "Created files",
@@ -371,6 +373,20 @@ const translations = {
     "moltbook.draft.greetNoon": "Nice progress! Ready to share your morning work?",
     "moltbook.draft.greetEvening": "Great work today! Let's share what you built.",
     "moltbook.draft.greetFallback": "New post ready for review",
+    "settings.group.integrations": "Integrations",
+    "settings.a2aRelay.title": "A2A Relay",
+    "settings.a2aRelay.subtitle": "Agent-to-Agent relay connection",
+    "settings.a2aRelay.copy": "View your A2A relay connection status and configuration.",
+    "settings.a2aRelay.unavailable": "A2A Relay is not configured.",
+    "settings.a2aRelay.status.disconnected": "Disconnected",
+    "settings.a2aRelay.status.polling": "Connecting...",
+    "settings.a2aRelay.apiKey.configured": "Configured",
+    "settings.a2aRelay.apiKey.notConfigured": "Not configured",
+    "settings.row.a2aStatus": "Status",
+    "settings.row.a2aUserId": "User ID",
+    "settings.row.a2aRelay": "Relay",
+    "settings.row.a2aApiKey": "API Key",
+    "settings.row.a2aLastPoll": "Last poll",
     "a2a.task.eyebrow": "A2A Task Request",
     "a2a.task.from": "From",
     "a2a.task.instruction": "Task",
@@ -483,13 +499,23 @@ const translations = {
     "server.page.choiceMissing": "Choice input token not found",
     "server.page.approvalHandled": "Approval already handled",
     "server.page.detailMissing": "Completion detail not found",
-    "cli.help.usage": "Usage: viveworker <setup|start|stop|status|doctor> [options]",
+    "cli.help.usage": "Usage: viveworker <setup|start|stop|status|doctor|update> [options]",
     "cli.help.commands": "Commands:",
     "cli.help.setup": "setup         Create config, generate pairing info, register launchd, start the bridge",
     "cli.help.start": "start         Start the bridge using the saved config",
     "cli.help.stop": "stop          Stop the bridge",
     "cli.help.status": "status        Print launchd/background status and health",
     "cli.help.doctor": "doctor        Diagnose the local setup",
+    "cli.help.update": "update        Update to the latest version and restart all services",
+    "cli.update.progress.checkVersion": "Checking for updates...",
+    "cli.update.progress.install": "Installing latest version...",
+    "cli.update.progress.restartBridge": "Restarting bridge...",
+    "cli.update.progress.restartWatcher": "Restarting Moltbook watcher...",
+    "cli.update.progress.restartScout": "Restarting Moltbook scout...",
+    "cli.update.checkFailed": "Could not check the latest version from npm",
+    "cli.update.alreadyLatest": "Already up to date (v{version})",
+    "cli.update.versionInfo": "Updating v{current} -> v{latest}",
+    "cli.update.done": "Updated to v{version} — all services restarted",
     "cli.help.commonOptions": "Common options:",
     "cli.setup.complete": "viveworker setup complete",
     "cli.setup.progress.prepare": "Preparing local viveworker setup...",
@@ -809,6 +835,8 @@ const translations = {
     "timeline.kindFilter.plans": "プラン",
     "timeline.kindFilter.choices": "選択",
     "timeline.kindFilter.completions": "完了",
+    "timeline.kindFilter.moltbookDrafts": "ドラフト",
+    "timeline.kindFilter.moltbookComments": "コメント",
     "fileEvent.read": "ファイルを確認",
     "fileEvent.write": "ファイルを更新",
     "fileEvent.create": "ファイルを作成",
@@ -958,6 +986,20 @@ const translations = {
     "moltbook.draft.greetNoon": "午前中お疲れ様でした！進捗をシェアしませんか？",
     "moltbook.draft.greetEvening": "今日もお疲れ様でした！成果をシェアしませんか？",
     "moltbook.draft.greetFallback": "投稿ドラフトができました",
+    "settings.group.integrations": "連携サービス",
+    "settings.a2aRelay.title": "A2A Relay",
+    "settings.a2aRelay.subtitle": "Agent-to-Agent リレー接続",
+    "settings.a2aRelay.copy": "A2A リレーの接続状態と設定を確認できます。",
+    "settings.a2aRelay.unavailable": "A2A Relay が設定されていません。",
+    "settings.a2aRelay.status.disconnected": "切断",
+    "settings.a2aRelay.status.polling": "接続中...",
+    "settings.a2aRelay.apiKey.configured": "設定済み",
+    "settings.a2aRelay.apiKey.notConfigured": "未設定",
+    "settings.row.a2aStatus": "ステータス",
+    "settings.row.a2aUserId": "ユーザー ID",
+    "settings.row.a2aRelay": "リレー",
+    "settings.row.a2aApiKey": "API キー",
+    "settings.row.a2aLastPoll": "最終ポーリング",
     "a2a.task.eyebrow": "A2A タスクリクエスト",
     "a2a.task.from": "送信元",
     "a2a.task.instruction": "タスク内容",
@@ -1070,13 +1112,23 @@ const translations = {
     "server.page.choiceMissing": "選択入力トークンが見つかりません",
     "server.page.approvalHandled": "この承認はすでに処理済みです",
     "server.page.detailMissing": "完了詳細が見つかりません",
-    "cli.help.usage": "Usage: viveworker <setup|start|stop|status|doctor> [options]",
+    "cli.help.usage": "Usage: viveworker <setup|start|stop|status|doctor|update> [options]",
     "cli.help.commands": "Commands:",
     "cli.help.setup": "setup         設定を作成し、ペアリング情報を生成し、launchd に登録して bridge を起動します",
     "cli.help.start": "start         保存済み設定で bridge を起動します",
     "cli.help.stop": "stop          bridge を停止します",
     "cli.help.status": "status        launchd / バックグラウンド状態と health を表示します",
     "cli.help.doctor": "doctor        ローカル設定を診断します",
+    "cli.help.update": "update        最新バージョンに更新し、全サービスを再起動します",
+    "cli.update.progress.checkVersion": "更新を確認しています...",
+    "cli.update.progress.install": "最新バージョンをインストールしています...",
+    "cli.update.progress.restartBridge": "bridge を再起動しています...",
+    "cli.update.progress.restartWatcher": "Moltbook watcher を再起動しています...",
+    "cli.update.progress.restartScout": "Moltbook scout を再起動しています...",
+    "cli.update.checkFailed": "npm から最新バージョンを確認できませんでした",
+    "cli.update.alreadyLatest": "すでに最新です (v{version})",
+    "cli.update.versionInfo": "v{current} -> v{latest} に更新します",
+    "cli.update.done": "v{version} に更新しました — 全サービスを再起動しました",
     "cli.help.commonOptions": "共通オプション:",
     "cli.setup.complete": "viveworker の setup が完了しました",
     "cli.setup.progress.prepare": "viveworker のローカル設定を準備しています...",