agentic-comments 0.6.0 → 0.6.1

package/README.md

@@ -215,13 +215,13 @@ npx agentic-comments accept <id>
   and a flag that does not apply to a command is refused. `AGENTIC_COMMENTS_LOCK_TIMEOUT_MS` sets the wait
   for a lock, in whole milliseconds.
 - `npx agentic-comments mcp` (or the `agentic-comments-mcp` binary, which reads the same environment) starts
-  the MCP server on stdio. The operator fixes the principal and the
+  the MCP server on stdio. If `AGENTIC_COMMENTS_AS` is missing, the server prints one error line that names it and exits with code 1. The operator fixes the principal and the
   scopes when the server starts. No tool takes an author or a scope. A call with any key a tool does not list is refused, so an agent
   cannot pick its own kind or rights. Tools: `list_threads`, `get_thread`, `add_comment`, `reply_to_thread`, `resolve_thread`,
   `reopen_thread`, `relocate_thread`, `edit_message`, `delete_message`, `delete_thread`, `export_person`,
   `erase_person`, `list_suggestions`, `suggest_change`, `accept_suggestion`, `reject_suggestion`.
-  Another person's message, thread, or data needs `comments:moderate` in `AGENTIC_COMMENTS_SCOPES`. The delete
-  tools and `erase_person` carry the destructive hint.
+  Another person's message, thread, or data needs `comments:moderate` in `AGENTIC_COMMENTS_SCOPES`. The
+  `edit_message`, `delete_message`, `delete_thread`, and `erase_person` tools carry the destructive hint.
 - A text change is `{"replace": "new text"}`. A change for a cell, slide, or canvas anchor is
   `{"value": <JSON>}`.
 - From code: `import { FileStore, CommentsService, operatorActor } from "agentic-comments/local"`.

package/dist/{chunk-2NBFTJ47.js → chunk-6N53KQVU.js}

@@ -248,7 +248,10 @@ import { PrincipalParseError, parsePrincipal } from "agentic-identity";
 function operatorActor(as, scopes) {
   const value = as?.trim();
   const cut = value === void 0 ? -1 : value.indexOf(":");
-  if (value === void 0 || cut < 1 || cut === value.length - 1) {
+  if (value === void 0 || value === "") {
+    throw new CommentsError("INVALID_AUTHOR", `no principal: set AGENTIC_COMMENTS_AS=kind:name (or pass --as), for example agent_of_human:scribe. Kinds: ${PRINCIPAL_KINDS.join(", ")}`);
+  }
+  if (cut < 1 || cut === value.length - 1) {
     throw new CommentsError("INVALID_AUTHOR", `set the principal as kind:name, for example human:ada. Kinds: ${PRINCIPAL_KINDS.join(", ")}`);
   }
   const list = scopes === void 0 || scopes.trim() === "" ? [] : scopes.split(",").map((s) => s.trim());

package/dist/{chunk-ES3NZ7SX.js → chunk-H6JK62SP.js}

@@ -1,6 +1,6 @@
 // src/version.ts
 import { createRequire } from "module";
-var VERSION = true ? "0.6.0" : readPackageVersion();
+var VERSION = true ? "0.6.1" : readPackageVersion();
 
 export {
   VERSION

package/dist/{chunk-SR2A5OZW.js → chunk-UNJL3N2L.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-ES3NZ7SX.js";
+} from "./chunk-H6JK62SP.js";
 import {
   CommentsService
 } from "./chunk-T77DPNIV.js";

package/dist/cli.js

@@ -3,10 +3,10 @@ import {
   FileStore,
   lockTimeoutFrom,
   operatorActor
-} from "./chunk-2NBFTJ47.js";
+} from "./chunk-6N53KQVU.js";
 import {
   VERSION
-} from "./chunk-ES3NZ7SX.js";
+} from "./chunk-H6JK62SP.js";
 import {
   CommentsService,
   TEXT_ROOT
@@ -69,6 +69,8 @@ function parseArgs(argv) {
   if (command === void 0 || command === "--help" || command === "-h") return { command: "help", flags: {}, many: {} };
   if (command === "--version" || command === "-V") return { command: "version", flags: {}, many: {} };
   if (!COMMANDS.includes(command)) throw new UsageError(`unknown command "${command}"`);
+  if (command === "mcp" && rest.some((a) => a === "--help" || a === "-h")) return { command: "help", flags: {}, many: {} };
+  if (command === "mcp" && rest.some((a) => a === "--version" || a === "-V" || a === "-v")) return { command: "version", flags: {}, many: {} };
   const parsed = { command, flags: {}, many: {} };
   for (let i = 0; i < rest.length; i++) {
     const arg = rest[i];
@@ -176,7 +178,7 @@ async function runCli(argv, io) {
       return 0;
     }
     if (p.command === "mcp") {
-      const { startMcp } = await import("./mcp-JX5L6VQW.js");
+      const { startMcp } = await import("./mcp-WBAHKMF4.js");
       await startMcp(store, operatorActor(p.flags["--as"] ?? io.env.AGENTIC_COMMENTS_AS, io.env.AGENTIC_COMMENTS_SCOPES));
       return 0;
     }

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-ES3NZ7SX.js";
+} from "./chunk-H6JK62SP.js";
 import {
   ACCEPT_SCOPE,
   Actor,

package/dist/local.js

@@ -3,7 +3,7 @@ import {
   MAX_FILE,
   lockTimeoutFrom,
   operatorActor
-} from "./chunk-2NBFTJ47.js";
+} from "./chunk-6N53KQVU.js";
 import {
   CommentsService,
   TEXT_ROOT,

package/dist/{mcp-JX5L6VQW.js → mcp-WBAHKMF4.js}

@@ -1,8 +1,8 @@
 import {
   createMcpServer,
   startMcp
-} from "./chunk-SR2A5OZW.js";
-import "./chunk-ES3NZ7SX.js";
+} from "./chunk-UNJL3N2L.js";
+import "./chunk-H6JK62SP.js";
 import "./chunk-T77DPNIV.js";
 import "./chunk-VAVKBAHM.js";
 export {

package/dist/mcp-bin.js

@@ -3,13 +3,13 @@ import {
   FileStore,
   lockTimeoutFrom,
   operatorActor
-} from "./chunk-2NBFTJ47.js";
+} from "./chunk-6N53KQVU.js";
 import {
   startMcp
-} from "./chunk-SR2A5OZW.js";
+} from "./chunk-UNJL3N2L.js";
 import {
   VERSION
-} from "./chunk-ES3NZ7SX.js";
+} from "./chunk-H6JK62SP.js";
 import "./chunk-T77DPNIV.js";
 import "./chunk-VAVKBAHM.js";
 
@@ -27,7 +27,7 @@ Usage: agentic-comments-mcp [--help | --version]`;
 var args = process.argv.slice(2);
 if (args.includes("--help") || args.includes("-h")) {
   console.log(MCP_HELP);
-} else if (args.includes("--version") || args.includes("-v")) {
+} else if (args.includes("--version") || args.includes("-V") || args.includes("-v")) {
   console.log(VERSION);
 } else {
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-comments",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Comment threads and suggestions anchored to any content, from people and agents.",
   "keywords": [
     "comments",
@@ -76,9 +76,9 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.32.2",
-    "agentic-identity": "^0.7.0",
+    "agentic-identity": "^0.8.0",
     "hono": "^4.13.14",
-    "zod": "^3.25.76"
+    "zod": "^4.6.7"
   },
   "peerDependencies": {
     "yjs": "^13.6.0"