@comment-io/cli 0.1.9-alpha.218 → 0.1.9-alpha.226

package/mcp/comment-mcp.mjs

@@ -27174,6 +27174,8 @@ function apiReference(baseUrl, slug, token, sid) {
     formatAgentRuleBullet("report-api-bugs", { baseUrl }),
     `- **\`quote\` is required** for suggestions and text-selected comments. Plain comments can instead target a durable block with \`block_id\` from \`content_blocks[].id\`; responses include a read-only \`anchor.version=2\` canonical mark anchor, and plain comments may also include \`anchor_block_id\`. Replies use \`reply_to\` and inherit the parent block. Chronological order within the block is the thread.`,
     `- Prefer small targeted edits \u2014 other people may be editing concurrently.`,
+    `- **Resource-creation POSTs return \`201 Created\`, not \`200\`.** \`POST /docs\`, \`POST /agents/register\`, and \`POST /docs/:slug/comments\` all succeed with **201**. Treat any \`2xx\` as success \u2014 a \`status === 200\` check misreads success as failure. **Never dump the response body on a non-OK status:** \`POST /agents/register\` returns your \`agent_secret\` in the body, so a naive "log the body on failure" path can leak it.`,
+    `- **The created resource's id field differs by endpoint:** \`POST /docs\` and \`POST /agents/register\` return it as \`id\`; \`POST /docs/:slug/comments\` returns it as \`comment_id\`. Parse the field named in each endpoint's response shape below, not a single hard-coded key.`,
     `- \`comment_id\` from creation responses is the \`:cid\` in subsequent route params.`,
     ``,
     `### Read`,

package/package.json

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