larkin 0.4.11 → 0.4.12

package/dist/app/cli.mjs

@@ -87,7 +87,7 @@ Reset replaces one idle, zero-backlog Runtime session. Recover is an explicit op
        larkin pi-auth logout <provider> [--agent <App ID>]
 Show non-sensitive official Pi credential metadata or remove one target provider credential.`,
     comment: `Usage: larkin comment reply --message-id <doc_comment_message_id> --text '<reply>' --json
-Reply once, as the Runtime-bound Bot, to the exact cloud-document comment locator supplied by canonical Inbox.`,
+Reply as the Runtime-bound Bot to the exact cloud-document comment locator supplied by canonical Inbox. Retrying the same body is idempotent; a different body appends a follow-up reply to the same comment.`,
     telemetry: `Usage: larkin telemetry <status|export|import|flush>
 Inspect the durable local trace queue, move an offline bundle, or upload queued OTLP traces.`,
 };

package/dist/app/lark-cli.mjs

@@ -304,18 +304,22 @@ function runCommentReply(argv, privateEnv, io, dependencies, store) {
     if (!store.inboxTargetIsFresh(targetKey))
         throw new Error("comment reply 需要先 poll 当前 document-comment target 的最新 Inbox 消息");
     const digest = createHash("sha256").update(input.text).digest("hex");
+    const ledgerKey = `${input.messageId}::${digest}`;
     const claim = store.mutateJson("freshnessState", { version: 1, cursors: {} }, (state) => {
         state.document_comment_replies ??= {};
-        const prior = state.document_comment_replies[input.messageId];
-        if (prior?.status === "sent" && prior.digest === digest)
+        const legacy = state.document_comment_replies[input.messageId];
+        const prior = state.document_comment_replies[ledgerKey]
+            ?? (legacy?.digest === digest ? legacy : undefined);
+        if (prior?.status === "sent")
             return "sent";
-        if (prior?.status === "sending" && prior.digest === digest)
+        const messageEntries = Object.entries(state.document_comment_replies)
+            .filter(([key]) => key === input.messageId || key.startsWith(`${input.messageId}::`));
+        if (messageEntries.some(([, entry]) => entry.status === "sending"))
             return "ambiguous";
-        if (prior && prior.status !== "failed" && prior.digest !== digest)
-            return "conflict";
-        state.document_comment_replies[input.messageId] = { digest, status: "sending", updated_at: new Date().toISOString() };
-        const keys = Object.keys(state.document_comment_replies);
-        for (const stale of keys.slice(0, Math.max(0, keys.length - 512)))
+        state.document_comment_replies[ledgerKey] = { digest, status: "sending", updated_at: new Date().toISOString() };
+        const terminalKeys = Object.keys(state.document_comment_replies)
+            .filter((key) => state.document_comment_replies[key]?.status !== "sending");
+        for (const stale of terminalKeys.slice(0, Math.max(0, terminalKeys.length - 512)))
             delete state.document_comment_replies[stale];
         return "ready";
     });
@@ -324,9 +328,7 @@ function runCommentReply(argv, privateEnv, io, dependencies, store) {
         return 0;
     }
     if (claim === "ambiguous")
-        throw new Error("comment reply 上次调用结果不明确，已 fail-closed 以避免重复评论；请由用户检查原评论线程");
-    if (claim === "conflict")
-        throw new Error("comment reply 已为同一 Inbox 消息提交不同正文，拒绝覆盖或重复发送");
+        throw new Error("comment reply 上次调用结果不明确，已 fail-closed 以避免重复评论；请勿改写正文重试，请由用户检查原评论线程");
     const nativeArgs = target.topLevel
         ? [
             "drive", "file.comments", "create_v2",
@@ -353,7 +355,7 @@ function runCommentReply(argv, privateEnv, io, dependencies, store) {
     if (terminalStatus) {
         store.mutateJson("freshnessState", { version: 1, cursors: {} }, (state) => {
             state.document_comment_replies ??= {};
-            state.document_comment_replies[input.messageId] = {
+            state.document_comment_replies[ledgerKey] = {
                 digest,
                 status: terminalStatus,
                 updated_at: new Date().toISOString(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "larkin",
-  "version": "0.4.11",
+  "version": "0.4.12",
   "private": false,
   "larkinPackageRole": "npm-published",
   "files": [