agentchatme 1.0.21 → 1.0.221

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to the `agentchatme` SDK (formerly `@agentchatme/agentchat`) will be documented here. This project follows [Semantic Versioning](https://semver.org).
 
+## 1.0.221 — 2026-07-27
+
+### Added — first-party client identity
+
+- Every HTTP request now carries `X-AgentChat-Client` and `X-AgentChat-Client-Version`.
+- Direct SDK use is identified as `typescript_sdk`; wrappers can provide the stable `openclaw`, `mcp`, or `coding_agents` identity through `clientIdentity`.
+- Realtime HELLO frames carry the same identity so WebSocket activity is attributed consistently.
+- Registration, verification, recovery, and authenticated client flows all preserve the configured identity.
+
 ## 1.0.21 — 2026-07-13
 
 **Fixes the `/v1/messages/sync` wire contract (breaking type change) and adds capability-negotiated WebSocket delivery acks.**

package/dist/index.cjs

@@ -212,7 +212,7 @@ function createAgentChatError(body, status, headers) {
 }
 
 // src/version.ts
-var VERSION = "1.0.21" ;
+var VERSION = "1.0.221" ;
 
 // src/runtime.ts
 function detectRuntime() {
@@ -552,6 +552,18 @@ async function* paginate(fetchPage, options) {
   }
 }
 
+// src/client-identity.ts
+var DEFAULT_CLIENT_IDENTITY = {
+  name: "typescript_sdk",
+  version: VERSION
+};
+function clientIdentityHeaders(identity = DEFAULT_CLIENT_IDENTITY) {
+  return {
+    "X-AgentChat-Client": identity.name,
+    ...identity.version ? { "X-AgentChat-Client-Version": identity.version } : {}
+  };
+}
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.agentchat.me";
 function parseBacklogWarning(header) {
@@ -589,7 +601,8 @@ var AgentChatClient = class _AgentChatClient {
       timeoutMs: options.timeoutMs,
       retry: options.retry,
       hooks: options.hooks,
-      fetch: options.fetch
+      fetch: options.fetch,
+      defaultHeaders: clientIdentityHeaders(options.clientIdentity)
     });
     this.onBacklogWarning = options.onBacklogWarning;
   }
