@p11-core/cli 0.0.16 → 0.0.17

package/dist/index.js

@@ -3699,6 +3699,22 @@ Environment:
     );
   });
   allowLegacyParserBehavior(commentsCommand);
+  const replyCommand = program2.command("reply").description("Reply to a comment on a read URL or id.").argument("[readUrl|readId]").argument("[commentId]").option("--name [name]", "Reply author name. Defaults to AI Agent.").option("--body [text]", "Plain-text reply body. Newlines are preserved.").option("--body-file [file]", "Read plain-text reply body from a file, or '-' for stdin.").option("--json", "Print the API response as JSON.").option("--version [n]", "Reply on a specific page version.").option("--api-url [url]", "Override the p11 API URL.").action(async (target, commentId, options2) => {
+    await runCliAction(
+      "reply",
+      {
+        has_target: Boolean(target),
+        has_comment_id: Boolean(commentId),
+        json: Boolean(options2.json),
+        body: typeof options2.body === "string",
+        body_file: typeof options2.bodyFile === "string",
+        version: typeof options2.version === "string",
+        api_url_override: typeof options2.apiUrl === "string"
+      },
+      () => reply(target, commentId, normalizeReplyOptions(options2))
+    );
+  });
+  allowLegacyParserBehavior(replyCommand);
   const deleteCommand = program2.command("delete").description("Delete a document and all of its versions and comments.").argument("[editUrl|editId]").option("--json", "Print the API response as JSON.").option("--api-url [url]", "Override the p11 API URL.").action(async (target, options2) => {
     await runCliAction(
       "delete",
@@ -3791,6 +3807,16 @@ function normalizeCommentsOptions(options) {
     apiUrl: optionString(options.apiUrl, "--api-url requires a URL.")
   };
 }
+function normalizeReplyOptions(options) {
+  return {
+    json: options.json,
+    name: optionString(options.name, "--name requires a value."),
+    body: optionString(options.body, "--body requires reply text."),
+    bodyFile: optionString(options.bodyFile, "--body-file requires a file path or '-'."),
+    version: optionString(options.version, "--version requires a positive integer."),
+    apiUrl: optionString(options.apiUrl, "--api-url requires a URL.")
+  };
+}
 function normalizeDeleteOptions(options) {
   return {
     json: options.json,
@@ -3938,6 +3964,57 @@ async function comments(target, options) {
     printComments(data);
   }
 }
+async function reply(target, commentId, options) {
+  if (!target || !commentId) {
+    throw new Error("Usage: p11 reply <readUrl|readId> <commentId> --body TEXT [--name NAME] [--json] [--version N]");
+  }
+  validateCommentId(commentId);
+  const body = await replyBody(options);
+  if (!body.trim()) throw new Error("Reply body is required. Use --body TEXT or --body-file FILE.");
+  const version = options.version === void 0 ? void 0 : parseVersionFlag(String(options.version));
+  const url = replyApiUrlForTarget(target, {
+    apiUrl: options.apiUrl,
+    version
+  });
+  const response = await fetchForOperation("Reply", url, {
+    method: "POST",
+    headers: {
+      "content-type": "application/json"
+    },
+    body: JSON.stringify({
+      name: options.name ?? "AI Agent",
+      body,
+      parentId: commentId
+    })
+  });
+  const text = await response.text();
+  if (!response.ok) {
+    throw new Error(`Reply failed (${response.status}): ${responseErrorMessage(text)}`);
+  }
+  const data = JSON.parse(text);
+  if (options.json) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  console.log(`Replied ${data.comment?.id ?? "comment"}`);
+  if (data.comment?.parentId) console.log(`parentId: ${data.comment.parentId}`);
+  if (data.comment?.createdAt) console.log(`createdAt: ${data.comment.createdAt}`);
+}
+async function replyBody(options) {
+  if (options.body !== void 0 && options.bodyFile !== void 0) {
+    throw new Error("Use either --body or --body-file, not both.");
+  }
+  if (options.body !== void 0) return options.body;
+  if (options.bodyFile === "-") return readStdin();
+  if (options.bodyFile !== void 0) return readFile(path.resolve(options.bodyFile), "utf8");
+  return "";
+}
+async function readStdin() {
+  let body = "";
+  process.stdin.setEncoding("utf8");
+  for await (const chunk of process.stdin) body += chunk;
+  return body;
+}
 async function deleteDocument(target, options) {
   if (!target) {
     throw new Error("Usage: p11 delete <editUrl|editId> [--json] [--api-url URL]");
@@ -4270,10 +4347,10 @@ function printComments(data) {
     console.log(`[${comment.createdAt}]${target}${resolved} ${comment.name}`);
     if (comment.quote) console.log(`> ${comment.quote}`);
     console.log(comment.body);
-    for (const reply of comment.replies ?? []) {
-      const replyResolved = reply.resolvedAt ? " [resolved]" : "";
-      console.log(`  [${reply.createdAt}] reply${replyResolved} ${reply.name}`);
-      console.log(`  ${reply.body}`);
+    for (const reply2 of comment.replies ?? []) {
+      const replyResolved = reply2.resolvedAt ? " [resolved]" : "";
+      console.log(`  [${reply2.createdAt}] reply${replyResolved} ${reply2.name}`);
+      console.log(`  ${reply2.body}`);
     }
     console.log("");
   }
@@ -4642,6 +4719,14 @@ function commentsApiUrlForTarget(value, options = {}) {
   if (version !== void 0) url.searchParams.set("v", String(version));
   return url;
 }
+function replyApiUrlForTarget(value, options = {}) {
+  const target = parseAccessTarget(value, ["read"], "a read URL with /r/<readId> or a read id", { parseVersion: true });
+  const apiUrl = normalizeApiUrl(String(options.apiUrl ?? target.apiUrl ?? defaultApiUrl));
+  const url = new URL(`/api/read/${encodeURIComponent(target.id)}/comments`, apiUrl);
+  const version = options.version ?? target.version;
+  if (version !== void 0) url.searchParams.set("v", String(version));
+  return url;
+}
 function deleteApiUrlForTarget(value, options = {}) {
   const target = parseEditTarget(value);
   const apiUrl = normalizeApiUrl(String(options.apiUrl ?? target.apiUrl ?? defaultApiUrl));
@@ -4682,6 +4767,9 @@ function validateAccessTarget(target, expected) {
   const prefix = target.kind === "read" ? "read" : "edit";
   if (!new RegExp(`^${prefix}_[A-Za-z0-9_-]{6,80}$`).test(target.id)) throw new Error(`Invalid ${expected}.`);
 }
+function validateCommentId(commentId) {
+  if (!/^cmt_[A-Za-z0-9_-]{8,64}$/.test(commentId)) throw new Error("Invalid comment id.");
+}
 function normalizeApiUrl(value) {
   return value.endsWith("/") ? value.slice(0, -1) : value;
 }
@@ -4769,6 +4857,7 @@ export {
   parseReadId,
   publishOutputLines,
   readHistoryEntries,
+  replyApiUrlForTarget,
   resolveBuildParentDir,
   runCli,
   validatePageSource

package/docs/index.md

@@ -11,10 +11,13 @@ p11 share <page.tsx>
 p11 share <page.tsx> --edit-url <editUrl>
 p11 history
 p11 comments <readUrl|editUrl|readId|editId>
+p11 reply <readUrl|readId> <commentId> --body "Reply text"
 p11 delete <editUrl|editId>
 ```
 
-For `share`, `history`, `comments`, and `delete`, add `--json` when scripting or when exact structured fields are needed.
+Replies are plain text; newlines are preserved. Markdown and HTML are not rendered.
+
+For `share`, `history`, `comments`, `reply`, and `delete`, add `--json` when scripting or when exact structured fields are needed.
 
 ## Docs Topics
 
@@ -32,4 +35,4 @@ p11 example all
 p11 example all --output ./all.tsx
 ```
 
-Use `p11 share --help`, `p11 comments --help`, `p11 delete --help`, and `p11 history --help` for command-specific flags.
+Use `p11 share --help`, `p11 comments --help`, `p11 reply --help`, `p11 delete --help`, and `p11 history --help` for command-specific flags.

package/docs/sharing.md

@@ -26,6 +26,16 @@ p11 comments <readUrl|editUrl|readId|editId> --version 1
 p11 comments <readUrl|editUrl|readId|editId> --output comments.json
 ```
 
+Reply to a top-level comment:
+
+```bash
+p11 reply <readUrl|readId> <commentId> --body "Reply text"
+p11 reply <readUrl|readId> <commentId> --body-file reply.txt
+p11 reply <readUrl|readId> <commentId> --body-file - --json
+```
+
+Replies are plain text; newlines are preserved. Markdown and HTML are not rendered.
+
 Delete a shared document and all of its versions, comments, and replies:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@p11-core/cli",
-  "version": "0.0.16",
+  "version": "0.0.17",
   "license": "UNLICENSED",
   "type": "module",
   "bin": {