patchcord 0.3.87 → 0.3.89

package/bin/patchcord.mjs

@@ -559,22 +559,8 @@ if (!cmd || cmd === "install" || cmd === "agent" || cmd === "--token" || cmd ===
       console.log(`  ${green}✓${r} ${bold}${identity}${r} connected.`);
 
       if (!choice) {
-        // Backend didn't send tool type — ask in terminal
-        const { createInterface: createRL3 } = await import("readline");
-        const rl3 = createRL3({ input: process.stdin, output: process.stdout });
-        const ask3 = (q) => new Promise((resolve) => rl3.question(q, resolve));
-        console.log(`\n${bold}Which tool are you setting up?${r}\n`);
-        console.log(`  ${cyan}1.${r} Claude Code   ${cyan}5.${r} Gemini CLI`);
-        console.log(`  ${cyan}2.${r} Codex CLI     ${cyan}6.${r} VS Code`);
-        console.log(`  ${cyan}3.${r} Cursor        ${cyan}7.${r} Zed`);
-        console.log(`  ${cyan}4.${r} Windsurf      ${cyan}8.${r} OpenCode`);
-        console.log(`                    ${cyan}9.${r} OpenClaw\n`);
-        choice = (await ask3(`${dim}Choose (1-9):${r} `)).trim();
-        rl3.close();
-        if (!["1","2","3","4","5","6","7","8","9"].includes(choice)) {
-          console.error("Invalid choice.");
-          process.exit(1);
-        }
+        // Web UI didn't send client_type — default to Claude Code
+        choice = "1";
       }
     }
   } // end connect flow
@@ -799,7 +785,7 @@ if (!cmd || cmd === "install" || cmd === "agent" || cmd === "--token" || cmd ===
     const skillDest = join(cwd, ".agents", "skills", "patchcord");
     mkdirSync(skillDest, { recursive: true });
     writeFileSync(join(skillDest, "SKILL.md"),
-      readFileSync(join(pluginRoot, "skills", "codex", "SKILL.md"), "utf-8"));
+      readFileSync(join(pluginRoot, "per-project-skills", "codex", "SKILL.md"), "utf-8"));
     const waitDest = join(cwd, ".agents", "skills", "patchcord-wait");
     mkdirSync(waitDest, { recursive: true });
     writeFileSync(join(waitDest, "SKILL.md"),
@@ -863,7 +849,7 @@ if (!cmd || cmd === "install" || cmd === "agent" || cmd === "--token" || cmd ===
       },
     }, null, 2) + "\n");
     writeFileSync(join(pluginDir, "skills", "patchcord", "SKILL.md"),
-      readFileSync(join(pluginRoot, "skills", "codex", "SKILL.md"), "utf-8"));
+      readFileSync(join(pluginRoot, "per-project-skills", "codex", "SKILL.md"), "utf-8"));
     writeFileSync(join(pluginDir, "skills", "patchcord-wait", "SKILL.md"),
       readFileSync(join(pluginRoot, "skills", "wait", "SKILL.md"), "utf-8"));
 
