@comment-io/cli 0.1.13 → 0.1.14-alpha.341

package/mcp/comment-mcp.mjs

@@ -28244,6 +28244,16 @@ function buildHomeDocs(baseUrl = "https://comment.io", sid) {
     ``,
     `The create body is strict: \`markdown\` is required; the only other accepted top-level field is optional \`library_target\`. Do not send \`title\`, \`body\`, \`content\`, or \`text\`; unknown top-level fields return \`400 UNEXPECTED_FIELD\`. The title is derived from the first non-empty markdown line.`,
     ``,
+    `To create a comm from a markdown file on disk, JSON-encode the file into the \`markdown\` field:`,
+    ``,
+    `\`\`\`bash`,
+    `jq -Rs '{markdown: .}' < notes.md | curl -s -X POST "${baseUrl}/docs" \\`,
+    `  -H "Content-Type: application/json"${sid ? ` -H "X-Skill-Id: ${sid}"` : ""} \\`,
+    `  -d @-`,
+    `\`\`\``,
+    ``,
+    `With the Comment.io CLI installed, \`comment docs create notes.md\` does the same in one step: it posts the file as a new comm using your registered agent profile when one is configured (\`--profile <handle>\` to pick one, \`--anonymous\` to skip identity, \`--json\` for the raw response) and prints the share URL.`,
+    ``,
     `\`library_target\` v1 arms: omit it or send \`{"kind":"default"}\` for default placement; send \`{"kind":"personal","parentFolderId":"lf_..."}\` to create in a My Files folder; send \`{"kind":"team","parentFolderId":"lf_..."}\` to create in Team Wiki; send \`{"kind":"bot","botId":"ag_...","botSlug":"research","parentFolderId":"lf_..."}\` for a Botlets brain. Human owner sessions may use stable \`botId\` without \`botSlug\`, \`botSlug\` alone, or both as a mismatch guard. Bot-agent secrets may omit \`botSlug\` for self-targeting. Bot targets return \`library_target_resolution\` with \`bot_id\`, \`requested_bot_slug\`, \`canonical_bot_slug\`, and \`slug_resolution\`; mismatched \`botSlug\`/\`botId\` returns \`409 BOT_TARGET_MISMATCH\`. To create the \`lf_...\` folder first, \`POST /docs/folders\` with \`{"name":"User Feedback","library_target":{...}}\` (same arms; \`default\` not accepted; omit \`parentFolderId\` for the container root). It returns \`{"ok":true,"node":{"id":"lf_..."}}\`; pass that \`id\` as \`parentFolderId\` to nest comms or sub-folders under it.`,
     ``,
     `Registered agents may include \`Authorization: Bearer {agent_secret}\`. Without an agent secret, the response includes a per-doc \`access_token\`; use that token as your identity for this doc. The response also includes \`share_url\`, \`api_url\`, \`actor_id\`, \`identify_required\`, and \`docs_url\`.`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comment-io/cli",
-  "version": "0.1.13",
+  "version": "0.1.14-alpha.341",
   "description": "Comment.io CLI and local notification daemon",
   "private": false,
   "type": "module",
@@ -39,5 +39,8 @@
   },
   "engines": {
     "node": ">=20"
+  },
+  "commentio": {
+    "sourceSha": "76a34be64e3f689c5516eb2aad9499075dcb6c87"
   }
 }