@agentchatme/openclaw 0.7.81 → 0.7.821

package/dist/index.d.cts

@@ -359,6 +359,16 @@ interface NormalizedMessage {
     readonly deliveredAt: string | null;
     readonly readAt: string | null;
     readonly receivedAt: UnixMillis;
+    /** Sender's resolved display name, or null when unset / no context block. */
+    readonly senderDisplayName: string | null;
+    /** 'system' = platform agent (weight its words as authoritative); 'agent' = peer. */
+    readonly senderKind: 'agent' | 'system';
+    /** Group's human-readable name (null for DMs / when the server omitted it). */
+    readonly groupName: string | null;
+    readonly memberCount: number | null;
+    /** Handles @-mentioned, parsed server-side (word-boundary). Test your OWN
+     *  handle for membership — never substring-match the raw text. */
+    readonly mentions: readonly string[];
 }
 interface NormalizedReadReceipt {
     readonly kind: 'read-receipt';

package/dist/index.d.ts

@@ -359,6 +359,16 @@ interface NormalizedMessage {
     readonly deliveredAt: string | null;
     readonly readAt: string | null;
     readonly receivedAt: UnixMillis;
+    /** Sender's resolved display name, or null when unset / no context block. */
+    readonly senderDisplayName: string | null;
+    /** 'system' = platform agent (weight its words as authoritative); 'agent' = peer. */
+    readonly senderKind: 'agent' | 'system';
+    /** Group's human-readable name (null for DMs / when the server omitted it). */
+    readonly groupName: string | null;
+    readonly memberCount: number | null;
+    /** Handles @-mentioned, parsed server-side (word-boundary). Test your OWN
+     *  handle for membership — never substring-match the raw text. */
+    readonly mentions: readonly string[];
 }
 interface NormalizedReadReceipt {
     readonly kind: 'read-receipt';

package/dist/index.js

@@ -1523,6 +1523,19 @@ var messageContentSchema = z.object({
   data: z.record(z.string(), z.unknown()).optional(),
   attachment_id: z.string().optional()
 }).passthrough();
+var messageContextSchema = z.object({
+  sender: z.object({
+    handle: z.string(),
+    display_name: z.string().nullable().optional(),
+    kind: z.enum(["agent", "system"]).optional()
+  }).passthrough().optional(),
+  conversation: z.object({
+    type: z.enum(["direct", "group"]).optional(),
+    group_name: z.string().nullable().optional(),
+    member_count: z.number().int().nullable().optional()
+  }).passthrough().optional(),
+  mentions: z.array(z.string()).optional()
+}).passthrough();
 var messageSchema = z.object({
   id: z.string(),
   conversation_id: z.string(),
@@ -1532,6 +1545,7 @@ var messageSchema = z.object({
   type: z.enum(["text", "structured", "file", "system"]),
   content: messageContentSchema,
   metadata: z.record(z.string(), z.unknown()).default({}),
+  context: messageContextSchema.optional(),
   // Per-recipient delivery state lives in `message_deliveries` since
   // migration 011 — the `messages` row no longer carries `status`,
   // `delivered_at`, or `read_at`. Fresh-send envelopes over WS omit
@@ -1653,7 +1667,12 @@ function normalizeMessageNew(frame) {
     createdAt: msg.created_at,
     deliveredAt: msg.delivered_at ?? null,
     readAt: msg.read_at ?? null,
-    receivedAt: frame.receivedAt
+    receivedAt: frame.receivedAt,
+    senderDisplayName: msg.context?.sender?.display_name ?? null,
+    senderKind: msg.context?.sender?.kind === "system" ? "system" : "agent",
+    groupName: msg.context?.conversation?.group_name ?? null,
+    memberCount: msg.context?.conversation?.member_count ?? null,
+    mentions: (msg.context?.mentions ?? []).map((m) => m.toLowerCase())
   };
 }
 function normalizeMessageRead(frame) {
@@ -1860,7 +1879,7 @@ var CircuitBreaker = class {
 };
 
 // src/version.ts
-var PACKAGE_VERSION = "0.7.81";
+var PACKAGE_VERSION = "0.7.821";
 
 // src/outbound.ts
 var DEFAULT_RETRY_POLICY = {
@@ -2634,10 +2653,14 @@ function buildDecisionMessages(params) {
     }
   ];
 }
-function buildUserContent(params) {
-  const { handle, event, history, signals, maxHistory } = params;
-  const kind = event.conversationKind === "group" ? "group" : "direct";
-  const lines = [`Conversation type: ${kind}`];
+function formatReceivedAt(ms) {
+  if (!Number.isFinite(ms)) return "an unknown time";
+  const iso = new Date(ms).toISOString();
+  return `${iso.slice(0, 10)} ${iso.slice(11, 16)} UTC`;
+}
+function formatConversationContext(params) {
+  const { handle, event, signals, priorCount } = params;
+  const lines = [`Conversation type: ${formatConversationLabel(event)}`];
   if (signals) {
     lines.push(`Relationship: ${relationshipPhrase(signals)}`);
     if (signals.secondsSincePrevious !== null) {
@@ -2646,13 +2669,28 @@ function buildUserContent(params) {
       );
     }
   }
-  lines.push(`Prior messages in this thread: ${history.length}`);
-  if (kind === "group") {
-    const mentioned = (event.contentText || "").toLowerCase().includes(`@${handle.toLowerCase()}`);
-    lines.push(
-      `Message directly addresses you: ${mentioned ? "yes" : "not explicitly"}`
-    );
+  lines.push(`Prior messages in this thread: ${priorCount}`);
+  if (event.conversationKind === "group" && handle && (event.mentions ?? []).includes(handle.toLowerCase())) {
+    lines.push("You were @-mentioned in this message.");
+  }
+  return lines;
+}
+function formatConversationLabel(event) {
+  if (event.conversationKind !== "group") return "direct";
+  let label = event.groupName ? `group "${event.groupName}"` : "group";
+  if (event.memberCount != null) {
+    label += ` (${event.memberCount} member${event.memberCount === 1 ? "" : "s"})`;
   }
+  return label;
+}
+function buildUserContent(params) {
+  const { handle, event, history, signals, maxHistory } = params;
+  const lines = formatConversationContext({
+    handle,
+    event,
+    signals,
+    priorCount: history.length
+  });
   lines.push("");
   const rendered = renderHistory(history, maxHistory);
   if (rendered.length > 0) {
@@ -2942,8 +2980,9 @@ async function handleMessage(deps, event) {
       peer,
       runtime
     });
+    let gateContext = null;
     if (gateEnabled()) {
-      const decision = await runReplyGate({
+      const { decision, context } = await runReplyGate({
         deps,
         event,
         body,
@@ -2965,17 +3004,40 @@ async function handleMessage(deps, event) {
         "reply gate decision"
       );
       if (!decision.reply) return;
+      gateContext = context;
+    }
+    const contextHeader = [formatSenderLine(event), `Received: ${formatReceivedAt(ts)}`];
+    if (gateContext) {
+      contextHeader.push(...gateContext);
+    } else {
+      contextHeader.push(
+        `Conversation type: ${formatConversationLabel({
+          conversationKind: event.conversationKind,
+          senderHandle,
+          contentText: body,
+          groupName: event.groupName,
+          memberCount: event.memberCount,
+          mentions: event.mentions
+        })}`
+      );
+      const self = (selfHandle ?? "").replace(/^@/, "").toLowerCase();
+      if (event.conversationKind === "group" && self && event.mentions.includes(self)) {
+        contextHeader.push("You were @-mentioned in this message.");
+      }
     }
+    const agentBody = `${contextHeader.join("\n")}
+
+${body}`;
     const { storePath, body: envelopeBody } = buildEnvelope({
       channel: "AgentChat",
       from: conversationLabel,
-      body,
+      body: agentBody,
       timestamp: ts
     });
     const finalize = channelRuntime.reply.finalizeInboundContext;
     const ctxPayload = finalize({
       Body: envelopeBody,
-      BodyForAgent: body,
+      BodyForAgent: agentBody,
       RawBody: body,
       CommandBody: body,
       From: `@${senderHandle}`,
@@ -3042,6 +3104,10 @@ async function handleMessage(deps, event) {
     );
   }
 }
+function formatSenderLine(event) {
+  const who = event.senderDisplayName ? `${event.senderDisplayName} (@${event.sender})` : `@${event.sender}`;
+  return `From: ${event.senderKind === "system" ? `${who}, a system agent` : who}`;
+}
 async function runReplyGate(params) {
   const { deps, event, body, agentId, selfHandle, senderHandle, nowMs } = params;
   const ownHandle = selfHandle ?? "";
@@ -3056,17 +3122,22 @@ async function runReplyGate(params) {
       "reply gate: history fetch failed \u2014 deciding on the new message alone"
     );
   }
+  const bareHandle = ownHandle.replace(/^@/, "");
   const gateEvent = {
     conversationKind: event.conversationKind,
     senderHandle,
-    contentText: body
+    contentText: body,
+    groupName: event.groupName,
+    memberCount: event.memberCount,
+    mentions: event.mentions
   };
-  return decideReply({
+  const history = translateHistory(rawMessages, ownHandle, event.conversationKind, event.messageId);
+  const decision = await decideReply({
     cfg: deps.gatewayCfg,
     agentId,
-    handle: ownHandle.replace(/^@/, ""),
+    handle: bareHandle,
     event: gateEvent,
-    history: translateHistory(rawMessages, ownHandle, event.conversationKind, event.messageId),
+    history,
     rawMessages,
     triggerMessageId: event.messageId,
     ownHandle,
@@ -3075,6 +3146,18 @@ async function runReplyGate(params) {
     timeoutMs: gateTimeoutMs(),
     caller: deps.gateCaller
   });
+  const signals = computeConversationSignals(rawMessages, {
+    ownHandle,
+    triggerMessageId: event.messageId,
+    nowMs
+  });
+  const context = formatConversationContext({
+    handle: bareHandle,
+    event: gateEvent,
+    signals,
+    priorCount: history.length
+  });
+  return { decision, context };
 }
 function translateHistory(messages, ownHandle, conversationKind, triggerMessageId) {
   const own = ownHandle.replace(/^@/, "").toLowerCase();
@@ -4775,75 +4858,77 @@ function profileToEntry(agent) {
     ...agent.avatar_url ? { avatarUrl: agent.avatar_url } : {}
   };
 }
-var agentchatDirectoryAdapter = {
-  async self({ cfg, accountId }) {
-    const config = resolveAccount(cfg, accountId);
-    if (!config) return null;
-    const client = getClient({ accountId: accountId ?? "default", config });
-    try {
-      const me = await client.getMe();
-      return profileToEntry(me);
-    } catch {
-      return null;
-    }
-  },
-  async listPeers({ cfg, accountId, query, limit }) {
-    const config = resolveAccount(cfg, accountId);
-    if (!config) return [];
-    const q = (query ?? "").trim();
-    if (q.length < 2) return [];
-    const client = getClient({ accountId: accountId ?? "default", config });
-    try {
-      const result = await client.searchAgents(q, { limit: limit ?? 20 });
-      return result.agents.map(profileToEntry);
-    } catch {
-      return [];
-    }
-  },
-  async listPeersLive(params) {
-    return this.listPeers(params);
-  },
-  async listGroups({ cfg, accountId, query, limit }) {
-    const config = resolveAccount(cfg, accountId);
-    if (!config) return [];
-    const client = getClient({ accountId: accountId ?? "default", config });
-    try {
-      const convs = await client.listConversations();
-      const q = (query ?? "").trim().toLowerCase();
-      const groupRows = convs.filter((c) => c.type === "group");
-      const filtered = q ? groupRows.filter((c) => (c.group_name ?? "").toLowerCase().includes(q)) : groupRows;
-      const cap = limit ?? 50;
-      return filtered.slice(0, cap).map((c) => ({
-        kind: "group",
-        id: c.id,
-        name: c.group_name ?? "Untitled group",
-        ...c.group_avatar_url ? { avatarUrl: c.group_avatar_url } : {}
-      }));
-    } catch {
-      return [];
-    }
-  },
-  async listGroupsLive(params) {
-    return this.listGroups(params);
-  },
-  async listGroupMembers({ cfg, accountId, groupId, limit }) {
-    const config = resolveAccount(cfg, accountId);
-    if (!config) return [];
-    const client = getClient({ accountId: accountId ?? "default", config });
-    try {
-      const group = await client.getGroup(groupId);
-      const cap = limit ?? 256;
-      return group.members.slice(0, cap).map((m) => ({
-        kind: "user",
-        id: m.handle,
-        handle: m.handle,
-        name: m.display_name ?? m.handle
-      }));
-    } catch {
-      return [];
-    }
+var directorySelf = async ({ cfg, accountId }) => {
+  const config = resolveAccount(cfg, accountId);
+  if (!config) return null;
+  const client = getClient({ accountId: accountId ?? "default", config });
+  try {
+    const me = await client.getMe();
+    return profileToEntry(me);
+  } catch {
+    return null;
   }
 };
+var listPeers = async ({ cfg, accountId, query, limit }) => {
+  const config = resolveAccount(cfg, accountId);
+  if (!config) return [];
+  const q = (query ?? "").trim();
+  if (q.length < 2) return [];
+  const client = getClient({ accountId: accountId ?? "default", config });
+  try {
+    const result = await client.searchAgents(q, { limit: limit ?? 20 });
+    return result.agents.map(profileToEntry);
+  } catch {
+    return [];
+  }
+};
+var listGroups = async ({ cfg, accountId, query, limit }) => {
+  const config = resolveAccount(cfg, accountId);
+  if (!config) return [];
+  const client = getClient({ accountId: accountId ?? "default", config });
+  try {
+    const convs = await client.listConversations();
+    const q = (query ?? "").trim().toLowerCase();
+    const groupRows = convs.filter((c) => c.type === "group");
+    const filtered = q ? groupRows.filter((c) => (c.group_name ?? "").toLowerCase().includes(q)) : groupRows;
+    const cap = limit ?? 50;
+    return filtered.slice(0, cap).map((c) => ({
+      kind: "group",
+      id: c.id,
+      name: c.group_name ?? "Untitled group",
+      ...c.group_avatar_url ? { avatarUrl: c.group_avatar_url } : {}
+    }));
+  } catch {
+    return [];
+  }
+};
+var listGroupMembers = async ({ cfg, accountId, groupId, limit }) => {
+  const config = resolveAccount(cfg, accountId);
+  if (!config) return [];
+  const client = getClient({ accountId: accountId ?? "default", config });
+  try {
+    const group = await client.getGroup(groupId);
+    const cap = limit ?? 256;
+    return group.members.slice(0, cap).map((m) => ({
+      kind: "user",
+      id: m.handle,
+      handle: m.handle,
+      name: m.display_name ?? m.handle
+    }));
+  } catch {
+    return [];
+  }
+};
+var agentchatDirectoryAdapter = {
+  self: directorySelf,
+  listPeers,
+  // `*Live` are literal aliases of the base impls — never `this.listPeers!`,
+  // which breaks when the runtime forwards the method detached.
+  listPeersLive: listPeers,
+  listGroups,
+  listGroupsLive: listGroups,
+  listGroupMembers
+};
 
 // src/binding/resolver.ts
 function resolveAccount2(cfg, accountId) {