@agentchatme/openclaw 0.7.81 → 0.7.82

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.82";
 
 // 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();