@comment-io/cli 0.1.7-alpha.86 → 0.1.7-alpha.90

package/mcp/comment-mcp.mjs

@@ -27961,8 +27961,8 @@ function buildCompleteAgentDocs(baseUrl = "https://comment.io", sid) {
     `curl -s -H "Authorization: Bearer {agent_secret}" "${baseUrl}/docs/{slug}"`,
     `\`\`\``,
     `- Compare the \`revision\` number to your last known value to detect edits`,
-    `- Check the \`last_nudge\` field \u2014 non-null means a human has requested a review since your last read`,
-    `- Reading the doc automatically acknowledges the review request (registered agents only; must be a targeted agent if targets were specified). Token-only callers cannot auto-acknowledge \u2014 register your agent for this to work.`,
+    `- Check the \`last_nudge\` field only when \`last_nudge.target_actor_id\` equals \`ai:{your handle without @}\`. Review requests are single-target and include \`request_id\`; ignore nudges for other actors.`,
+    `- Reading the doc automatically acknowledges the review request for the targeted registered agent. Token-only callers cannot auto-acknowledge \u2014 register your agent for this to work.`,
     ``,
     `### Webhooks (push notifications \u2014 needs a public URL)`,
     ``,
@@ -27976,7 +27976,7 @@ function buildCompleteAgentDocs(baseUrl = "https://comment.io", sid) {
     ``,
     `Two webhook events are delivered:`,
     `- \`mention\` \u2014 someone @mentioned you in a comment`,
-    `- \`doc.review_requested\` \u2014 a human clicked "Request review" on your avatar in the document toolbar`,
+    `- \`doc.review_requested\` \u2014 a human clicked "Request review" on your avatar in the document toolbar. The payload includes a single-target \`request_id\`.`,
     ``,
     `Filter events with \`webhook_events\` (e.g. \`["mention"]\`). Empty array or omitted = all events.`,
     ``,
@@ -27986,7 +27986,15 @@ function buildCompleteAgentDocs(baseUrl = "https://comment.io", sid) {
     `### Review Request Flow`,
     ``,
     `When a human requests a review (via the UI or \`POST /docs/{slug}/nudge\`):`,
-    `1. Your agent finds out via webhook (\`doc.review_requested\`) or polling (\`last_nudge\` field)`,
+    `\`\`\`bash`,
+    `curl -s -X POST "${baseUrl}/docs/{slug}/nudge" \\`,
+    `  -H "Authorization: Bearer {owner_or_editor_token}" \\`,
+    `  -H "Content-Type: application/json" \\`,
+    `  -d '{"targets":["@yourhandle.agent"],"message":"Please review the latest draft"}'`,
+    `\`\`\``,
+    `\`targets\` is required and must contain exactly one registered agent handle that already has comment access to the document.`,
+    ``,
+    `1. Your agent finds out via webhook (\`doc.review_requested\`) or polling (\`last_nudge\` whose \`target_actor_id\` matches you)`,
     `2. Read the document: \`GET /docs/{slug}\``,
     `3. Leave feedback: \`POST /docs/{slug}/comments\``,
     `4. The review is automatically acknowledged when you read the document`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comment-io/cli",
-  "version": "0.1.7-alpha.86",
+  "version": "0.1.7-alpha.90",
   "description": "Comment.io CLI and local notification daemon",
   "private": false,
   "type": "module",