@comment-io/cli 0.1.10-alpha.260 → 0.1.10-alpha.263

package/mcp/comment-mcp.mjs

@@ -27684,6 +27684,7 @@ function buildCompleteAgentDocs(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\` and no document is created. The title is derived from the first non-empty markdown line.`,
     ``,
     `\`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","parentFolderId":"lf_..."}\` to create in the calling Botlets bot's brain, or add \`"botSlug":"research"\` when using the human owner's session. Unknown target kinds return \`422 INVALID_KIND\`; invalid or deleted parent folders return \`422 INVALID_PARENT\`; another user's workspace or bot returns \`403 NOT_AUTHORIZED\`.`,
+    `To create the \`lf_...\` folder you pass as \`parentFolderId\`, call \`POST /docs/folders\` with \`{"name":"User Feedback","library_target":{...}}\`, where \`library_target\` uses the same \`personal\`/\`team\`/\`bot\` arms (the \`default\` kind is not accepted). Omit \`parentFolderId\` to create at the container root, or pass another folder's id to nest. It returns \`{"ok":true,"node":{"id":"lf_...",...}}\` (201, or 200 if an identical folder already exists). Then create or file documents with that \`node.id\` as \`library_target.parentFolderId\`. Authorization matches \`POST /docs\`: an owned agent (or signed-in human) for \`personal\`/\`team\`, the bot itself for \`bot\`.`,
     `If document creation succeeds but library placement needs asynchronous repair, the API returns \`202\` with the normal create response plus \`library_repair.repair_id\`. \`library_repair.state\` is \`repair_needed\` when the repair was durably queued, or \`repair_enqueue_failed\` when the document exists but automatic library repair could not be queued. Use the returned \`access_token\` and do not retry-create the document.`,
     ``,
     `Registered agents may include \`Authorization: Bearer {agent_secret}\` to create under their permanent handle. Without an agent secret, the response includes a per-doc \`access_token\`; use that token as your identity for this doc. Response (201):`,
@@ -28170,6 +28171,8 @@ 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.`,
     ``,
+    `\`library_target\` places the new comm: \`{"kind":"personal","parentFolderId":"lf_..."}\` for My Files, \`{"kind":"team","parentFolderId":"lf_..."}\` for Team Wiki, \`{"kind":"bot","parentFolderId":"lf_..."}\` for the calling Botlets bot's brain. 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\`.`,
     ``,
     `When sharing a comm with a user, always use \`share_url\` with the base URL prepended: \`${baseUrl}\` + \`share_url\`. Never share a bare \`/d/{id}\` link.`,

package/package.json

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