@p11-core/cli 0.0.16 → 0.0.18

package/dist/index.js

@@ -3524,6 +3524,7 @@ var P11_HISTORY_LOCK_TIMEOUT_MS = 5e3;
 var P11_HISTORY_DEFAULT_LIMIT = 20;
 var P11_RUNTIME_VERSION = "0.0.1";
 var P11_MANIFEST_FILE = "p11-manifest.json";
+var P11_SOCIAL_PREVIEW_IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([".png", ".jpg", ".jpeg", ".webp"]);
 var cliPackageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 var docsTopics = /* @__PURE__ */ new Map([
   ["index", "docs/index.md"],
@@ -3699,6 +3700,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 +3808,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 +3965,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 +4348,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("");
   }
@@ -4339,7 +4417,12 @@ async function buildPageModule(inputFile, outDir) {
   const pageSource = await readFile(inputFile, "utf8");
   const pageAst = parsePageSource(pageSource);
   validatePageAst(pageAst, inputFile);
+  const pageMetadata = extractPageMetadata(pageAst, inputFile);
+  rewriteRelativeModuleSpecifiers(pageAst, path.dirname(inputFile));
+  await mkdir(tempDir, { recursive: true });
   await writeFile(pagePath, addSourceLineAttributes(pageAst, inputFile));
+  const metadataAssetTracker = createSocialPreviewAssetTracker(pageMetadata, tempDir);
+  const pageImport = pageMetadata ? 'import Page, { metadata as __p11PageMetadata } from "./Page";' : 'import Page from "./Page";';
   await writeFile(
     entryPath,
     [
@@ -4353,7 +4436,8 @@ async function buildPageModule(inputFile, outDir) {
       "  __P11_CREATE_TEXT_ANNOTATOR__: createTextAnnotator,",
       "  __P11_RANGE_TO_SELECTOR__: rangeToSelector",
       "});",
-      'import Page from "./Page";',
+      pageImport,
+      ...pageMetadata ? ["void __p11PageMetadata;"] : [],
       "",
       'createRoot(document.getElementById("root")!).render(',
       "  <React.StrictMode>",
@@ -4387,7 +4471,7 @@ async function buildPageModule(inputFile, outDir) {
       base: "./",
       configFile: false,
       logLevel: "warn",
-      plugins: [react(), tailwindcss()],
+      plugins: [react(), tailwindcss(), ...metadataAssetTracker.plugin ? [metadataAssetTracker.plugin] : []],
       resolve: {
         alias: {
           "@p11-core/components/styles.css": componentStyles,
@@ -4406,6 +4490,7 @@ async function buildPageModule(inputFile, outDir) {
         outDir: path.relative(tempDir, outDir),
         emptyOutDir: true,
         assetsDir: "assets",
+        assetsInlineLimit: 0,
         rollupOptions: {
           input: {
             index: "index.html"
@@ -4416,11 +4501,167 @@ async function buildPageModule(inputFile, outDir) {
   } finally {
     process.chdir(previousCwd);
   }
-  await writeFile(path.join(outDir, P11_MANIFEST_FILE), JSON.stringify({ runtimeVersion: P11_RUNTIME_VERSION }, null, 2));
+  const socialPreviewImage = pageMetadata?.imageSourcePath ? socialPreviewImageForMetadata(pageMetadata, metadataAssetTracker.fileName()) : await firstSocialPreviewImage(outDir);
+  await writeFile(
+    path.join(outDir, P11_MANIFEST_FILE),
+    JSON.stringify(
+      {
+        runtimeVersion: P11_RUNTIME_VERSION,
+        ...pageMetadata?.title ? { title: pageMetadata.title } : {},
+        ...pageMetadata?.description ? { description: pageMetadata.description } : {},
+        ...socialPreviewImage ? { socialPreviewImage } : {}
+      },
+      null,
+      2
+    )
+  );
+}
+function createSocialPreviewAssetTracker(metadata, buildRoot) {
+  let fileName;
+  return {
+    plugin: socialPreviewAssetPlugin(metadata, buildRoot, (nextFileName) => {
+      fileName = nextFileName;
+    }),
+    fileName: () => fileName
+  };
+}
+function socialPreviewAssetPlugin(metadata, buildRoot, onAssetPath) {
+  if (!metadata?.imageSourcePath) return null;
+  const metadataImagePath = normalizeFilePath(realpathSync(metadata.imageSourcePath));
+  return {
+    name: "p11-social-preview-asset",
+    generateBundle(_options, bundle) {
+      const matches = Object.values(bundle).filter((output) => {
+        if (output.type !== "asset") return false;
+        return (output.originalFileNames ?? []).some((fileName) => originalFileNameMatches(fileName, metadataImagePath, buildRoot));
+      });
+      if (matches.length === 1) {
+        onAssetPath(matches[0].fileName);
+        return;
+      }
+      if (matches.length > 1) {
+        throw new Error(`metadata.image matched multiple built assets for ${metadata.imageSourcePath}`);
+      }
+    }
+  };
+}
+function originalFileNameMatches(fileName, metadataImagePath, buildRoot) {
+  const candidate = path.isAbsolute(fileName) ? fileName : path.resolve(buildRoot, fileName);
+  try {
+    return normalizeFilePath(realpathSync(candidate)) === metadataImagePath;
+  } catch (_error) {
+    return false;
+  }
+}
+function normalizeFilePath(filePath) {
+  return path.normalize(filePath).split(path.sep).join("/");
+}
+function socialPreviewImageForMetadata(metadata, builtAssetPath) {
+  if (builtAssetPath) return builtAssetPath;
+  throw new Error(`metadata.image was not emitted as a built asset: ${metadata.imageSourcePath}`);
+}
+async function firstSocialPreviewImage(outDir) {
+  const imagePaths = await socialPreviewImagesInDir(outDir);
+  return imagePaths.sort()[0];
+}
+async function socialPreviewImagesInDir(dir, rootDir = dir) {
+  const entries = await readdir(dir, { withFileTypes: true }).catch(() => null);
+  if (!entries) return [];
+  const images = [];
+  for (const entry of entries) {
+    const entryPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      images.push(...await socialPreviewImagesInDir(entryPath, rootDir));
+      continue;
+    }
+    if (!entry.isFile() || !P11_SOCIAL_PREVIEW_IMAGE_EXTENSIONS.has(path.extname(entry.name).toLowerCase())) continue;
+    images.push(path.relative(rootDir, entryPath).split(path.sep).join("/"));
+  }
+  return images;
 }
 function resolveBuildParentDir(buildDir) {
   return path.resolve(buildDir || process.env.P11_BUILD_DIR || tmpdir());
 }
+function rewriteRelativeModuleSpecifiers(ast, sourceDir) {
+  for (const statement of ast.program.body) {
+    if (statement.type === "ImportDeclaration" || statement.type === "ExportNamedDeclaration" || statement.type === "ExportAllDeclaration") {
+      const source = statement.source;
+      if (!source || !isRelativeModuleSpecifier(source.value)) continue;
+      source.value = path.resolve(sourceDir, source.value);
+    }
+  }
+}
+function isRelativeModuleSpecifier(value) {
+  return value.startsWith("./") || value.startsWith("../");
+}
+function extractPageMetadata(ast, inputFile) {
+  const sourceDir = path.dirname(inputFile);
+  const importSources = importedDefaultSpecifiers(ast);
+  for (const statement of ast.program.body) {
+    if (statement.type !== "ExportNamedDeclaration") continue;
+    const declaration = statement.declaration;
+    if (!declaration || declaration.type !== "VariableDeclaration") continue;
+    for (const declarator of declaration.declarations) {
+      if (declarator.id.type !== "Identifier" || declarator.id.name !== "metadata") continue;
+      if (!declarator.init || declarator.init.type !== "ObjectExpression") {
+        throw new Error("metadata export must be an object literal.");
+      }
+      return metadataFromObjectExpression(declarator.init, importSources, sourceDir);
+    }
+  }
+  return null;
+}
+function importedDefaultSpecifiers(ast) {
+  const imports = /* @__PURE__ */ new Map();
+  for (const statement of ast.program.body) {
+    if (statement.type !== "ImportDeclaration") continue;
+    for (const specifier of statement.specifiers) {
+      if (specifier.type === "ImportDefaultSpecifier") {
+        imports.set(specifier.local.name, statement.source.value);
+      }
+    }
+  }
+  return imports;
+}
+function metadataFromObjectExpression(objectExpression, importSources, sourceDir) {
+  const metadata = {};
+  for (const property of objectExpression.properties) {
+    if (property.type !== "ObjectProperty" || property.computed) continue;
+    const key = objectPropertyName(property.key);
+    if (!key || !["title", "description", "image"].includes(key)) continue;
+    if (key === "title" || key === "description") {
+      metadata[key] = metadataStringValue(property.value, key);
+      continue;
+    }
+    metadata.imageSourcePath = metadataImageSourcePath(property.value, importSources, sourceDir);
+  }
+  return metadata;
+}
+function objectPropertyName(key) {
+  if (key.type === "Identifier") return key.name;
+  if (key.type === "StringLiteral") return key.value;
+  return null;
+}
+function metadataStringValue(value, key) {
+  if (value.type === "StringLiteral") return value.value.trim();
+  if (value.type === "TemplateLiteral" && value.expressions.length === 0) {
+    return value.quasis.map((quasi) => quasi.value.cooked ?? quasi.value.raw).join("").trim();
+  }
+  throw new Error(`metadata.${key} must be a string literal.`);
+}
+function metadataImageSourcePath(value, importSources, sourceDir) {
+  if (value.type !== "Identifier") {
+    throw new Error("metadata.image must reference a default-imported PNG, JPEG, or WebP asset.");
+  }
+  const importSource = importSources.get(value.name);
+  if (!importSource) {
+    throw new Error("metadata.image must reference a default-imported PNG, JPEG, or WebP asset.");
+  }
+  if (!P11_SOCIAL_PREVIEW_IMAGE_EXTENSIONS.has(path.extname(importSource).toLowerCase())) {
+    throw new Error("metadata.image must reference a PNG, JPEG, or WebP asset.");
+  }
+  return isRelativeModuleSpecifier(importSource) ? path.resolve(sourceDir, importSource) : importSource;
+}
 function validatePageSource(code, inputFile = "page.tsx") {
   validatePageAst(parsePageSource(code), inputFile);
 }
@@ -4642,6 +4883,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 +4931,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 +5021,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.18",
   "license": "UNLICENSED",
   "type": "module",
   "bin": {