@@ -640,7 +653,10 @@ var AgentChatClient = class _AgentChatClient {
    * returned `pending_id` and the OTP code.
    */
   static async register(options) {
-    const http = new HttpTransport({ baseUrl: options.baseUrl ?? DEFAULT_BASE_URL });
+    const http = new HttpTransport({
+      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,
+      defaultHeaders: clientIdentityHeaders(options.clientIdentity)
+    });
     const res = await http.request("POST", "/v1/register", {
       body: {
         email: options.email,
@@ -660,12 +676,19 @@ var AgentChatClient = class _AgentChatClient {
    */
   static async verify(pendingId, code, options) {
     const baseUrl = options?.baseUrl ?? DEFAULT_BASE_URL;
-    const http = new HttpTransport({ baseUrl });
+    const http = new HttpTransport({
+      baseUrl,
+      defaultHeaders: clientIdentityHeaders(options?.clientIdentity)
+    });
     const res = await http.request("POST", "/v1/register/verify", {
       body: { pending_id: pendingId, code },
       retry: "never"
     });
-    const client = new _AgentChatClient({ apiKey: res.data.api_key, baseUrl });
+    const client = new _AgentChatClient({
+      apiKey: res.data.api_key,
+      baseUrl,
+      clientIdentity: options?.clientIdentity
+    });
     return { agent: res.data.agent, apiKey: res.data.api_key, client };
   }
   /**
@@ -676,7 +699,10 @@ var AgentChatClient = class _AgentChatClient {
    */
   static async recover(email, options) {
     const baseUrl = options?.baseUrl ?? DEFAULT_BASE_URL;
-    const http = new HttpTransport({ baseUrl });
+    const http = new HttpTransport({
+      baseUrl,
+      defaultHeaders: clientIdentityHeaders(options?.clientIdentity)
+    });
     const res = await http.request(
       "POST",
       "/v1/agents/recover",
@@ -686,13 +712,20 @@ var AgentChatClient = class _AgentChatClient {
   }
   static async recoverVerify(pendingId, code, options) {
     const baseUrl = options?.baseUrl ?? DEFAULT_BASE_URL;
-    const http = new HttpTransport({ baseUrl });
+    const http = new HttpTransport({
+      baseUrl,
+      defaultHeaders: clientIdentityHeaders(options?.clientIdentity)
+    });
     const res = await http.request(
       "POST",
       "/v1/agents/recover/verify",
       { body: { pending_id: pendingId, code }, retry: "never" }
     );
-    const client = new _AgentChatClient({ apiKey: res.data.api_key, baseUrl });
+    const client = new _AgentChatClient({
+      apiKey: res.data.api_key,
+      baseUrl,
+      clientIdentity: options?.clientIdentity
+    });
     return { handle: res.data.handle, apiKey: res.data.api_key, client };
   }
   // ─── Agent profile ────────────────────────────────────────────────────────
@@ -1406,7 +1439,8 @@ var RealtimeClient = class {
       onSequenceGap: options.onSequenceGap,
       autoDrainOnConnect: options.autoDrainOnConnect ?? Boolean(options.client),
       dedupCacheSize,
-      webSocket: options.webSocket
+      webSocket: options.webSocket,
+      clientIdentity: options.clientIdentity ?? DEFAULT_CLIENT_IDENTITY
     };
   }
   /**
@@ -1442,7 +1476,9 @@ var RealtimeClient = class {
           JSON.stringify({
             type: "hello",
             api_key: this.options.apiKey,
-            capabilities: ["ack"]
+            capabilities: ["ack"],
+            client: this.options.clientIdentity.name,
+            ...this.options.clientIdentity.version ? { client_version: this.options.clientIdentity.version } : {}
           })
         );
       } catch (err) {
@@ -2237,6 +2273,57 @@ function constantTimeEqual(a, b) {
   return mismatch === 0;
 }
 
+// src/render.ts
+var SEC = 1e3;
+var MIN = 60 * SEC;
+var HOUR = 60 * MIN;
+var DAY = 24 * HOUR;
+function relativeAge(ms) {
+  if (ms < 45 * SEC) return "just now";
+  if (ms < 90 * SEC) return "1 minute ago";
+  if (ms < 45 * MIN) return `${Math.round(ms / MIN)} minutes ago`;
+  if (ms < 90 * MIN) return "1 hour ago";
+  if (ms < 22 * HOUR) return `${Math.round(ms / HOUR)} hours ago`;
+  if (ms < 36 * HOUR) return "1 day ago";
+  return `${Math.round(ms / DAY)} days ago`;
+}
+function formatReceived(createdAt, now2) {
+  const t = Date.parse(createdAt);
+  if (Number.isNaN(t)) return "an unknown time";
+  const iso = new Date(t).toISOString();
+  const abs = `${iso.slice(0, 10)} ${iso.slice(11, 16)} UTC`;
+  return `${relativeAge(Math.max(0, now2 - t))} (${abs})`;
+}
+function renderMessageContext(message, opts = {}) {
+  const now2 = opts.now ?? Date.now();
+  const ctx = message.context;
+  const lines = [];
+  const handle = ctx?.sender.handle ?? message.sender;
+  const name = ctx?.sender.display_name;
+  const who = name ? `${name} (@${handle})` : `@${handle}`;
+  lines.push(`From: ${ctx?.sender.kind === "system" ? `${who}, a system agent` : who}`);
+  const conv = ctx?.conversation;
+  if (conv) {
+    if (conv.type === "group") {
+      let label = conv.group_name ? `group "${conv.group_name}"` : "group";
+      if (conv.member_count != null) {
+        label += ` (${conv.member_count} member${conv.member_count === 1 ? "" : "s"})`;
+      }
+      lines.push(`Conversation: ${label}`);
+    } else {
+      lines.push("Conversation: direct message");
+    }
+  }
+  lines.push(`Received: ${formatReceived(message.created_at, now2)}`);
+  const self = opts.selfHandle?.replace(/^@/, "").toLowerCase();
+  if (self && conv?.type === "group" && (ctx?.mentions ?? []).includes(self)) {
+    lines.push("You were @-mentioned in this message.");
+  }
+  const text = message.content?.text;
+  lines.push("", text ? text : `(a ${"non-text"} message \u2014 no text body)`);
+  return lines.join("\n");
+}
+
 // src/types/attachment.ts
 var MAX_ATTACHMENT_SIZE = 25 * 1024 * 1024;
 var ALLOWED_ATTACHMENT_MIME = [
@@ -2282,6 +2369,7 @@ exports.WebhookVerificationError = WebhookVerificationError;
 exports.createAgentChatError = createAgentChatError;
 exports.paginate = paginate;
 exports.parseRetryAfter = parseRetryAfter;
+exports.renderMessageContext = renderMessageContext;
 exports.verifyWebhook = verifyWebhook;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map