@paigy/harness 0.1.1 → 0.1.5

package/README.md

@@ -193,6 +193,22 @@ the window.
 Pairing is one-time and lives in `~/.paigy` — the app reads it, never mints it. If
 you've never paired: `npx -y -p @paigy/mcp paigy-mcp-onboard`.
 
+## Uninstall
+
+`curl -fsSL https://paigy.ai/uninstall.sh | sh` removes the harness surface (service,
+global package, workspace list, the machine's Desktop slot — other agents' slots
+survive). Then revoke the machine on the phone's Agents screen: server-side tokens
+outlive local files.
+
+The FULL Paigy strip (tested 2026-08-03) additionally removes, in order: every
+`~/.paigy` slot (unpairs ALL local agents — re-pairing resets voices), the ACP
+adapters (`npm rm -g @agentclientprotocol/{claude-agent-acp,codex-acp}`), Electron
+userData, the statusline block + `paigy@paigy` plugin enablement + marketplace +
+`mcp__paigy__*` permission entries in `~/.claude/settings.json`, the project
+`.mcp.json` paigy server, the plugin cache/registry entries, and `~/.npm/_npx` (so
+`@paigy/mcp@latest` can't serve stale). Hooks can recreate `~/.paigy` — delete it
+LAST, after the hooks are gone.
+
 ## Known gaps (#804)
 
 - **Protocol churn is the standing risk.** Neither `stream-json` nor ACP adapter

package/dist/cli.js

@@ -30857,7 +30857,7 @@ async function setTaskState(notificationId, state, opts = {}) {
 // src/cli.ts
 var import_qrcode = __toESM(require_lib(), 1);
 import { hostname } from "os";
-import { writeFileSync as writeFileSync3, mkdirSync as mkdirSync3 } from "fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
 import { execSync } from "child_process";
 import { homedir as homedir5 } from "os";
 import { join as join4 } from "path";
@@ -31729,9 +31729,10 @@ async function drainInput(state, deps = {}) {
     return [];
   }
   const ours = (parentId) => state.exclusive || parentId === state.parentId;
+  const claimable = (notificationId) => !state.sharedWithAgent || (state.mine?.has(notificationId) ?? false);
   const mine = [
-    ...work.replies.filter((r) => ours(r.parentId)).map((r) => ({ notificationId: r.notificationId, parentId: r.parentId, answer: r.answer })),
-    ...work.requests.filter((r) => ours(r.parentId)).map((r) => ({ notificationId: r.notificationId, parentId: r.parentId, answer: { kind: "text", text: r.text } }))
+    ...work.replies.filter((r) => ours(r.parentId) && claimable(r.notificationId)).map((r) => ({ notificationId: r.notificationId, parentId: r.parentId, answer: r.answer })),
+    ...work.requests.filter((r) => ours(r.parentId) && claimable(r.notificationId)).map((r) => ({ notificationId: r.notificationId, parentId: r.parentId, answer: { kind: "text", text: r.text } }))
   ];
   const claimed = [];
   for (const item of mine) {
@@ -31881,6 +31882,7 @@ async function mirror(event, state, deps = {}) {
   try {
     const req = NotifyRequestSchema2.parse(entry);
     const { notificationId, parentId } = await (deps.submit ?? submitNotification)(req);
+    (state.mine ??= /* @__PURE__ */ new Set()).add(notificationId);
     return { parentId, notificationId };
   } catch {
     return {};
@@ -31895,6 +31897,7 @@ async function askPermission(event, state, deps = {}) {
   if (!entry) return { decision: { allow: false, reason: "Could not ask" } };
   try {
     const sent = await (deps.submit ?? submitNotification)(NotifyRequestSchema2.parse(entry));
+    (state.mine ??= /* @__PURE__ */ new Set()).add(sent.notificationId);
     const answer = await awaitAnswer(state, sent.notificationId);
     return { decision: decisionFrom(answer), parentId: sent.parentId };
   } catch (e) {
@@ -31913,6 +31916,7 @@ async function askQuestion(question, state, deps = {}) {
   };
   try {
     const sent = await (deps.submit ?? submitNotification)(NotifyRequestSchema2.parse(entry));
+    (state.mine ??= /* @__PURE__ */ new Set()).add(sent.notificationId);
     return spokenText(await awaitAnswer(state, sent.notificationId));
   } catch {
     return null;
@@ -31965,15 +31969,17 @@ function optionFor(options, decision) {
   return options.find((o) => o.kind === want)?.optionId ?? null;
 }
 function createAcpDriver(opts) {
-  return new AcpDriver(opts.cwd, opts.mode);
+  return new AcpDriver(opts.cwd, opts.mode, opts.mcp ?? []);
 }
 var AcpDriver = class {
-  constructor(cwd, mode) {
+  constructor(cwd, mode, mcp = []) {
     this.cwd = cwd;
     this.mode = mode;
+    this.mcp = mcp;
   }
   cwd;
   mode;
+  mcp;
   nextId = 1;
   initId;
   sessionNewId;
@@ -32049,7 +32055,7 @@ var AcpDriver = class {
       this.sessionNewId = this.nextId++;
       return {
         events: [],
-        writes: [frame({ id: this.sessionNewId, method: "session/new", params: { cwd: this.cwd, mcpServers: [] } })]
+        writes: [frame({ id: this.sessionNewId, method: "session/new", params: { cwd: this.cwd, mcpServers: this.mcp } })]
       };
     }
     if (msg.id === this.sessionNewId) {
@@ -32198,7 +32204,7 @@ function startSession(opts) {
     opts.onEvent({ kind: "idle", failed: code !== 0, ...code ? { result: `exited ${code}` } : {} });
   });
   child.on("error", (e) => opts.onEvent({ kind: "error", message: e.message }));
-  const driver = createAcpDriver({ cwd, mode: opts.mode });
+  const driver = createAcpDriver({ cwd, mode: opts.mode, ...opts.mcp ? { mcp: opts.mcp } : {} });
   let buffer = "";
   child.stdout?.on("data", (chunk) => {
     const { lines, rest } = splitLines(buffer, String(chunk));
@@ -32273,10 +32279,13 @@ function runHarness(opts) {
       }
     }
   }
+  const paigyMcp = opts.exclusive && opts.token ? [{ name: "paigy", command: "npx", args: ["-y", "@paigy/mcp@latest"], env: { PAIGY_TOKEN: opts.token } }] : void 0;
+  if (paigyMcp) state.sharedWithAgent = true;
   session = startSession({
     harness: opts.harness,
     cwd: opts.cwd,
     mode: opts.mode,
+    ...paigyMcp ? { mcp: paigyMcp } : {},
     ...opts.bin ? { bin: opts.bin } : {},
     onEvent: (event) => void handle(event).catch((err) => opts.log(`\u26A0 ${err.message}`))
   });
@@ -32377,7 +32386,7 @@ function startHost(opts) {
 
 // src/cli.ts
 function parseArgs(argv) {
-  const args = { harness: "claude", mode: "bypass", cwd: process.cwd(), doctor: false, host: false, pair: false, service: false, grant: [], hatch: null, identity: null, graceSeconds: 90, prompt: "" };
+  const args = { harness: "claude", mode: "bypass", cwd: process.cwd(), doctor: false, host: false, pair: false, service: false, setup: false, grant: [], hatch: null, voice: null, slot: null, identity: null, graceSeconds: 90, prompt: "" };
   const words = [];
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
@@ -32404,6 +32413,8 @@ function parseArgs(argv) {
       args.host = true;
     } else if (arg === "pair") {
       args.pair = true;
+    } else if (arg === "setup") {
+      args.setup = true;
     } else if (arg === "service") {
       args.service = true;
     } else if (arg === "--grant") {
@@ -32414,6 +32425,10 @@ function parseArgs(argv) {
       const v = next();
       if (!v) return { error: 'hatch needs a name: paigy-harness hatch "Voice bug hunter"' };
       args.hatch = v;
+    } else if (arg === "--voice") {
+      args.voice = next() ?? null;
+    } else if (arg === "--slot") {
+      args.slot = next() ?? null;
     } else if (arg === "--identity") {
       const v = next();
       if (!v) return { error: "--identity needs a hatched agent's name" };
@@ -32425,7 +32440,7 @@ function parseArgs(argv) {
     }
   }
   args.prompt = words.join(" ");
-  if (!args.doctor && !args.hatch && !args.host && !args.pair && !args.service && !args.prompt) return { error: "a prompt is required (or --doctor / pair / host / service / hatch NAME)" };
+  if (!args.doctor && !args.hatch && !args.host && !args.pair && !args.service && !args.setup && !args.prompt) return { error: "a prompt is required (or setup / --doctor / pair / host / service / hatch NAME)" };
   return args;
 }
 var STATUS_MARK = { ready: "\u2713", login: "\u25D0", "adapter-missing": "\u25D0", missing: "\u2717" };
@@ -32433,7 +32448,7 @@ async function main() {
   const parsed = parseArgs(process.argv.slice(2));
   if ("error" in parsed) {
     console.error(`paigy-harness: ${parsed.error}`);
-    console.error("usage: paigy-harness pair | host [--grant DIR]\u2026 | service | hatch NAME | [--harness claude|codex] [--mode bypass|ask] [--cwd DIR] [--identity NAME] [--grace SECONDS] [--doctor] PROMPT\u2026");
+    console.error("usage: paigy-harness setup | pair | host [--grant DIR]\u2026 | service | hatch NAME [--voice KEY] [--slot SLOT] | [--harness claude|codex] [--mode bypass|ask] [--cwd DIR] [--identity NAME] [--grace SECONDS] [--doctor] PROMPT\u2026");
     process.exit(2);
   }
   if (parsed.doctor) {
@@ -32443,6 +32458,91 @@ async function main() {
     }
     return;
   }
+  if (parsed.setup) {
+    if (!readToken("Desktop")) {
+      const code = await requestCode(hostname().replace(/\.local$/, ""));
+      console.log(await import_qrcode.default.toString(code.verification_uri_complete, { type: "terminal", small: true }));
+      console.log(`Scan with your phone's camera, or enter code ${code.user_code} at ${code.verification_uri}`);
+      const deadline = Date.now() + code.expires_in * 1e3;
+      let paired = false;
+      while (!paired && Date.now() < deadline) {
+        const token = await pollToken(code.device_code).catch(() => null);
+        if (token) {
+          saveToken(token, "Desktop");
+          console.log(`\u2713 paired as "${token.name}"`);
+          paired = true;
+        } else await sleep(code.interval * 1e3);
+      }
+      if (!paired) {
+        console.error("Pairing code expired \u2014 run `paigy-harness setup` again.");
+        process.exit(1);
+      }
+    } else console.log("\u2713 already paired as this machine");
+    for (const a of detectAll()) {
+      if (a.status === "adapter-missing" && a.install) {
+        console.log(`\u2192 installing the ${a.label} bridge\u2026`);
+        try {
+          execSync(a.install, { stdio: "inherit", shell: "/bin/sh" });
+        } catch {
+          console.log(`  couldn't install \u2014 later: ${a.install}`);
+        }
+      } else if (a.status === "missing") console.log(`\u2717 ${a.label} CLI not installed \u2014 ${a.hint ?? ""}`);
+      else if (a.status === "login") console.log(`\u25D0 ${a.label}: ${a.hint ?? "sign in"}`);
+      else console.log(`\u2713 ${a.label} ready`);
+    }
+    const wsDeps = { file: workspacesFile() };
+    for (const dir of parsed.grant) addWorkspace(dir, wsDeps);
+    if (!listWorkspaces(wsDeps).length) {
+      const guess = join4(homedir5(), "projects");
+      if (existsSync5(guess)) {
+        addWorkspace(guess, wsDeps);
+        console.log(`\u2713 workspace granted: ${guess} (change with --grant DIR)`);
+      } else console.log("no workspace granted yet \u2014 grant one with: paigy-harness host --grant DIR");
+    }
+    if (process.platform === "darwin") {
+      try {
+        execSync(`${JSON.stringify(process.execPath)} ${JSON.stringify(process.argv[1])} service`, { stdio: "inherit", shell: "/bin/sh" });
+      } catch {
+        console.log("service install failed \u2014 run `paigy-harness host` to host in the foreground");
+      }
+    } else console.log("start hosting with: paigy-harness host   (keep it running under your init system)");
+    const TERMINAL_AGENTS = [
+      { cli: "claude", name: "Claude Code", slot: "mcp-agent", wire: "claude mcp add --scope user paigy -- npx -y @paigy/mcp@latest" },
+      { cli: "codex", name: "Codex", slot: "codex", wire: "codex mcp add paigy -- npx -y @paigy/mcp@latest" },
+      { cli: "antigravity", name: "Antigravity", slot: "antigravity" }
+    ];
+    for (const t of TERMINAL_AGENTS) {
+      try {
+        if (!which(t.cli) || readToken(t.slot)) continue;
+        const minted = await hatch(t.name, null);
+        saveToken({ access_token: minted.token, name: minted.name, device: null }, t.slot);
+        console.log(`\u2713 hatched "${minted.name}" for ${t.cli} sessions (name/voice it on the phone)`);
+        if (t.wire) {
+          try {
+            execSync(t.wire, { stdio: "ignore", shell: "/bin/sh" });
+            console.log(`\u2713 paigy MCP registered for ${t.cli} (restart open sessions)`);
+          } catch {
+          }
+        }
+      } catch {
+      }
+    }
+    try {
+      const settings = join4(homedir5(), ".claude", "settings.json");
+      if (which("claude") && existsSync5(settings)) {
+        const cfg = JSON.parse(readFileSync3(settings, "utf8"));
+        if (!cfg["statusLine"]) {
+          cfg["statusLine"] = { type: "command", command: "npx -y -p @paigy/mcp@latest paigy-statusline" };
+          writeFileSync3(settings, JSON.stringify(cfg, null, 2));
+          console.log("\u2713 statusline wired");
+        }
+      }
+    } catch {
+    }
+    console.log("\n\u2705 Done \u2014 look at your phone: Agents shows this machine with a green dot,");
+    console.log("   and \u201C+ New session\u201D launches agents on it.");
+    return;
+  }
   if (parsed.pair) {
     if (readToken("Desktop")) {
       console.log("\u2713 already paired as this machine");
@@ -32499,8 +32599,8 @@ async function main() {
     process.exit(1);
   }
   if (parsed.hatch) {
-    const minted = await hatch(parsed.hatch);
-    saveToken({ access_token: minted.token, name: minted.name, device: null }, minted.name);
+    const minted = await hatch(parsed.hatch, parsed.voice ?? null);
+    saveToken({ access_token: minted.token, name: minted.name, device: null }, parsed.slot ?? minted.name);
     console.log(`\u2713 hatched "${minted.name}" \u2014 it's on your phone's Agents screen now.`);
     console.log(`  speak as it:  PAIGY_AGENT="${minted.name}" <any paigy tool>`);
     console.log(`  run with it:  paigy-harness --identity "${minted.name}" --harness codex "\u2026"`);

package/dist/main.js

@@ -12386,15 +12386,17 @@ function optionFor(options, decision) {
   return options.find((o) => o.kind === want)?.optionId ?? null;
 }
 function createAcpDriver(opts) {
-  return new AcpDriver(opts.cwd, opts.mode);
+  return new AcpDriver(opts.cwd, opts.mode, opts.mcp ?? []);
 }
 var AcpDriver = class {
-  constructor(cwd, mode) {
+  constructor(cwd, mode, mcp = []) {
     this.cwd = cwd;
     this.mode = mode;
+    this.mcp = mcp;
   }
   cwd;
   mode;
+  mcp;
   nextId = 1;
   initId;
   sessionNewId;
@@ -12470,7 +12472,7 @@ var AcpDriver = class {
       this.sessionNewId = this.nextId++;
       return {
         events: [],
-        writes: [frame({ id: this.sessionNewId, method: "session/new", params: { cwd: this.cwd, mcpServers: [] } })]
+        writes: [frame({ id: this.sessionNewId, method: "session/new", params: { cwd: this.cwd, mcpServers: this.mcp } })]
       };
     }
     if (msg.id === this.sessionNewId) {
@@ -12619,7 +12621,7 @@ function startSession(opts) {
     opts.onEvent({ kind: "idle", failed: code !== 0, ...code ? { result: `exited ${code}` } : {} });
   });
   child.on("error", (e) => opts.onEvent({ kind: "error", message: e.message }));
-  const driver = createAcpDriver({ cwd, mode: opts.mode });
+  const driver = createAcpDriver({ cwd, mode: opts.mode, ...opts.mcp ? { mcp: opts.mcp } : {} });
   let buffer = "";
   child.stdout?.on("data", (chunk) => {
     const { lines, rest } = splitLines(buffer, String(chunk));
@@ -13512,9 +13514,10 @@ async function drainInput(state, deps = {}) {
     return [];
   }
   const ours = (parentId) => state.exclusive || parentId === state.parentId;
+  const claimable = (notificationId) => !state.sharedWithAgent || (state.mine?.has(notificationId) ?? false);
   const mine = [
-    ...work.replies.filter((r) => ours(r.parentId)).map((r) => ({ notificationId: r.notificationId, parentId: r.parentId, answer: r.answer })),
-    ...work.requests.filter((r) => ours(r.parentId)).map((r) => ({ notificationId: r.notificationId, parentId: r.parentId, answer: { kind: "text", text: r.text } }))
+    ...work.replies.filter((r) => ours(r.parentId) && claimable(r.notificationId)).map((r) => ({ notificationId: r.notificationId, parentId: r.parentId, answer: r.answer })),
+    ...work.requests.filter((r) => ours(r.parentId) && claimable(r.notificationId)).map((r) => ({ notificationId: r.notificationId, parentId: r.parentId, answer: { kind: "text", text: r.text } }))
   ];
   const claimed = [];
   for (const item of mine) {
@@ -13664,6 +13667,7 @@ async function mirror(event, state, deps = {}) {
   try {
     const req = NotifyRequestSchema2.parse(entry);
     const { notificationId, parentId } = await (deps.submit ?? submitNotification)(req);
+    (state.mine ??= /* @__PURE__ */ new Set()).add(notificationId);
     return { parentId, notificationId };
   } catch {
     return {};
@@ -13678,6 +13682,7 @@ async function askPermission(event, state, deps = {}) {
   if (!entry) return { decision: { allow: false, reason: "Could not ask" } };
   try {
     const sent = await (deps.submit ?? submitNotification)(NotifyRequestSchema2.parse(entry));
+    (state.mine ??= /* @__PURE__ */ new Set()).add(sent.notificationId);
     const answer = await awaitAnswer(state, sent.notificationId);
     return { decision: decisionFrom(answer), parentId: sent.parentId };
   } catch (e) {
@@ -13696,6 +13701,7 @@ async function askQuestion(question, state, deps = {}) {
   };
   try {
     const sent = await (deps.submit ?? submitNotification)(NotifyRequestSchema2.parse(entry));
+    (state.mine ??= /* @__PURE__ */ new Set()).add(sent.notificationId);
     return spokenText(await awaitAnswer(state, sent.notificationId));
   } catch {
     return null;
@@ -13773,10 +13779,13 @@ function runHarness(opts) {
       }
     }
   }
+  const paigyMcp = opts.exclusive && opts.token ? [{ name: "paigy", command: "npx", args: ["-y", "@paigy/mcp@latest"], env: { PAIGY_TOKEN: opts.token } }] : void 0;
+  if (paigyMcp) state.sharedWithAgent = true;
   session = startSession({
     harness: opts.harness,
     cwd: opts.cwd,
     mode: opts.mode,
+    ...paigyMcp ? { mcp: paigyMcp } : {},
     ...opts.bin ? { bin: opts.bin } : {},
     onEvent: (event) => void handle(event).catch((err) => opts.log(`\u26A0 ${err.message}`))
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paigy/harness",
-  "version": "0.1.1",
+  "version": "0.1.5",
   "description": "Run Claude Code / Codex on this machine, bridged to Paigy — launchable from your phone.",
   "license": "MIT",
   "type": "module",