viveworker 0.2.0 → 0.3.0

package/README.md

@@ -193,6 +193,46 @@ npx viveworker doctor
 - 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.
+
+### What it does
+
+- **Incoming replies**: detects when other agents comment on your posts and notifies your phone so you can draft a reply
+- **Auto-scout replies**: every 2 minutes, scans the Moltbook feed, scores posts against your agent's persona (0–100), batches candidates over a 30-minute window, picks the best match, drafts a reply via LLM, and proposes it for your approval
+- **Original post drafts**: based on your daily coding activity, composes new posts in your agent's voice and proposes them at natural intervals — morning (yesterday recap), noon (morning progress), and evening (full-day summary). Up to 3 per day; deny any slot you don't want
+
+### How it works
+
+1. Define your agent's persona in `~/.viveworker/moltbook-persona.md` — voice, expertise, interests, topics to avoid
+2. The system filters all content through this persona: only activities and posts that match your agent's expertise are surfaced
+3. Drafts arrive as phone notifications with an editable title, body, and one-tap approve/deny
+4. On approve, `viveworker` posts to Moltbook and solves the verification puzzle automatically
+
+### Setup
+
+```bash
+# Add your Moltbook API key
+cat > ~/.viveworker/moltbook.env << 'EOF'
+MOLTBOOK_API_KEY=your-api-key
+MOLTBOOK_AGENT_ID=your-agent-id
+EOF
+
+# Initialize your agent's persona
+npx viveworker moltbook persona init
+
+# The watcher and scout start automatically with viveworker
+npx viveworker start
+```
+
+### Key commands
+
+- `npx viveworker moltbook list` — show pending comment notifications
+- `npx viveworker moltbook scout` — manually pick a feed candidate
+- `npx viveworker moltbook compose` — check today's activity for post material
+- `npx viveworker moltbook persona show` — view your agent's persona
+
 ## Roadmap
 
 Planned next steps include:
@@ -200,3 +240,4 @@ Planned next steps include:
 - Windows support
 - ✅ ~~Android support~~ (Apr 1, 2026)
 - ✅ ~~image attachment support from mobile~~ (Mar 26, 2026)
+- ✅ ~~Moltbook integration~~ (Apr 10, 2026)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viveworker",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Local mobile companion for Codex Desktop and Claude Desktop approvals, questions, completions, and code review on your LAN.",
   "author": "Yuta Hoshino <hoshino.lireneo@gmail.com>",
   "license": "MIT",
@@ -33,6 +33,11 @@
     "scripts/viveworker.mjs",
     "scripts/viveworker-bridge.mjs",
     "scripts/viveworker-claude-hook.mjs",
+    "scripts/moltbook-api.mjs",
+    "scripts/moltbook-cli.mjs",
+    "scripts/moltbook-watcher.mjs",
+    "scripts/moltbook-scout-run.sh",
+    "scripts/com.viveworker.moltbook-scout.plist.sample",
     "scripts/lib",
     "web",
     "README.md",

package/scripts/com.viveworker.moltbook-scout.plist.sample

@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<!--
+  SAMPLE launchd agent for the Moltbook scouting loop.
+
+  This is provider-neutral: the cron command invokes whichever agent CLI
+  you use. Customize the inner command to call `codex exec`, `claude -p`,
+  a small Anthropic SDK script, or whatever produces drafts for you.
+
+  Install:
+    1. Copy this file to ~/Library/LaunchAgents/com.viveworker.moltbook-scout.plist
+    2. Replace the placeholders (PATH/TO/VIVEWORKER, your agent CLI line)
+    3. Make sure ~/.viveworker/moltbook.env is populated (same file the
+       watcher uses) and that VIVEWORKER_HOOK_SECRET matches the bridge.
+    4. launchctl load ~/Library/LaunchAgents/com.viveworker.moltbook-scout.plist
+-->
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.viveworker.moltbook-scout</string>
+
+  <key>ProgramArguments</key>
+  <array>
+    <string>/bin/bash</string>
+    <string>-lc</string>
+    <!--
+      Example for a Codex Desktop user with `codex exec`:
+
+        set -a; . "$HOME/.viveworker/moltbook.env"; set +a;
+        cd "$HOME/path/to/viveworker";
+        codex exec "Run scripts/moltbook-scout-run.sh. If it prints a
+        candidate (status: 'candidate'), draft a 2-3 paragraph reply in
+        viveworker voice (informal lowercase, technically substantive,
+        no signature) and run: node scripts/viveworker.mjs moltbook
+        propose <postId> --text \"<your draft>\" --timeout 900. If
+        scout prints anything else, exit quietly."
+
+      Replace `codex exec` with `claude -p` for Claude Code users, or
+      with your own SDK runner.
+    -->
+    <string>set -a; . "$HOME/.viveworker/moltbook.env"; set +a; cd "$HOME/path/to/viveworker" &amp;&amp; codex exec "Run scripts/moltbook-scout-run.sh and, if it prints a candidate, draft a reply in viveworker voice and call viveworker moltbook propose &lt;postId&gt; --text \"...\" --timeout 900."</string>
+  </array>
+
+  <key>StartInterval</key>
+  <integer>120</integer>
+
+  <key>RunAtLoad</key>
+  <false/>
+
+  <key>StandardOutPath</key>
+  <string>/tmp/viveworker-moltbook-scout.out.log</string>
+  <key>StandardErrorPath</key>
+  <string>/tmp/viveworker-moltbook-scout.err.log</string>
+
+  <key>ProcessType</key>
+  <string>Background</string>
+</dict>
+</plist>

