@inline-openclaw/inline 0.0.41 → 0.0.43

package/README.md

@@ -20,7 +20,7 @@ Supports:
 Reply-thread behavior:
 
 - Small/new parent-chat conversations stay in the parent chat by default.
-- `replyThreadMode: "thread"` opts a parent chat into automatic reply-thread delivery once `replyThreadAutoCreateMinMessages` is reached.
+- `replyThreadMode: "thread"` opts a parent chat into automatic reply-thread delivery once `replyThreadAutoCreateMinMessages` is reached; each triggering parent-chat message gets its own child reply thread.
 - `replyThreadMode: "main"` keeps automatic replies in the parent chat, while explicit `thread-create` and `thread-reply` tools remain available.
 - `thread-create` creates a real Inline reply thread. `thread-reply` sends into the child reply-thread chat id returned by `thread-create`.
 - Inbound reply-thread messages use the parent chat as the base conversation target and the child reply-thread chat id as `MessageThreadId`.
@@ -135,7 +135,7 @@ channels:
       - "inline:123" # or "user:123" or just "123"
     requireMention: true # optional: default is false
     replyToBotWithoutMention: true # if true, replies to bot messages can bypass mention requirement
-    replyThreadMode: "auto" # auto|thread|main; thread auto-routes long parent-chat replies into one reply thread
+    replyThreadMode: "auto" # auto|thread|main; thread auto-routes long parent-chat replies into per-message reply threads
     replyThreadAutoCreateMinMessages: 50 # optional, default 50; avoids creating reply threads for small/new chats
     replyThreadRequireExplicitMention: false # optional, default false; bot-participated reply threads continue without @mention
     replyThreadParentHistoryLimit: 10 # optional, default 10; set 0 to disable parent-chat context before the anchor
@@ -186,7 +186,8 @@ Reply behavior summary:
 - `replyToId` is always an Inline message id.
 - Inline reply threads are separate and use OpenClaw `threadId`.
 - Use `replyThreadMode: "main"` if you only want automatic parent-chat replies to stay in the parent chat.
-- Use `replyThreadMode: "thread"` plus `replyThreadAutoCreateMinMessages` when long parent-chat conversations should move into one stable reply thread.
+- Use `replyThreadMode: "thread"` plus `replyThreadAutoCreateMinMessages` when parent-chat bot turns should move into child reply threads anchored to the triggering parent messages.
+- In an Inline group, authorized users can run `/threadreply` to choose the chat's mode with buttons, or `/threadreply thread|main|auto|inherit|status`.
 - Bot-participated reply threads continue without `@bot` by default, including from persisted recent participation state. Set `replyThreadRequireExplicitMention: true` if a chat should require `@bot` on every reply-thread message.
 - `replyThreadParentHistoryLimit` defaults to `10`, so reply-thread turns include nearby parent-chat context before the anchor. Set it to `0` only when a chat should stay strictly thread-local.
 
@@ -237,7 +238,7 @@ Inline reply-thread semantics:
 - `thread-reply` expects `threadId` to be the child reply-thread chat id, while `to` stays the parent chat id.
 - `thread-create` creates a real reply thread from a parent chat and optional `replyToId` anchor.
 - Automatic thread creation falls back to parent-chat delivery if the reply thread cannot be created.
-- Existing route state is reused so long conversations stay in one reply thread instead of creating one thread per message.
+- Existing route state is reused only for the same parent-message anchor. New parent-chat messages get separate reply threads; messages already inside a reply thread stay in that thread and do not create nested threads.
 - If the current reply-thread message has no direct media, OpenClaw can inherit the anchor message media so image/file-only thread starters remain visible to the agent.
 
 You can gate action groups from config:
@@ -291,6 +292,7 @@ Bot command sync:
 
 - On `gateway_start`, the plugin registers default bot commands for each enabled/configured Inline account.
 - Default commands include the same user-facing command set as bundled chat providers (for example: `/status`, `/model`, `/exec`, `/usage`, etc.).
