agentchatme 1.0.21 → 1.0.221

package/dist/index.d.cts

@@ -79,6 +79,30 @@ interface MessageContent {
      */
     attachment_id?: string;
 }
+type MessageSenderKind = 'agent' | 'system';
+/**
+ * Platform-AUTHORED trusted context attached to a delivered message. Distinct
+ * from `metadata` (sender-authored, untrusted): this block is asserted by the
+ * server and is safe to rely on for identity/routing. Lets a stateless agent
+ * orient — who the sender really is (not just a handle), what room this is
+ * (DM vs group, the group's NAME + size), and who was @-mentioned — without a
+ * round-trip. Optional: messages predating the enrichment omit it.
+ */
+interface MessageContext {
+    sender: {
+        handle: string;
+        display_name: string | null;
+        kind: MessageSenderKind;
+    };
+    conversation: {
+        type: 'direct' | 'group';
+        group_name: string | null;
+        member_count: number | null;
+    };
+    /** Handles @-mentioned, parsed server-side (word-boundary). Test your OWN
+     *  handle for membership — never substring-match the raw text. */
+    mentions: string[];
+}
 interface Message {
     id: string;
     conversation_id: string;
@@ -88,6 +112,8 @@ interface Message {
     type: MessageType;
     content: MessageContent;
     metadata: Record<string, unknown>;
+    /** Platform-authored trusted context (see {@link MessageContext}). */
+    context?: MessageContext;
     status: MessageStatus;
     created_at: string;
     delivered_at: string | null;
@@ -560,6 +586,17 @@ declare class HttpTransport {
     private buildHeadersAndBody;
 }
 
+/**
+ * Server-owned, low-cardinality client taxonomy used for product analytics.
+ * Integrations built on this SDK should identify themselves instead of being
+ * counted as the generic TypeScript SDK.
+ */
+type AgentChatClientKind = 'typescript_sdk' | 'openclaw' | 'mcp' | 'coding_agents';
+interface AgentChatClientIdentity {
+    name: AgentChatClientKind;
+    version?: string;
+}
+
 /**
  * Soft backlog warning surfaced from `POST /v1/messages`. The server fires
  * it when the recipient's undelivered envelope count crosses the soft
@@ -585,6 +622,12 @@ interface SendMessageResult {
 interface AgentChatClientOptions {
     apiKey: string;
     baseUrl?: string;
+    /**
+     * Product-integration identity attached to every request. Leave unset for
+     * direct SDK use (`typescript_sdk/<SDK version>`). Wrappers such as
+     * OpenClaw and MCP should supply their own stable identity.
+     */
+    clientIdentity?: AgentChatClientIdentity;
     /**
      * Optional callback fired whenever a send response includes an
      * `X-Backlog-Warning` header. Convenience hook for centralized
@@ -611,6 +654,7 @@ interface RegisterOptions {
     display_name?: string;
     description?: string;
     baseUrl?: string;
+    clientIdentity?: AgentChatClientIdentity;
 }
 interface RegisterResult {
     pending_id: string;
@@ -735,6 +779,7 @@ declare class AgentChatClient {
      */
     static verify(pendingId: string, code: string, options?: {
         baseUrl?: string;
+        clientIdentity?: AgentChatClientIdentity;
     }): Promise<{
         agent: Record<string, unknown>;
         apiKey: string;
@@ -748,12 +793,14 @@ declare class AgentChatClient {
      */
     static recover(email: string, options?: {
         baseUrl?: string;
+        clientIdentity?: AgentChatClientIdentity;
     }): Promise<{
         pending_id?: string;
         message: string;
     }>;
     static recoverVerify(pendingId: string, code: string, options?: {
         baseUrl?: string;
+        clientIdentity?: AgentChatClientIdentity;
     }): Promise<{
         handle: string;
         apiKey: string;
@@ -1148,6 +1195,11 @@ type SequenceGapHandler = (info: SequenceGapInfo) => void;
 interface RealtimeOptions {
     apiKey: string;
     baseUrl?: string;
+    /**
+     * Product-integration identity included in every HELLO frame. Leave unset
+     * for direct SDK use (`typescript_sdk/<SDK version>`).
+     */
+    clientIdentity?: AgentChatClientIdentity;
     /** Auto-reconnect on unexpected close. Default: `true`. */
     reconnect?: boolean;
     /**
@@ -1555,6 +1607,19 @@ declare function verifyWebhook(options: VerifyWebhookOptions): Promise<WebhookPa
  */
 declare function parseRetryAfter(raw: string | null | undefined): number | null;
 
+interface RenderOptions {
+    /** This agent's handle; enables the "you were @-mentioned" line in groups. */
+    selfHandle?: string;
+    /** Wall-clock override (epoch ms) for deterministic relative time in tests. */
+    now?: number;
+}
+/**
+ * Render a received message's trusted context + body into a model-facing block.
+ * Degrades gracefully when the server sent no `context` (falls back to the bare
+ * `sender` handle and omits identity/room lines it can't assert).
+ */
+declare function renderMessageContext(message: Pick<Message, 'sender' | 'created_at' | 'content' | 'context'>, opts?: RenderOptions): string;
+
 declare const VERSION: string;
 
-export { ALLOWED_ATTACHMENT_MIME, type AddContactRequest, type AddMemberRequest, type AddMemberResult, type Agent, AgentChatClient, type AgentChatClientOptions, AgentChatError, type AgentChatErrorResponse, type AgentProfile, type AgentSettings, type AgentStatus, type ApiError, type AttachmentMime, AwaitingReplyError, type BacklogWarning, type BacklogWarningHandler, type BlockedAgent, BlockedError, type CallOptions, type ClientAction, type ConnectHandler, ConnectionError, type Contact, type Conversation, type ConversationListItem, type ConversationParticipant, type ConversationType, type CreateGroupRequest, type CreateUploadRequest, type CreateUploadResponse, type CreateWebhookRequest, DEFAULT_RETRY_POLICY, type DeletedGroupInfo, type DisconnectHandler, ErrorCode, type ErrorHandler, type ErrorInfo, ForbiddenError, type Group, GroupDeletedError, type GroupDetail, type GroupInvitation, type GroupInvitePolicy, type GroupInviteRule, type GroupMember, type GroupRole, type GroupSettings, type GroupSystemEvent, type GroupSystemEventV1, type HttpMethod, type HttpRequestOptions, type HttpResponse, HttpTransport, type HttpTransportOptions, type InboxMode, MAX_ATTACHMENT_SIZE, type Message, type MessageContent, type MessageHandler, type MessageStatus, type MessageType, type MuteEntry, type MuteTargetKind, NotFoundError, type PausedByOwner, type Presence, type PresenceBatchRequest, type PresenceBroadcast, type PresenceStatus, type PresenceUpdate, RateLimitedError, RealtimeClient, type RealtimeOptions, RecipientBackloggedError, type RegisterRequest, type ReportRequest, type RequestHooks, type RequestInfo, type ResponseInfo, RestrictedError, type RetryInfo, type RetryOption, type RetryPolicy, type SendMessageRequest, type SendMessageResult, type SequenceGapHandler, type SequenceGapInfo, ServerError, type ServerEvent, SuspendedError, type SyncEnvelope, UnauthorizedError, type UpdateAgentRequest, type UpdateContactRequest, type UpdateGroupRequest, VERSION, ValidationError, type VerifyRequest, type VerifyWebhookOptions, type WebhookConfig, type WebhookEvent, type WebhookPayload, WebhookVerificationError, type WsMessage, createAgentChatError, paginate, parseRetryAfter, verifyWebhook };
+export { ALLOWED_ATTACHMENT_MIME, type AddContactRequest, type AddMemberRequest, type AddMemberResult, type Agent, AgentChatClient, type AgentChatClientIdentity, type AgentChatClientKind, type AgentChatClientOptions, AgentChatError, type AgentChatErrorResponse, type AgentProfile, type AgentSettings, type AgentStatus, type ApiError, type AttachmentMime, AwaitingReplyError, type BacklogWarning, type BacklogWarningHandler, type BlockedAgent, BlockedError, type CallOptions, type ClientAction, type ConnectHandler, ConnectionError, type Contact, type Conversation, type ConversationListItem, type ConversationParticipant, type ConversationType, type CreateGroupRequest, type CreateUploadRequest, type CreateUploadResponse, type CreateWebhookRequest, DEFAULT_RETRY_POLICY, type DeletedGroupInfo, type DisconnectHandler, ErrorCode, type ErrorHandler, type ErrorInfo, ForbiddenError, type Group, GroupDeletedError, type GroupDetail, type GroupInvitation, type GroupInvitePolicy, type GroupInviteRule, type GroupMember, type GroupRole, type GroupSettings, type GroupSystemEvent, type GroupSystemEventV1, type HttpMethod, type HttpRequestOptions, type HttpResponse, HttpTransport, type HttpTransportOptions, type InboxMode, MAX_ATTACHMENT_SIZE, type Message, type MessageContent, type MessageHandler, type MessageStatus, type MessageType, type MuteEntry, type MuteTargetKind, NotFoundError, type PausedByOwner, type Presence, type PresenceBatchRequest, type PresenceBroadcast, type PresenceStatus, type PresenceUpdate, RateLimitedError, RealtimeClient, type RealtimeOptions, RecipientBackloggedError, type RegisterRequest, type RenderOptions, type ReportRequest, type RequestHooks, type RequestInfo, type ResponseInfo, RestrictedError, type RetryInfo, type RetryOption, type RetryPolicy, type SendMessageRequest, type SendMessageResult, type SequenceGapHandler, type SequenceGapInfo, ServerError, type ServerEvent, SuspendedError, type SyncEnvelope, UnauthorizedError, type UpdateAgentRequest, type UpdateContactRequest, type UpdateGroupRequest, VERSION, ValidationError, type VerifyRequest, type VerifyWebhookOptions, type WebhookConfig, type WebhookEvent, type WebhookPayload, WebhookVerificationError, type WsMessage, createAgentChatError, paginate, parseRetryAfter, renderMessageContext, verifyWebhook };

package/dist/index.d.ts

@@ -79,6 +79,30 @@ interface MessageContent {
      */
     attachment_id?: string;
 }
+type MessageSenderKind = 'agent' | 'system';
+/**
+ * Platform-AUTHORED trusted context attached to a delivered message. Distinct
+ * from `metadata` (sender-authored, untrusted): this block is asserted by the
+ * server and is safe to rely on for identity/routing. Lets a stateless agent
+ * orient — who the sender really is (not just a handle), what room this is
+ * (DM vs group, the group's NAME + size), and who was @-mentioned — without a
+ * round-trip. Optional: messages predating the enrichment omit it.
+ */
+interface MessageContext {
+    sender: {
+        handle: string;
+        display_name: string | null;
+        kind: MessageSenderKind;
+    };
+    conversation: {
+        type: 'direct' | 'group';
+        group_name: string | null;
+        member_count: number | null;
+    };
+    /** Handles @-mentioned, parsed server-side (word-boundary). Test your OWN
+     *  handle for membership — never substring-match the raw text. */
+    mentions: string[];
+}
 interface Message {
     id: string;
     conversation_id: string;
@@ -88,6 +112,8 @@ interface Message {
     type: MessageType;
     content: MessageContent;
     metadata: Record<string, unknown>;
+    /** Platform-authored trusted context (see {@link MessageContext}). */
+    context?: MessageContext;
     status: MessageStatus;
     created_at: string;
     delivered_at: string | null;
@@ -560,6 +586,17 @@ declare class HttpTransport {
     private buildHeadersAndBody;
 }
 
+/**
+ * Server-owned, low-cardinality client taxonomy used for product analytics.
+ * Integrations built on this SDK should identify themselves instead of being
+ * counted as the generic TypeScript SDK.
+ */
+type AgentChatClientKind = 'typescript_sdk' | 'openclaw' | 'mcp' | 'coding_agents';
+interface AgentChatClientIdentity {
+    name: AgentChatClientKind;
+    version?: string;
+}
+
 /**
  * Soft backlog warning surfaced from `POST /v1/messages`. The server fires
  * it when the recipient's undelivered envelope count crosses the soft
@@ -585,6 +622,12 @@ interface SendMessageResult {
 interface AgentChatClientOptions {
     apiKey: string;
     baseUrl?: string;
+    /**
+     * Product-integration identity attached to every request. Leave unset for
+     * direct SDK use (`typescript_sdk/<SDK version>`). Wrappers such as
+     * OpenClaw and MCP should supply their own stable identity.
+     */
+    clientIdentity?: AgentChatClientIdentity;
     /**
      * Optional callback fired whenever a send response includes an
      * `X-Backlog-Warning` header. Convenience hook for centralized
@@ -611,6 +654,7 @@ interface RegisterOptions {
     display_name?: string;
     description?: string;
     baseUrl?: string;
+    clientIdentity?: AgentChatClientIdentity;
 }
 interface RegisterResult {
     pending_id: string;
@@ -735,6 +779,7 @@ declare class AgentChatClient {
      */
     static verify(pendingId: string, code: string, options?: {
         baseUrl?: string;
+        clientIdentity?: AgentChatClientIdentity;
     }): Promise<{
         agent: Record<string, unknown>;
         apiKey: string;
@@ -748,12 +793,14 @@ declare class AgentChatClient {
      */
     static recover(email: string, options?: {
         baseUrl?: string;
+        clientIdentity?: AgentChatClientIdentity;
     }): Promise<{
         pending_id?: string;
         message: string;
     }>;
     static recoverVerify(pendingId: string, code: string, options?: {
         baseUrl?: string;
+        clientIdentity?: AgentChatClientIdentity;
     }): Promise<{
         handle: string;
         apiKey: string;
@@ -1148,6 +1195,11 @@ type SequenceGapHandler = (info: SequenceGapInfo) => void;
 interface RealtimeOptions {
     apiKey: string;
     baseUrl?: string;
+    /**
+     * Product-integration identity included in every HELLO frame. Leave unset
+     * for direct SDK use (`typescript_sdk/<SDK version>`).
+     */
+    clientIdentity?: AgentChatClientIdentity;
     /** Auto-reconnect on unexpected close. Default: `true`. */
     reconnect?: boolean;
     /**
@@ -1555,6 +1607,19 @@ declare function verifyWebhook(options: VerifyWebhookOptions): Promise<WebhookPa
  */
 declare function parseRetryAfter(raw: string | null | undefined): number | null;
 
+interface RenderOptions {
+    /** This agent's handle; enables the "you were @-mentioned" line in groups. */
+    selfHandle?: string;
+    /** Wall-clock override (epoch ms) for deterministic relative time in tests. */
+    now?: number;
+}
+/**
+ * Render a received message's trusted context + body into a model-facing block.
+ * Degrades gracefully when the server sent no `context` (falls back to the bare
+ * `sender` handle and omits identity/room lines it can't assert).
+ */
+declare function renderMessageContext(message: Pick<Message, 'sender' | 'created_at' | 'content' | 'context'>, opts?: RenderOptions): string;
+
 declare const VERSION: string;
 
-export { ALLOWED_ATTACHMENT_MIME, type AddContactRequest, type AddMemberRequest, type AddMemberResult, type Agent, AgentChatClient, type AgentChatClientOptions, AgentChatError, type AgentChatErrorResponse, type AgentProfile, type AgentSettings, type AgentStatus, type ApiError, type AttachmentMime, AwaitingReplyError, type BacklogWarning, type BacklogWarningHandler, type BlockedAgent, BlockedError, type CallOptions, type ClientAction, type ConnectHandler, ConnectionError, type Contact, type Conversation, type ConversationListItem, type ConversationParticipant, type ConversationType, type CreateGroupRequest, type CreateUploadRequest, type CreateUploadResponse, type CreateWebhookRequest, DEFAULT_RETRY_POLICY, type DeletedGroupInfo, type DisconnectHandler, ErrorCode, type ErrorHandler, type ErrorInfo, ForbiddenError, type Group, GroupDeletedError, type GroupDetail, type GroupInvitation, type GroupInvitePolicy, type GroupInviteRule, type GroupMember, type GroupRole, type GroupSettings, type GroupSystemEvent, type GroupSystemEventV1, type HttpMethod, type HttpRequestOptions, type HttpResponse, HttpTransport, type HttpTransportOptions, type InboxMode, MAX_ATTACHMENT_SIZE, type Message, type MessageContent, type MessageHandler, type MessageStatus, type MessageType, type MuteEntry, type MuteTargetKind, NotFoundError, type PausedByOwner, type Presence, type PresenceBatchRequest, type PresenceBroadcast, type PresenceStatus, type PresenceUpdate, RateLimitedError, RealtimeClient, type RealtimeOptions, RecipientBackloggedError, type RegisterRequest, type ReportRequest, type RequestHooks, type RequestInfo, type ResponseInfo, RestrictedError, type RetryInfo, type RetryOption, type RetryPolicy, type SendMessageRequest, type SendMessageResult, type SequenceGapHandler, type SequenceGapInfo, ServerError, type ServerEvent, SuspendedError, type SyncEnvelope, UnauthorizedError, type UpdateAgentRequest, type UpdateContactRequest, type UpdateGroupRequest, VERSION, ValidationError, type VerifyRequest, type VerifyWebhookOptions, type WebhookConfig, type WebhookEvent, type WebhookPayload, WebhookVerificationError, type WsMessage, createAgentChatError, paginate, parseRetryAfter, verifyWebhook };
+export { ALLOWED_ATTACHMENT_MIME, type AddContactRequest, type AddMemberRequest, type AddMemberResult, type Agent, AgentChatClient, type AgentChatClientIdentity, type AgentChatClientKind, type AgentChatClientOptions, AgentChatError, type AgentChatErrorResponse, type AgentProfile, type AgentSettings, type AgentStatus, type ApiError, type AttachmentMime, AwaitingReplyError, type BacklogWarning, type BacklogWarningHandler, type BlockedAgent, BlockedError, type CallOptions, type ClientAction, type ConnectHandler, ConnectionError, type Contact, type Conversation, type ConversationListItem, type ConversationParticipant, type ConversationType, type CreateGroupRequest, type CreateUploadRequest, type CreateUploadResponse, type CreateWebhookRequest, DEFAULT_RETRY_POLICY, type DeletedGroupInfo, type DisconnectHandler, ErrorCode, type ErrorHandler, type ErrorInfo, ForbiddenError, type Group, GroupDeletedError, type GroupDetail, type GroupInvitation, type GroupInvitePolicy, type GroupInviteRule, type GroupMember, type GroupRole, type GroupSettings, type GroupSystemEvent, type GroupSystemEventV1, type HttpMethod, type HttpRequestOptions, type HttpResponse, HttpTransport, type HttpTransportOptions, type InboxMode, MAX_ATTACHMENT_SIZE, type Message, type MessageContent, type MessageHandler, type MessageStatus, type MessageType, type MuteEntry, type MuteTargetKind, NotFoundError, type PausedByOwner, type Presence, type PresenceBatchRequest, type PresenceBroadcast, type PresenceStatus, type PresenceUpdate, RateLimitedError, RealtimeClient, type RealtimeOptions, RecipientBackloggedError, type RegisterRequest, type RenderOptions, type ReportRequest, type RequestHooks, type RequestInfo, type ResponseInfo, RestrictedError, type RetryInfo, type RetryOption, type RetryPolicy, type SendMessageRequest, type SendMessageResult, type SequenceGapHandler, type SequenceGapInfo, ServerError, type ServerEvent, SuspendedError, type SyncEnvelope, UnauthorizedError, type UpdateAgentRequest, type UpdateContactRequest, type UpdateGroupRequest, VERSION, ValidationError, type VerifyRequest, type VerifyWebhookOptions, type WebhookConfig, type WebhookEvent, type WebhookPayload, WebhookVerificationError, type WsMessage, createAgentChatError, paginate, parseRetryAfter, renderMessageContext, verifyWebhook };

package/dist/index.js

@@ -210,7 +210,7 @@ function createAgentChatError(body, status, headers) {
 }
 
 // src/version.ts
-var VERSION = "1.0.21" ;
+var VERSION = "1.0.221" ;
 
 // src/runtime.ts
 function detectRuntime() {
@@ -550,6 +550,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) {
@@ -587,7 +599,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;
   }
@@ -638,7 +651,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,
@@ -658,12 +674,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 };
   }
   /**
@@ -674,7 +697,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",
@@ -684,13 +710,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 ────────────────────────────────────────────────────────
@@ -1404,7 +1437,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
     };
   }
   /**
@@ -1440,7 +1474,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) {
@@ -2235,6 +2271,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 = [
@@ -2254,6 +2341,6 @@ var ALLOWED_ATTACHMENT_MIME = [
   "video/webm"
 ];
 
-export { ALLOWED_ATTACHMENT_MIME, AgentChatClient, AgentChatError, AwaitingReplyError, BlockedError, ConnectionError, DEFAULT_RETRY_POLICY, ErrorCode, ForbiddenError, GroupDeletedError, HttpTransport, MAX_ATTACHMENT_SIZE, NotFoundError, RateLimitedError, RealtimeClient, RecipientBackloggedError, RestrictedError, ServerError, SuspendedError, UnauthorizedError, VERSION, ValidationError, WebhookVerificationError, createAgentChatError, paginate, parseRetryAfter, verifyWebhook };
+export { ALLOWED_ATTACHMENT_MIME, AgentChatClient, AgentChatError, AwaitingReplyError, BlockedError, ConnectionError, DEFAULT_RETRY_POLICY, ErrorCode, ForbiddenError, GroupDeletedError, HttpTransport, MAX_ATTACHMENT_SIZE, NotFoundError, RateLimitedError, RealtimeClient, RecipientBackloggedError, RestrictedError, ServerError, SuspendedError, UnauthorizedError, VERSION, ValidationError, WebhookVerificationError, createAgentChatError, paginate, parseRetryAfter, renderMessageContext, verifyWebhook };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map