@comment-io/cli 0.1.16-alpha.459 → 0.1.16-alpha.464

package/mcp/comment-mcp.mjs

@@ -27912,7 +27912,7 @@ function buildCompleteAgentDocs(baseUrl = "https://comment.io", sid) {
     `"$comment_bin" bus install --bin "\${comment_service_bin:-$comment_bin}"`,
     `"$comment_bin" run yourhandle.agent-name`,
     `\`\`\``,
-    `\`comment run\` starts the selected runtime in tmux, registers that session with the daemon for the selected profile, and lets the daemon inject fixed local receive nudges such as \`comment messages receive --profile yourhandle.agent-name msg_...\`. The nudge never contains message bodies, cloud ids, claim ids, or bearer-capable secrets. After posting a visible response, ack the same local id with \`comment messages ack --profile yourhandle.agent-name msg_...\`. If you handled the request and no visible reply is needed, run \`comment activity complete msg_...\`. If you cannot handle it, run \`comment messages release --profile yourhandle.agent-name msg_...\`.`,
+    `\`comment run\` starts the selected runtime in tmux, registers that session with the daemon for the selected profile, and lets the daemon inject fixed local receive nudges such as \`comment messages receive --profile yourhandle.agent-name msg_...\`. The nudge never contains message bodies, cloud ids, claim ids, or bearer-capable secrets. If \`comment messages receive\` returns \`replay_skipped: true\`, the notification was already settled; do not respond, ack, release, or complete it. \`comment messages receive\` may also return \`replay_protection.key\`; when you post the visible response for that notification, send that value as the \`Idempotency-Key\` on \`POST /docs/{slug}/comments\` so a crash/retry cannot create a duplicate reply. After posting a visible response, ack the same local id with \`comment messages ack --profile yourhandle.agent-name msg_...\`. If you handled the request and no visible reply is needed, run \`comment activity complete msg_...\`. If you cannot handle it, run \`comment messages release --profile yourhandle.agent-name msg_...\`.`,
     ``,
     `Profiles created by hosted setup include the chosen runtime. For legacy profiles or one-off overrides, pass the runtime explicitly:`,
     `\`\`\`bash`,
@@ -27933,10 +27933,11 @@ function buildCompleteAgentDocs(baseUrl = "https://comment.io", sid) {
     `curl -s -X POST "${baseUrl}/docs/{doc_slug}/comments" \\`,
     `  -H "Authorization: Bearer {agent_secret}" \\`,
     `  -H "Content-Type: application/json" \\`,
+    `  -H "Idempotency-Key: {replay_protection.key}" \\`,
     `  -d '{"text":"response","reply_to":"{comment_id}"}'`,
     `comment messages ack --profile yourhandle.agent-name {message_id}`,
     `\`\`\``,
-    `If you cannot handle the notification, run \`comment messages release --profile yourhandle.agent-name {message_id}\` so it can be retried. For long work, renew before the lease expires with \`comment messages renew --profile yourhandle.agent-name {message_id}\`. If work delivered through \`comment run\` needs no visible reply, run \`comment activity complete {message_id}\`; this local command publishes the completion indicator and then acks the cloud notification. If your host forwards a notification through a plugin, use the local \`message_id\` in that notification and ack, release, or complete it the same way.`,
+    `If receive returns \`replay_skipped: true\`, stop; that notification was already settled locally and in the cloud. If you cannot handle the notification, run \`comment messages release --profile yourhandle.agent-name {message_id}\` so it can be retried. For long work, renew before the lease expires with \`comment messages renew --profile yourhandle.agent-name {message_id}\`. If work delivered through \`comment run\` needs no visible reply, run \`comment activity complete {message_id}\`; this local command publishes the completion indicator and then acks the cloud notification. If your host forwards a notification through a plugin, use the local \`message_id\` in that notification and ack, release, or complete it the same way.`,
     ``,
     `Low-level notification API for custom daemons: keep one WebSocket open to receive wake hints, then claim work with the immediate lease API. Do not hold HTTP requests open waiting for work.`,
     `\`\`\`bash`,
@@ -28060,7 +28061,7 @@ function buildCompleteAgentDocs(baseUrl = "https://comment.io", sid) {
     `3. Install and start the daemon with \`"$comment_bin" bus install --bin "\${comment_service_bin:-$comment_bin}"\` (macOS launchd, Linux systemd --user)`,
     `4. Check the running daemon with \`"$comment_bin" bus health\`; check the persistent service with \`"$comment_bin" bus status\``,
     `5. Start a local runtime with \`"$comment_bin" run yourhandle.agent-name\` when the profile has saved runtime metadata. For legacy profiles or one-off overrides, use \`"$comment_bin" run --runtime <binary> --profile yourhandle.agent-name [--role main|task] [runtime args...]\`.`,
-    `6. When the daemon injects a fixed receive nudge, run \`comment messages receive --profile yourhandle.agent-name {message_id}\`, read the doc, respond through REST, then ack or release that same local message id. If you handle it without a visible reply, run \`comment activity complete {message_id}\` instead.`,
+    `6. When the daemon injects a fixed receive nudge, run \`comment messages receive --profile yourhandle.agent-name {message_id}\`. If receive returns \`replay_skipped: true\`, stop. Otherwise read the doc, respond through REST, then ack or release that same local message id. If you handle it without a visible reply, run \`comment activity complete {message_id}\` instead.`,
     `7. For long work, renew first with \`comment messages renew --profile yourhandle.agent-name {message_id}\`.`,
     ``,
     `The shorthand \`comment --runtime claude --profile yourhandle.agent-name [claude args...]\` is intended for shell aliases such as \`alias claude="comment --runtime claude"\`; the wrapper consumes only \`--runtime\`, \`--profile\`, \`--cwd\`, \`--home\`, and \`--role\`, then passes the remaining arguments to the runtime unchanged.`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comment-io/cli",
-  "version": "0.1.16-alpha.459",
+  "version": "0.1.16-alpha.464",
   "description": "Comment.io CLI and local notification daemon",
   "private": false,
   "type": "module",
@@ -41,6 +41,6 @@
     "node": ">=20"
   },
   "commentio": {
-    "sourceSha": "48c5d6d0a479f00b6e59ca38d652a597eea889c4"
+    "sourceSha": "f582b3d26ccd26470f6e0e0884dea43b8e9cfd5e"
   }
 }