agentic-comments 0.8.0 → 0.8.3

package/README.md

@@ -244,8 +244,8 @@ npx agentic-comments accept <id>
   `AGENTIC_COMMENTS_SCOPES`, a comma list such as `comments:accept`. No flag takes a scope or an author,
   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. 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
+- `npx agentic-comments mcp` (or the `agentic-comments-mcp` binary, which reads the same environment and takes `--as`) starts
+  the MCP server on stdio. If neither `--as` nor `AGENTIC_COMMENTS_AS` sets the principal, the server prints one error line that names them and exits with code 1. `--as` overrides `AGENTIC_COMMENTS_AS`. 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`,

package/dist/{chunk-6UQ6CDLJ.js → chunk-2VUY75PS.js}

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

package/dist/{chunk-J6JGWDUP.js → chunk-GHKZ6BYR.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-6UQ6CDLJ.js";
+} from "./chunk-2VUY75PS.js";
 import {
   CommentsService
 } from "./chunk-TTNT27PG.js";

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   VERSION
-} from "./chunk-6UQ6CDLJ.js";
+} from "./chunk-2VUY75PS.js";
 import {
   FileStore,
   lockTimeoutFrom,
@@ -178,7 +178,7 @@ async function runCli(argv, io) {
       return 0;
     }
     if (p.command === "mcp") {
-      const { startMcp } = await import("./mcp-IFQQHOA2.js");
+      const { startMcp } = await import("./mcp-E5UKO5ON.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-6UQ6CDLJ.js";
+} from "./chunk-2VUY75PS.js";
 import {
   ACCEPT_SCOPE,
   Actor,

package/dist/{mcp-IFQQHOA2.js → mcp-E5UKO5ON.js}

@@ -1,8 +1,8 @@
 import {
   createMcpServer,
   startMcp
-} from "./chunk-J6JGWDUP.js";
-import "./chunk-6UQ6CDLJ.js";
+} from "./chunk-GHKZ6BYR.js";
+import "./chunk-2VUY75PS.js";
 import "./chunk-TTNT27PG.js";
 import "./chunk-4G5BDTBA.js";
 export {

package/dist/mcp-bin.js

@@ -1,38 +1,50 @@
 #!/usr/bin/env node
 import {
   startMcp
-} from "./chunk-J6JGWDUP.js";
+} from "./chunk-GHKZ6BYR.js";
 import {
   VERSION
-} from "./chunk-6UQ6CDLJ.js";
+} from "./chunk-2VUY75PS.js";
 import {
   FileStore,
   lockTimeoutFrom,
   operatorActor
 } from "./chunk-LFYTCHXS.js";
 import "./chunk-TTNT27PG.js";
-import "./chunk-4G5BDTBA.js";
+import {
+  CommentsError
+} from "./chunk-4G5BDTBA.js";
 
 // src/mcp-bin.ts
 var MCP_HELP = `agentic-comments-mcp ${VERSION}
 
-Start the MCP server on stdio. Set the principal and scopes in the environment:
+Start the MCP server on stdio. Set the principal and scopes in the environment, or pass --as:
 
-  AGENTIC_COMMENTS_AS=kind:name           Required. For example agent_of_human:scribe.
+  --as kind:name                          The principal. Overrides AGENTIC_COMMENTS_AS.
+  AGENTIC_COMMENTS_AS=kind:name           Required unless --as is set. For example agent_of_human:scribe.
   AGENTIC_COMMENTS_SCOPES=a,b             Optional. A comma list, such as comments:accept.
   AGENTIC_COMMENTS_FILE=./comments.ydoc   The store file. The default is ./comments.ydoc.
   AGENTIC_COMMENTS_LOCK_TIMEOUT_MS=5000   How long a write waits for another process.
 
-Usage: agentic-comments-mcp [--help | --version]`;
+Usage: agentic-comments-mcp [--as kind:name] [--help | --version]`;
 var args = process.argv.slice(2);
-if (args.includes("--help") || args.includes("-h")) {
+var flags = args.filter((arg, i) => args[i - 1] !== "--as");
+if (flags.includes("--help") || flags.includes("-h")) {
   console.log(MCP_HELP);
-} else if (args.includes("--version") || args.includes("-V") || args.includes("-v")) {
+} else if (flags.includes("--version") || flags.includes("-V") || flags.includes("-v")) {
   console.log(VERSION);
 } else {
+  const asFlags = args.filter((arg) => arg === "--as" || arg.startsWith("--as="));
+  if (asFlags.length > 1 || asFlags[0] !== void 0 && asFlags[0] !== "--as") {
+    console.error(JSON.stringify({ error: { code: "USAGE", message: "give --as once, as --as kind:name" } }));
+    process.exit(2);
+  }
   try {
     const env = process.env;
-    await startMcp(new FileStore(env.AGENTIC_COMMENTS_FILE ?? "./comments.ydoc", { lockTimeoutMs: lockTimeoutFrom(env) }), operatorActor(env.AGENTIC_COMMENTS_AS, env.AGENTIC_COMMENTS_SCOPES));
+    const asAt = args.indexOf("--as");
+    if (asAt !== -1 && !args[asAt + 1]?.trim()) throw new CommentsError("INVALID_AUTHOR", "--as needs a value, as --as kind:name");
+    const as = asAt === -1 ? env.AGENTIC_COMMENTS_AS : args[asAt + 1];
+    await startMcp(new FileStore(env.AGENTIC_COMMENTS_FILE ?? "./comments.ydoc", { lockTimeoutMs: lockTimeoutFrom(env) }), operatorActor(as, env.AGENTIC_COMMENTS_SCOPES));
   } catch (error) {
     console.error(JSON.stringify({ error: { code: error.code ?? "INTERNAL", message: error instanceof Error ? error.message : String(error) } }));
     process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-comments",
-  "version": "0.8.0",
+  "version": "0.8.3",
   "description": "Comment threads and suggestions anchored to any content, from people and agents.",
   "keywords": [
     "comments",
@@ -90,7 +90,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.32.2",
     "agentic-design": "^0.5.0",
-    "agentic-identity": "^0.8.0",
+    "agentic-identity": "^0.9.0",
     "hono": "^4.13.14",
     "zod": "^4.6.7"
   },