agentchatme 1.0.22 → 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.22" ;
+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) {