@pnds/pond 1.0.1 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnds/pond",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "OpenClaw channel plugin for Pond IM",
   "license": "MIT",
   "repository": {
@@ -14,7 +14,7 @@
     "openclaw.plugin.json"
   ],
   "dependencies": {
-    "@pnds/sdk": "1.0.1"
+    "@pnds/sdk": "1.1.0"
   },
   "devDependencies": {
     "typescript": "^5.7.0"

package/src/gateway.ts

@@ -38,6 +38,60 @@ async function fetchAllChats(
   return total;
 }
 
+/**
+ * Fetch recent messages from a chat (or thread) and format them as a history context block.
+ * Pass threadRootId to scope to a thread; omit (or null) to fetch top-level messages only.
+ * Returns empty string on failure or timeout (non-fatal).
+ */
+async function buildChatHistoryContext(
+  client: PondClient,
+  orgId: string,
+  chatId: string,
+  beforeMessageId: string,
+  agentUserId: string,
+  limit: number = 30,
+  log?: { warn: (msg: string) => void },
+  threadRootId?: string | null,
+): Promise<string> {
+  try {
+    const threadParams = threadRootId
+      ? { thread_root_id: threadRootId }
+      : { top_level: true as const };
+    const res = await client.getMessages(orgId, chatId, { before: beforeMessageId, limit, ...threadParams });
+    if (!res.data.length) return "";
+
+    const escapeHistoryValue = (value: string): string =>
+      value
+        .replace(/\r?\n/g, "\\n")
+        .replace(/\[Recent chat history\]|\[End of chat history\]/g, (m) => `\\${m}`);
+
+    const lines: string[] = [];
+    for (const msg of res.data) {
+      if (msg.message_type !== "text" && msg.message_type !== "file") continue;
+      const senderLabel = escapeHistoryValue(msg.sender?.display_name ?? msg.sender_id);
+      const role = msg.sender_id === agentUserId ? "You" : senderLabel;
+
+      if (msg.message_type === "text") {
+        const content = msg.content as TextContent;
+        const text = escapeHistoryValue(content.text?.trim() ?? "");
+        if (text) lines.push(`${role}: ${text}`);
+      } else {
+        const content = msg.content as MediaContent;
+        const caption = escapeHistoryValue(
+          content.caption?.trim() || `[file: ${content.file_name || "attachment"}]`,
+        );
+        lines.push(`${role}: ${caption}`);
+      }
+    }
+
+    if (!lines.length) return "";
+    return `[Recent chat history]\n${lines.join("\n")}\n[End of chat history]\n\n`;
+  } catch (err) {
+    log?.warn(`pond: failed to fetch chat history for context: ${String(err)}`);
+    return "";
+  }
+}
+
 /**
  * Dispatch an inbound message to the OpenClaw agent and handle the reply.
  * Shared by both text and file message handlers to avoid duplication.
@@ -53,9 +107,10 @@ async function dispatchToAgent(opts: {
   chatId: string;
   messageId: string;
   inboundCtx: Record<string, unknown>;
+  noReply?: boolean;
   log?: { info: (msg: string) => void; warn: (msg: string) => void; error: (msg: string) => void };
 }) {
-  const { core, cfg, client, config, agentUserId, accountId, sessionKey, chatId, messageId, inboundCtx, log } = opts;
+  const { core, cfg, client, config, agentUserId, accountId, sessionKey, chatId, messageId, inboundCtx, noReply, log } = opts;
   const sessionKeyLower = sessionKey.toLowerCase();
   let thinkingSent = false;
   let runIdPromise: Promise<string | undefined> | undefined;
@@ -72,7 +127,23 @@ async function dispatchToAgent(opts: {
           const runId = runIdPromise ? await runIdPromise : undefined;
 
           if (info.kind === "final") {
-            // Final reply → chat message
+            if (noReply) {
+              // no_reply: unconditionally suppress chat output; runId only affects step recording
+              if (runId) {
+                try {
+                  await client.createAgentStep(config.org_id, agentUserId, runId, {
+                    step_type: "text",
+                    content: { text: replyText, suppressed: true },
+                  });
+                } catch (err) {
+                  log?.warn(`pond[${accountId}]: failed to create suppressed text step: ${String(err)}`);
+                }
+              } else {
+                log?.warn(`pond[${accountId}]: suppressing final reply but no runId available`);
+              }
+              return;
+            }
+            // Normal: final reply → chat message
             await client.sendMessage(config.org_id, chatId, {
               message_type: "text",
               content: { text: replyText },
@@ -320,10 +391,32 @@ export const pondGateway: ChannelGatewayAdapter<ResolvedPondAccount> = {
       const sessionKey = buildSessionKey(ctx.accountId, chatType, chatId);
       setSessionChatId(sessionKey, chatId);
 
+      // Start typing indicator immediately before any async work so the user
+      // sees feedback right away. Reference-counted for concurrent dispatches.
+      const existingDispatchEarly = activeDispatches.get(chatId);
+      if (existingDispatchEarly) {
+        existingDispatchEarly.count++;
+      } else {
+        if (ws.state === "connected") ws.sendTyping(chatId, "start");
+        // Frontend auto-clears typing after 3s, so refresh at 2s to avoid flicker
+        const typingRefresh = setInterval(() => {
+          if (ws.state === "connected") ws.sendTyping(chatId, "start");
+        }, 2000);
+        activeDispatches.set(chatId, { count: 1, typingTimer: typingRefresh });
+      }
+
+      // Fetch history with a 2s timeout — degrade gracefully to empty on slow API
+      const historyTimeout = new Promise<string>((resolve) => setTimeout(() => resolve(""), 2000));
+      const historyFetch = buildChatHistoryContext(
+        client, config.org_id, chatId, data.id, agentUserId, 30, log,
+        data.thread_root_id,
+      );
+      const historyPrefix = await Promise.race([historyFetch, historyTimeout]);
+
       // Build inbound context for OpenClaw agent
       const inboundCtx = core.channel.reply.finalizeInboundContext({
         Body: body,
-        BodyForAgent: body,
+        BodyForAgent: historyPrefix ? `${historyPrefix}${body}` : body,
         RawBody: body,
         CommandBody: body,
         ...mediaFields,
@@ -343,19 +436,8 @@ export const pondGateway: ChannelGatewayAdapter<ResolvedPondAccount> = {
         OriginatingTo: `pond:${chatId}`,
       });
 
-      // Manage typing indicator so the user sees the agent is working.
-      // Reference-counted: concurrent dispatches for the same chat share one timer.
-      const existingDispatch = activeDispatches.get(chatId);
-      if (existingDispatch) {
-        existingDispatch.count++;
-      } else {
-        if (ws.state === "connected") ws.sendTyping(chatId, "start");
-        // Frontend auto-clears typing after 3s, so refresh at 2s to avoid flicker
-        const typingRefresh = setInterval(() => {
-          if (ws.state === "connected") ws.sendTyping(chatId, "start");
-        }, 2000);
-        activeDispatches.set(chatId, { count: 1, typingTimer: typingRefresh });
-      }
+      // Extract no_reply hint from message
+      const noReply = data.hints?.no_reply ?? false;
 
       try {
         await dispatchToAgent({
@@ -369,6 +451,7 @@ export const pondGateway: ChannelGatewayAdapter<ResolvedPondAccount> = {
           chatId,
           messageId: data.id,
           inboundCtx,
+          noReply,
           log,
         });
       } finally {

package/src/hooks.ts

@@ -30,9 +30,13 @@ You have access to the Pond platform via the \`@pnds/cli\` CLI. Auth is pre-conf
 
 \`\`\`
 npx @pnds/cli@latest whoami                          # Check your identity
+npx @pnds/cli@latest agents list                     # List all agents (name, model, status)
+npx @pnds/cli@latest dm <name-or-id> --text "..."    # DM a user by name or ID (auto-creates chat)
+npx @pnds/cli@latest dm <name-or-id> --text "..." --no-reply  # DM, signal no reply expected
 npx @pnds/cli@latest chats list                      # List chats
 npx @pnds/cli@latest messages list <chatId>          # Read chat history
 npx @pnds/cli@latest messages send <chatId> --text "..." # Send a message
+npx @pnds/cli@latest messages send <chatId> --text "..." --no-reply  # Send, no reply expected
 npx @pnds/cli@latest tasks list [--status ...]       # List tasks
 npx @pnds/cli@latest tasks create --title "..."      # Create a task
 npx @pnds/cli@latest tasks update <taskId> --status in_progress
@@ -41,7 +45,14 @@ npx @pnds/cli@latest users search <query>            # Find users
 npx @pnds/cli@latest members list                    # List org members
 \`\`\`
 
-Run \`npx @pnds/cli@latest --help\` or \`npx @pnds/cli@latest <command> --help\` for full options. Output is JSON.`;
+Run \`npx @pnds/cli@latest --help\` or \`npx @pnds/cli@latest <command> --help\` for full options. Output is JSON.
+
+## Agent-to-Agent Interaction
+
+When you receive a message from another agent (not a human):
+- If the message has a no_reply hint, you may still reason and use tools, but your response will not be sent to chat.
+- If you have nothing meaningful to add to the conversation, produce an empty response to avoid unnecessary back-and-forth.
+- Use --no-reply when sending messages that don't require a response (e.g., delivering results, FYI notifications).`;
 
 export function registerPondHooks(api: OpenClawPluginApi) {
   const log = api.logger;