viveworker 0.4.2 → 0.4.5

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.2",
+  "version": "0.4.5",
   "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-handler.mjs

@@ -27,11 +27,17 @@ export function buildAgentCard(config) {
   // Custom skills from A2A_SKILLS env var (comma-separated tags → skill objects)
   let skills;
   if (config.a2aSkills) {
-    skills = config.a2aSkills.split(",").map((s) => s.trim()).filter(Boolean).map((tag) => ({
-      id: tag,
-      name: tag,
-      description: tag,
-    }));
+    const LABEL_MAP = {
+      typescript: "TypeScript", javascript: "JavaScript",
+      nodejs: "Node.js", pwa: "PWA", api: "API", css: "CSS", html: "HTML",
+      sql: "SQL", graphql: "GraphQL", nextjs: "Next.js", vuejs: "Vue.js",
+      aws: "AWS", gcp: "GCP", cli: "CLI", cicd: "CI/CD", a2a: "A2A",
+      llm: "LLM", ai: "AI", ml: "ML",
+    };
+    skills = config.a2aSkills.split(",").map((s) => s.trim()).filter(Boolean).map((tag) => {
+      const label = LABEL_MAP[tag] || tag.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+      return { id: tag, name: label, description: label };
+    });
   } else {
     skills = [
       {
@@ -63,7 +69,7 @@ export function buildAgentCard(config) {
   const card = {
     schemaVersion: "1.0",
     humanReadableId: `viveworker/${config.a2aRelayUserId || "viveworker"}`,
-    agentVersion: config.version || "0.3.0",
+    agentVersion: config.version || "0.1.0",
     name: "viveworker",
     description,
     url: `${baseUrl.replace(/\/$/u, "")}/a2a`,

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

@@ -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 || "",
@@ -11552,6 +11553,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,
@@ -13790,6 +13792,7 @@ function buildConfig(cli) {
     a2aDescription: cleanText(process.env.A2A_DESCRIPTION || ""),
     a2aSkills: cleanText(process.env.A2A_SKILLS || ""),
     a2aAvatar: cleanText(process.env.A2A_AVATAR || ""),
+    version: appPackageVersion,
     a2aRelayUrl: cleanText(process.env.A2A_RELAY_URL || ""),
     a2aRelayUserId: cleanText(process.env.A2A_RELAY_USER_ID || ""),
     a2aRelaySecret: cleanText(process.env.A2A_RELAY_SECRET || ""),

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

@@ -624,6 +624,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 +651,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 +997,9 @@ function shouldDeferRenderForActiveInteraction() {
   ) {
     return true;
   }
+  if (state.timelineKindFilterOpen) {
+    return true;
+  }
   return state.threadFilterInteractionUntilMs > Date.now();
 }
 
@@ -3385,7 +3394,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 +3902,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 +3934,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 +5785,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 +6074,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",
@@ -809,6 +811,8 @@ const translations = {
     "timeline.kindFilter.plans": "プラン",
     "timeline.kindFilter.choices": "選択",
     "timeline.kindFilter.completions": "完了",
+    "timeline.kindFilter.moltbookDrafts": "ドラフト",
+    "timeline.kindFilter.moltbookComments": "コメント",
     "fileEvent.read": "ファイルを確認",
     "fileEvent.write": "ファイルを更新",
     "fileEvent.create": "ファイルを作成",