+- Inline also registers `/threadreply` to manage this group's reply-thread mode from chat.
 - The plugin uses OpenClaw's command, skill command, and plugin command registries when available.
 - Disable startup sync globally with `commands.native: false`, or per-channel with `channels.inline.commands.native: false`. Disabled startup sync clears existing Inline bot commands for the affected account.
 - Disable skill command inclusion with `commands.nativeSkills: false`, or per-channel with `channels.inline.commands.nativeSkills: false`.

package/dist/approval-handler.runtime.js

@@ -20572,6 +20572,8 @@ class InlineSdkClient {
   saveInFlight = null;
   catchUpInFlightByChatId = new Map;
   catchUpRequestedByChatId = new Map;
+  catchUpInFlightBySpaceId = new Map;
+  catchUpRequestedBySpaceId = new Map;
   userCatchUpInFlight = null;
   constructor(options) {
     this.options = options;
@@ -20636,7 +20638,11 @@ class InlineSdkClient {
     this.started = false;
     this.rejectOpen(new Error("closed"));
     this.eventStream.close();
-    await Promise.allSettled(this.catchUpInFlightByChatId.values());
+    await Promise.allSettled([
+      ...this.catchUpInFlightByChatId.values(),
+      ...this.catchUpInFlightBySpaceId.values(),
+      ...this.userCatchUpInFlight ? [this.userCatchUpInFlight] : []
+    ]);
     await this.flushStateSave();
     await this.protocol.stopTransport();
   }
@@ -20660,6 +20666,7 @@ class InlineSdkClient {
       version: 1,
       ...this.state.dateCursor != null ? { dateCursor: this.state.dateCursor } : {},
       ...this.state.lastSeqByChatId != null ? { lastSeqByChatId: { ...this.state.lastSeqByChatId } } : {},
+      ...this.state.lastSeqBySpaceId != null ? { lastSeqBySpaceId: { ...this.state.lastSeqBySpaceId } } : {},
       ...this.state.lastUserSeq != null ? { lastUserSeq: this.state.lastUserSeq } : {}
     };
   }
@@ -20680,12 +20687,7 @@ class InlineSdkClient {
     const chat = result.getChat.chat;
     if (!chat)
       throw new Error("getChat: missing chat");
-    return {
-      chatId: chat.id,
-      peer: chat.peerId,
-      title: chat.title,
-      ...chat.lastMsgId != null ? { lastMsgId: chat.lastMsgId } : {}
-    };
+    return { chatId: chat.id, peer: chat.peerId, title: chat.title };
   }
   async getMessages(params) {
     const peerId = this.inputPeerFromTarget(params, "getMessages");
@@ -21014,32 +21016,57 @@ class InlineSdkClient {
       }
       case "clearChatHistory": {
         const payload = update.update.clearChatHistory;
+        if (!payload.target) {
+          this.log.warn?.("Skipping clearChatHistory update without target");
+          return;
+        }
         if (payload.target.oneofKind === "spaceId") {
+          this.bumpSpaceSeq(payload.target.spaceId, seq);
           await this.eventStream.send({
             kind: "space.history.clear",
             spaceId: payload.target.spaceId,
             ...payload.beforeDate != null ? { beforeDate: payload.beforeDate } : {},
             deleteReplyThreads: payload.deleteReplyThreads,
+            deletedChatIds: payload.deletedChatIds,
+            orphanedChatIds: payload.orphanedChatIds,
+            detachedChatIds: payload.detachedChatIds,
             seq,
             date
           });
           return;
         }
         const peerId = payload.target.oneofKind === "peerId" ? payload.target.peerId : undefined;
-        const chatId = peerId?.type.oneofKind === "chat" ? peerId.type.chat.chatId : null;
-        if (!chatId) {
-          this.log.warn?.("Skipping clearChatHistory update without chat peer", peerId);
+        if (peerId?.type.oneofKind === "chat") {
+          const chatId = peerId.type.chat.chatId;
+          this.bumpChatSeq(chatId, seq);
+          await this.eventStream.send({
+            kind: "message.history.clear",
+            chatId,
+            ...payload.beforeDate != null ? { beforeDate: payload.beforeDate } : {},
+            deleteReplyThreads: payload.deleteReplyThreads,
+            deletedChatIds: payload.deletedChatIds,
+            orphanedChatIds: payload.orphanedChatIds,
+            detachedChatIds: payload.detachedChatIds,
+            seq,
+            date
+          });
           return;
         }
-        this.bumpChatSeq(chatId, seq);
-        await this.eventStream.send({
-          kind: "message.history.clear",
-          chatId,
-          ...payload.beforeDate != null ? { beforeDate: payload.beforeDate } : {},
-          deleteReplyThreads: payload.deleteReplyThreads,
-          seq,
-          date
-        });
+        if (peerId?.type.oneofKind === "user") {
+          await this.eventStream.send({
+            kind: "message.history.clear",
+            userId: peerId.type.user.userId,
+            ...payload.beforeDate != null ? { beforeDate: payload.beforeDate } : {},
+            deleteReplyThreads: payload.deleteReplyThreads,
+            deletedChatIds: payload.deletedChatIds,
+            orphanedChatIds: payload.orphanedChatIds,
+            detachedChatIds: payload.detachedChatIds,
+            seq,
+            date
+          });
+          return;
+        }
+        this.log.warn?.("Skipping clearChatHistory update without peer target", peerId);
         return;
       }
       case "updateReaction": {
@@ -21123,6 +21150,7 @@ class InlineSdkClient {
           seq,
           date
         });
+        this.requestCatchUpSpace({ spaceId: payload.spaceId, updateSeq: payload.updateSeq });
         return;
       }
       default:
@@ -21141,6 +21169,18 @@ class InlineSdkClient {
       this.scheduleStateSave();
     }
   }
+  bumpSpaceSeq(spaceId, seq) {
+    if (!Number.isFinite(seq))
+      return;
+    if (!this.state.lastSeqBySpaceId)
+      this.state.lastSeqBySpaceId = {};
+    const key = spaceId.toString();
+    const prev = this.state.lastSeqBySpaceId[key] ?? 0;
+    if (seq > prev) {
+      this.state.lastSeqBySpaceId[key] = seq;
+      this.scheduleStateSave();
+    }
+  }
   shouldSkipUserSeq(seq) {
     if (!Number.isFinite(seq))
       return false;
@@ -21320,6 +21360,112 @@ class InlineSdkClient {
     }
     return false;
   }
+  requestCatchUpSpace(params) {
+    const previous = this.catchUpRequestedBySpaceId.get(params.spaceId);
+    this.catchUpRequestedBySpaceId.set(params.spaceId, {
+      endSeq: Math.max(previous?.endSeq ?? 0, params.updateSeq)
+    });
+    if (this.catchUpInFlightBySpaceId.has(params.spaceId)) {
+      return;
+    }
+    const task = this.drainCatchUpSpace(params.spaceId).catch((error) => {
+      this.catchUpRequestedBySpaceId.delete(params.spaceId);
+      this.log.warn?.("GET_UPDATES space catch-up failed; continuing live delivery", {
+        spaceId: params.spaceId.toString(),
+        error: extractErrorMessage(error)
+      });
+    }).finally(() => {
+      this.catchUpInFlightBySpaceId.delete(params.spaceId);
+    });
+    this.catchUpInFlightBySpaceId.set(params.spaceId, task);
+  }
+  async drainCatchUpSpace(spaceId) {
+    const key = spaceId.toString();
+    while (true) {
+      const request = this.catchUpRequestedBySpaceId.get(spaceId);
+      if (!request)
+        return;
+      const lastSeq = this.state.lastSeqBySpaceId?.[key];
+      const startSeq = lastSeq ?? Math.max(0, request.endSeq - defaultColdStartCatchUpWindow);
+      if (request.endSeq <= startSeq) {
+        this.catchUpRequestedBySpaceId.delete(spaceId);
+        return;
+      }
+      const stop = await this.doCatchUpSpace(spaceId, startSeq, request.endSeq);
+      if (stop) {
+        this.catchUpRequestedBySpaceId.delete(spaceId);
+        return;
+      }
+      const latest = this.catchUpRequestedBySpaceId.get(spaceId);
+      const syncedSeq = this.state.lastSeqBySpaceId?.[key] ?? 0;
+      if (!latest || latest.endSeq <= syncedSeq) {
+        this.catchUpRequestedBySpaceId.delete(spaceId);
+        return;
+      }
+    }
+  }
+  async doCatchUpSpace(spaceId, startSeq, endSeq) {
+    let cursor = startSeq;
+    while (cursor < endSeq) {
+      const result = await this.invoke(Method.GET_UPDATES, {
+        oneofKind: "getUpdates",
+        getUpdates: GetUpdatesInput.create({
+          bucket: UpdateBucket.create({
+            type: {
+              oneofKind: "space",
+              space: {
+                spaceId
+              }
+            }
+          }),
+          startSeq: BigInt(cursor),
+          seqEnd: BigInt(endSeq),
+          totalLimit: defaultCatchUpTotalLimit,
+          limit: defaultCatchUpPageLimit
+        })
+      });
+      const payload = result.getUpdates;
+      if (payload.resultType === GetUpdatesResult_ResultType.TOO_LONG) {
+        this.log.warn?.("GET_UPDATES space too long; fast-forwarding cursor", {
+          spaceId: spaceId.toString(),
+          seq: payload.seq
+        });
+        this.bumpSpaceSeq(spaceId, endSeq);
+        if (payload.date !== 0n) {
+          this.state.dateCursor = payload.date;
+        }
+        this.scheduleStateSave();
+        return true;
+      }
+      const deliveredSeq = Number(payload.seq ?? 0n);
+      if (!Number.isSafeInteger(deliveredSeq)) {
+        this.log.warn?.("GET_UPDATES space returned non-integer seq; aborting catch-up", {
+          spaceId: spaceId.toString()
+        });
+        return true;
+      }
+      this.bumpSpaceSeq(spaceId, deliveredSeq);
+      for (const update of payload.updates) {
+        await this.handleUpdate(update);
+      }
+      if (payload.date !== 0n) {
+        this.state.dateCursor = payload.date;
+      }
+      this.scheduleStateSave();
+      if (payload.final)
+        return true;
+      if (deliveredSeq <= cursor) {
+        this.log.warn?.("GET_UPDATES space made no progress; aborting catch-up", {
+          spaceId: spaceId.toString(),
+          cursor,
+          deliveredSeq
+        });
+        return true;
+      }
+      cursor = deliveredSeq;
+    }
+    return false;
+  }
   peerToInputPeer(peer, chatId) {
     if (!peer) {
       return InputPeer.create({ type: { oneofKind: "chat", chat: { chatId } } });
@@ -21400,6 +21546,7 @@ class InlineSdkClient {
       version: 1,
       ...this.state.dateCursor != null ? { dateCursor: this.state.dateCursor } : {},
       ...this.state.lastSeqByChatId != null ? { lastSeqByChatId: { ...this.state.lastSeqByChatId } } : {},
+      ...this.state.lastSeqBySpaceId != null ? { lastSeqBySpaceId: { ...this.state.lastSeqBySpaceId } } : {},
       ...this.state.lastUserSeq != null ? { lastUserSeq: this.state.lastUserSeq } : {}
     };
     this.saveInFlight = store.save(snapshot).catch((error) => {
@@ -21617,7 +21764,9 @@ var serializeStateV1 = (state) => {
   const json = {
     version: 1,
     ...state.dateCursor != null ? { dateCursor: state.dateCursor.toString() } : {},
-    ...state.lastSeqByChatId != null ? { lastSeqByChatId: state.lastSeqByChatId } : {}
+    ...state.lastSeqByChatId != null ? { lastSeqByChatId: state.lastSeqByChatId } : {},
+    ...state.lastSeqBySpaceId != null ? { lastSeqBySpaceId: state.lastSeqBySpaceId } : {},
+    ...state.lastUserSeq != null ? { lastUserSeq: state.lastUserSeq } : {}
   };
   return JSON.stringify(json, null, 2);
 };
@@ -21629,10 +21778,21 @@ var deserializeStateV1 = (raw) => {
   return {
     version: 1,
     ...parsed.dateCursor != null ? { dateCursor: BigInt(parsed.dateCursor) } : {},
-    ...parsed.lastSeqByChatId != null ? { lastSeqByChatId: parsed.lastSeqByChatId } : {}
+    ...parsed.lastSeqByChatId != null ? { lastSeqByChatId: parsed.lastSeqByChatId } : {},
+    ...parsed.lastSeqBySpaceId != null ? { lastSeqBySpaceId: parsed.lastSeqBySpaceId } : {},
+    ...parsed.lastUserSeq != null ? { lastUserSeq: parsed.lastUserSeq } : {}
   };
 };
 var isRecord2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isSeqRecord = (value) => {
+  if (!isRecord2(value))
+    return false;
+  for (const v of Object.values(value)) {
+    if (typeof v !== "number" || !Number.isFinite(v))
+      return false;
+  }
+  return true;
+};
 var isStateJsonV1 = (value) => {
   if (!isRecord2(value))
     return false;
@@ -21640,14 +21800,12 @@ var isStateJsonV1 = (value) => {
     return false;
   if (value.dateCursor != null && typeof value.dateCursor !== "string")
     return false;
-  if (value.lastSeqByChatId != null) {
-    if (!isRecord2(value.lastSeqByChatId))
-      return false;
-    for (const v of Object.values(value.lastSeqByChatId)) {
-      if (typeof v !== "number" || !Number.isFinite(v))
-        return false;
-    }
-  }
+  if (value.lastSeqByChatId != null && !isSeqRecord(value.lastSeqByChatId))
+    return false;
+  if (value.lastSeqBySpaceId != null && !isSeqRecord(value.lastSeqBySpaceId))
+    return false;
+  if (value.lastUserSeq != null && (typeof value.lastUserSeq !== "number" || !Number.isFinite(value.lastUserSeq)))
+    return false;
   return true;
 };
 
@@ -37356,6 +37514,7 @@ var INLINE_FORMATTING_RULES = [
   "Prefer bullet lists over markdown tables.",
   "If a table is necessary, render it inside a fenced code block.",
   "Use plain URLs or markdown links; do not wrap bare URLs in inline code or backticks.",
+  "Mention Inline users with markdown links like [@FirstName](inline://user?id=123); use inline://user?username=username only when the user id is unavailable.",
   "Use inline code only for actual code, commands, file paths, env vars, or identifiers."
 ];
 var INLINE_COPY_REPLACEMENTS = [
@@ -37570,6 +37729,7 @@ function keysForLookup(params) {
   const keys = new Set;
   if (params.parentMessageId) {
     keys.add(messageKey(params.accountId, params.parentChatId, params.parentMessageId));
+    return [...keys];
   }
   if (params.agentId) {
     keys.add(activeKey(params.accountId, params.parentChatId, params.agentId));
@@ -40283,5 +40443,5 @@ export {
   inlineApprovalNativeRuntime
 };
 
-//# debugId=9CC8894E01E42C4C64756E2164756E21
+//# debugId=7E42F18FB91A9A3F64756E2164756E21
 //# sourceMappingURL=approval-handler.runtime.js.map