@@ -887,7 +873,7 @@ if (!cmd || cmd === "install" || cmd === "agent" || cmd === "--token" || cmd ===
     const globalSkillDir = join(homedir(), ".agents", "skills", "patchcord");
     mkdirSync(globalSkillDir, { recursive: true });
     writeFileSync(join(globalSkillDir, "SKILL.md"),
-      readFileSync(join(pluginRoot, "skills", "codex", "SKILL.md"), "utf-8"));
+      readFileSync(join(pluginRoot, "per-project-skills", "codex", "SKILL.md"), "utf-8"));
     const globalWaitDir = join(homedir(), ".agents", "skills", "patchcord-wait");
     mkdirSync(globalWaitDir, { recursive: true });
     writeFileSync(join(globalWaitDir, "SKILL.md"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "patchcord",
-  "version": "0.3.87",
+  "version": "0.3.89",
   "description": "Cross-machine agent messaging for Claude Code and Codex",
   "author": "ppravdin",
   "license": "MIT",
@@ -26,6 +26,7 @@
     "hooks/",
     "scripts/",
     "skills/",
+    "per-project-skills/",
     "commands/",
     "README.md"
   ]

package/{skills → per-project-skills}/codex/SKILL.md

@@ -17,7 +17,7 @@ project's MCP config.
 
 - `inbox(all_agents?)` - read pending messages, current identity, and recently active agents. `all_agents=true` includes inactive agents. Presence tells you whether to wait for a reply after sending, not whether to send.
 - `send_message(to_agent, content)` - send a message. Comma-separated for multiple: `send_message("backend, frontend", "hello")`. Use `@username` for cross-user Gate messaging. Messages support up to 50,000 characters - send full content, specs, and code as-is. Never summarize or truncate.
-- `reply(message_id, content, defer?, resolve?)` - reply to a received message. `defer=true` keeps the original visible in inbox for later (survives context compaction). `resolve=true` signals thread complete, notifies sender no reply needed.
+- `reply(message_id, content?, defer?, resolve?)` - reply to a received message. `defer=true` keeps the original visible in inbox for later (survives context compaction). `resolve=true` marks the message as handled — content is optional, use `reply(message_id, resolve=true)` to silently close a thread without sending anything.
 - `wait_for_message(timeout_seconds?)` - block until incoming message arrives. Default 5 minutes. Known to error intermittently - if it fails, poll inbox() every 10-15 seconds as fallback.
 - `attachment(...)` - upload, download, or relay files between agents (see File sharing below)
 - `recall(limit?, from_agent?)` - view recent message history including already-read messages. `from_agent` filters by sender. For debugging only, not routine use.
@@ -98,7 +98,7 @@ Then send the `path` to the other agent. No base64, no token waste.
 ```
 attachment(upload=true, filename="notes.txt", file_data="<base64>")
 ```
-Never use for files on disk — use presigned upload above instead.
+Base64 adds ~33% overhead and wastes context tokens. Never use this for files on disk — use presigned upload above instead.
 
 **Downloading:**
 ```

package/{skills → per-project-skills}/web/SKILL.md

@@ -13,7 +13,7 @@ You are connected to Patchcord, a message bus that lets you talk to AI agents on
 
 - **inbox(all_agents?)** - read pending messages + recent activity. `all_agents=true` includes inactive agents. Presence tells you whether to wait for a reply, not whether to send. Online = set up wait_for_message after sending. Offline = send and move on, don't wait.
 - **send_message(to_agent, content)** - send a message. Comma-separated for multiple: `send_message("backend, frontend", "hello")`. Supports `@username` for cross-user Gate messaging. Up to 50,000 characters - send full content, never summarize.
-- **reply(message_id, content, defer?, resolve?)** - reply to a received message. `defer=true` keeps message visible in inbox (survives context compaction). `resolve=true` signals conversation complete, notifies sender no reply needed.
+- **reply(message_id, content?, defer?, resolve?)** - reply to a received message. `defer=true` keeps message visible in inbox (survives context compaction). `resolve=true` marks as handled — content is optional, use `reply(message_id, resolve=true)` to silently close a thread.
 - **wait_for_message(timeout_seconds?)** - block until incoming message arrives. Default 300s. Known to error intermittently - if it fails, poll inbox() in a loop as fallback.
 - **attachment(...)** - file operations (see File sharing section below)
 - **recall(limit?, from_agent?)** - view recent message history including already-read messages. Debugging only, not routine use. `from_agent` filters by sender.
@@ -33,9 +33,11 @@ You may be one of several chat sessions sharing the same Patchcord identity. To
 Use the dominant topic of your current conversation as the tag. Keep it short (1-3 words). Be consistent within a session - pick a tag early and reuse it.
 
 **When receiving messages**, check the context tag:
-- If it matches your chat's topic - reply normally
-- If it's clearly for another chat session - reply with: "This seems intended for the [tag] chat. Leaving unread for them." Then use `reply(message_id, "Routed to [tag] chat", defer=true)` so the message stays visible for the right session.
-- If there's no tag or it's ambiguous - handle it normally
+- If it matches your chat's topic — reply normally
+- If it's clearly for another chat session — `reply(message_id, "→ [tag] chat", defer=true)`. Minimal content, no explanation.
+- If there's no tag but the content is addressed to a different role (e.g. "To: claudeai (UI/UX designer)" when you're the scientific supervisor) — treat as wrong-chat. `reply(message_id, "→ other session", defer=true)`. Do not explain your role or what the other session should do.
+- If there's no tag and it's ambiguous — handle it normally
+- When a message has no context tag but is addressed "To: [role]" in the body, the role-line acts as a tag. Route accordingly.
 
 ## Behavioral rules
 
@@ -51,7 +53,7 @@ Use the dominant topic of your current conversation as the tag. Keep it short (1
 
 6. **Never show raw JSON** - summarize naturally.
 
-7. **Do not reply to acks**: "ok", "noted", "seen", "thanks", thumbs up, or conversation-ending signals. Only reply when a question is asked, an action is requested, or a deliverable is expected. Use `resolve=true` on your reply when a thread is done.
+7. **Do not reply to acks**: "ok", "noted", "seen", "thanks", thumbs up, or conversation-ending signals. Only reply when a question is asked, an action is requested, or a deliverable is expected. Use `resolve=true` on your reply when a thread is done. This applies even when an ack is for another session — don't defer-route acks, just leave them alone.
 
 8. **Presence is not a delivery gate**: an agent may receive messages while absent from the online list. Always send regardless of online/offline status. Messages queue and deliver when the recipient checks inbox.
 

package/skills/inbox/SKILL.md

@@ -54,7 +54,8 @@ If send_message fails with a send gate error: call inbox(), reply to or resolve
 2. Do the work described in the message - using your project's actual code, real files, real lines
 3. Reply with what you did, choosing the right flag:
    - `reply(message_id, "done: [details]")` — work done, sender might follow up
-   - `reply(message_id, "done: [details]", resolve=true)` — work done, conversation finished. Notifies the sender.
+   - `reply(message_id, "done: [details]", resolve=true)` — work done, conversation finished
+   - `reply(message_id, resolve=true)` — silently close a thread without sending anything (e.g. clearing misfired messages)
    - `reply(message_id, "ack, prioritizing [other task] first", defer=true)` — you acknowledged but haven't done the work yet. The message stays in your inbox as a reminder.
 4. wait_for_message() if the sender is online - stay responsive for follow-ups
 5. If you can't do the work, say specifically what's blocking you. Don't guess about another agent's code.