package/scripts/moltbook-api.mjs

@@ -0,0 +1,201 @@
+// Shared Moltbook API helpers used by the watcher and the CLI.
+// Keeps credential loading + request plumbing in one place.
+
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+
+export const API_BASE = "https://www.moltbook.com/api/v1";
+
+export const DEFAULT_ENV_FILE = path.join(os.homedir(), ".viveworker", "moltbook.env");
+export const DEFAULT_INBOX_DIR = path.join(os.homedir(), ".viveworker", "moltbook-inbox");
+export const DEFAULT_SCOUT_STATE_FILE = path.join(os.homedir(), ".viveworker", "moltbook-scout-state.json");
+
+export async function loadMoltbookEnv(envFile = DEFAULT_ENV_FILE) {
+  const env = {};
+  try {
+    const raw = await fs.readFile(envFile, "utf8");
+    for (const line of raw.split("\n")) {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("#")) continue;
+      const eq = trimmed.indexOf("=");
+      if (eq === -1) continue;
+      env[trimmed.slice(0, eq).trim()] = trimmed.slice(eq + 1).trim();
+    }
+  } catch {
+    // Missing env file is fine — caller will validate required keys.
+  }
+  // Fall back to process.env for anything not in the file.
+  for (const key of ["MOLTBOOK_API_KEY", "MOLTBOOK_AGENT_ID", "VIVEWORKER_HOOK_SECRET", "VIVEWORKER_BASE_URL"]) {
+    if (!env[key] && process.env[key]) env[key] = process.env[key];
+  }
+  return env;
+}
+
+export function createMoltbookClient(apiKey) {
+  if (!apiKey) {
+    throw new Error("MOLTBOOK_API_KEY is required");
+  }
+  return async function mb(pathname, init = {}) {
+    const res = await fetch(`${API_BASE}${pathname}`, {
+      ...init,
+      headers: {
+        "content-type": "application/json",
+        authorization: `Bearer ${apiKey}`,
+        ...(init.headers || {}),
+      },
+    });
+    const text = await res.text().catch(() => "");
+    if (!res.ok) {
+      throw new Error(`moltbook ${res.status} ${pathname}: ${text}`);
+    }
+    try {
+      return JSON.parse(text);
+    } catch {
+      return text;
+    }
+  };
+}
+
+export function extractNotifications(payload) {
+  const list = [];
+  const candidates = [
+    payload?.notifications,
+    payload?.data?.notifications,
+    payload?.unread_notifications,
+    payload?.activity,
+  ];
+  for (const arr of candidates) {
+    if (Array.isArray(arr)) list.push(...arr);
+  }
+  return list;
+}
+
+export function isCommentNotification(n) {
+  const type = String(n?.type || n?.kind || "").toLowerCase();
+  return type.includes("comment") || type.includes("reply") || type.includes("mention");
+}
+
+export async function ensureInboxDir(dir = DEFAULT_INBOX_DIR) {
+  await fs.mkdir(dir, { recursive: true });
+  return dir;
+}
+
+export function inboxPathFor(commentId, dir = DEFAULT_INBOX_DIR) {
+  return path.join(dir, `${commentId}.json`);
+}
+
+export async function writeInboxItem(item, dir = DEFAULT_INBOX_DIR) {
+  await ensureInboxDir(dir);
+  await fs.writeFile(inboxPathFor(item.commentId, dir), JSON.stringify(item, null, 2) + "\n", "utf8");
+}
+
+export async function readInboxItem(commentId, dir = DEFAULT_INBOX_DIR) {
+  try {
+    const raw = await fs.readFile(inboxPathFor(commentId, dir), "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+
+export async function updateInboxStatus(commentId, status, extra = {}, dir = DEFAULT_INBOX_DIR) {
+  const existing = await readInboxItem(commentId, dir);
+  if (!existing) return null;
+  const updated = { ...existing, ...extra, status, updatedAt: new Date().toISOString() };
+  await writeInboxItem(updated, dir);
+  return updated;
+}
+
+// ---------- Scout state ----------
+//
+// Tracks per-day usage of the Moltbook scouting loop so we can enforce a
+// simple daily quota and avoid re-proposing drafts against the same post.
+
+export async function readScoutState(file = DEFAULT_SCOUT_STATE_FILE) {
+  try {
+    const raw = await fs.readFile(file, "utf8");
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== "object") return defaultScoutState();
+    return {
+      day: String(parsed.day || ""),
+      sentToday: Number(parsed.sentToday) || 0,
+      seenPostIds: parsed.seenPostIds && typeof parsed.seenPostIds === "object" ? parsed.seenPostIds : {},
+      batch: parsed.batch && typeof parsed.batch === "object" ? parsed.batch : null,
+      lastComposeDay: String(parsed.lastComposeDay || ""),
+      composedToday: Number(parsed.composedToday) || 0,
+      composeSlotsAttempted: Array.isArray(parsed.composeSlotsAttempted) ? parsed.composeSlotsAttempted : [],
+      recentComposeTitles: Array.isArray(parsed.recentComposeTitles) ? parsed.recentComposeTitles : [],
+    };
+  } catch {
+    return defaultScoutState();
+  }
+}
+
+export async function writeScoutState(state, file = DEFAULT_SCOUT_STATE_FILE) {
+  await fs.mkdir(path.dirname(file), { recursive: true });
+  await fs.writeFile(file, JSON.stringify(state, null, 2) + "\n", "utf8");
+}
+
+export function defaultScoutState() {
+  return { day: todayKey(), sentToday: 0, seenPostIds: {}, batch: null, lastComposeDay: "", composedToday: 0, composeSlotsAttempted: [], recentComposeTitles: [] };
+}
+
+export function todayKey() {
+  const d = new Date();
+  const y = d.getUTCFullYear();
+  const m = String(d.getUTCMonth() + 1).padStart(2, "0");
+  const day = String(d.getUTCDate()).padStart(2, "0");
+  return `${y}-${m}-${day}`;
+}
+
+export function rollScoutDayIfNeeded(state) {
+  const today = todayKey();
+  if (state.day !== today) {
+    state.day = today;
+    state.sentToday = 0;
+    state.composedToday = 0;
+    state.composeSlotsAttempted = [];
+  }
+  // Evict seenPostIds entries older than 30 days to keep the file small.
+  const cutoff = Date.now() - 30 * 24 * 60 * 60 * 1000;
+  for (const [id, entry] of Object.entries(state.seenPostIds)) {
+    // Support both legacy (bare timestamp) and new ({ ts, outcome }) formats.
+    const ts = typeof entry === "number" ? entry : (entry?.ts ?? 0);
+    if (!Number.isFinite(ts) || ts < cutoff) delete state.seenPostIds[id];
+  }
+  return state;
+}
+
+export function recordComposeAttempt(state, title) {
+  state.composedToday = (state.composedToday || 0) + 1;
+  state.lastComposeDay = todayKey();
+  if (!Array.isArray(state.recentComposeTitles)) state.recentComposeTitles = [];
+  state.recentComposeTitles.unshift(String(title || ""));
+  if (state.recentComposeTitles.length > 10) state.recentComposeTitles.length = 10;
+  return state;
+}
+
+export function markPostSeen(state, postId, outcome = "seen") {
+  state.seenPostIds[String(postId)] = { ts: Date.now(), outcome };
+  return state;
+}
+
+export async function listInboxItems(dir = DEFAULT_INBOX_DIR) {
+  try {
+    const files = await fs.readdir(dir);
+    const items = [];
+    for (const file of files) {
+      if (!file.endsWith(".json")) continue;
+      try {
+        const raw = await fs.readFile(path.join(dir, file), "utf8");
+        items.push(JSON.parse(raw));
+      } catch {
+        // skip bad file
+      }
+    }
+    return items.sort((a, b) => String(b.createdAt || "").localeCompare(String(a.createdAt || "")));
+  } catch {
+    return [];
+  }
+}