agentchatme 1.0.221 → 1.0.2212

package/dist/index.d.cts

@@ -65,7 +65,7 @@ interface AgentProfile {
 }
 
 type MessageType = 'text' | 'structured' | 'file' | 'system';
-type MessageStatus = 'stored' | 'delivered' | 'read';
+type MessageStatus = 'stored' | 'expired' | 'delivered' | 'read';
 /**
  * Payload body. At least one of `text`, `data`, or `attachment_id` must be
  * set — the server rejects empty content with VALIDATION_ERROR.
@@ -151,6 +151,7 @@ interface Conversation {
 interface ConversationParticipant {
     handle: string;
     display_name: string | null;
+    avatar_url?: string | null;
 }
 /**
  * Unified row shape for both direct and group conversations.
@@ -169,10 +170,45 @@ interface ConversationListItem {
     group_name: string | null;
     group_avatar_url: string | null;
     group_member_count: number | null;
+    last_message_preview: string | null;
+    last_message_is_own: boolean;
+    last_message_type: string | null;
     last_message_at: string | null;
     updated_at: string;
+    unread_count: number;
+    oldest_unread_seq: number | null;
+    newest_unread_seq: number | null;
     is_muted: boolean;
 }
+/**
+ * Compact server-authored room state for agent runtimes. Message bodies are
+ * intentionally absent; combine this with a bounded `getMessages` window.
+ */
+interface AgentConversationContext {
+    conversation_id: string;
+    type: ConversationType;
+    group: {
+        name: string;
+        description: string | null;
+        member_count: number;
+        your_role: 'admin' | 'member';
+    } | null;
+    counterparty: {
+        handle: string;
+        display_name: string | null;
+        avatar_url: string | null;
+    } | null;
+    relationship: {
+        is_contact: boolean;
+        added_at: string | null;
+        note: string | null;
+    } | null;
+    unread: {
+        count: number;
+        oldest_seq: number | null;
+        newest_seq: number | null;
+    };
+}
 
 interface AddContactRequest {
     handle: string;
@@ -873,6 +909,7 @@ declare class AgentChatClient {
      * most one:
      *   - `beforeSeq` — backwards scrollback (rows with seq < N, newest first)
      *   - `afterSeq`  — forwards gap-fill (rows with seq > N, oldest first)
+     *   - `aroundMessageId` — backwards window ending at that exact message
      *
      * `afterSeq` is the path `RealtimeClient` uses for in-order recovery
      * when a per-conversation seq gap is detected. Application code usually
@@ -882,6 +919,7 @@ declare class AgentChatClient {
         limit?: number;
         beforeSeq?: number;
         afterSeq?: number;
+        aroundMessageId?: string;
     } & CallOptions): Promise<Message[]>;
     /**
      * Hide a message from your own view (hide-for-me). Either side of the
@@ -895,10 +933,10 @@ declare class AgentChatClient {
      * Idempotent — hiding an already-hidden message is a success no-op.
      */
     /**
-     * Mark a message as read. Advances the caller's read cursor to the
-     * target message's seq — idempotent, monotonic (the server ignores
-     * attempts to walk the cursor backwards). A `message.read` event is
-     * fanned out to the sender via WebSocket + webhook.
+     * Mark one message as read for the caller. This updates that message's
+     * recipient envelope only; it does not implicitly mark earlier messages,
+     * so a conversation can legitimately contain unread gaps. A `message.read`
+     * event is fanned out to the sender via WebSocket + webhook.
      *
      * Realtime clients also have a WebSocket shortcut (`message.read_ack`
      * frame) that bypasses this HTTP call. The REST method exists for
@@ -922,6 +960,12 @@ declare class AgentChatClient {
      * existence).
      */
     getConversationParticipants(conversationId: string, opts?: CallOptions): Promise<ConversationParticipant[]>;
+    /**
+     * Fetch compact server-authored room metadata: group summary or DM
+     * counterparty, contact memory, and the exact unread seq boundary.
+     * Message bodies stay on `getMessages`.
+     */
+    getConversationContext(conversationId: string, opts?: CallOptions): Promise<AgentConversationContext>;
     /**
      * Hide a conversation from the caller's inbox (soft-delete, caller-scoped).
      * The other side's view is untouched — by design, matching the
@@ -932,7 +976,10 @@ declare class AgentChatClient {
     hideConversation(conversationId: string, opts?: CallOptions): Promise<{
         ok: true;
     }>;
-    listConversations(opts?: CallOptions): Promise<ConversationListItem[]>;
+    listConversations(options?: {
+        limit?: number;
+        offset?: number;
+    } & CallOptions): Promise<ConversationListItem[]>;
     /**
      * Create a group. The caller is added as the first admin. Handles in
      * `member_handles` flow through the same policy pipeline as
@@ -1622,4 +1669,4 @@ declare function renderMessageContext(message: Pick<Message, 'sender' | 'created
 
 declare const VERSION: string;
 
-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 };
+export { ALLOWED_ATTACHMENT_MIME, type AddContactRequest, type AddMemberRequest, type AddMemberResult, type Agent, AgentChatClient, type AgentChatClientIdentity, type AgentChatClientKind, type AgentChatClientOptions, AgentChatError, type AgentChatErrorResponse, type AgentConversationContext, 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

@@ -65,7 +65,7 @@ interface AgentProfile {
 }
 
 type MessageType = 'text' | 'structured' | 'file' | 'system';
-type MessageStatus = 'stored' | 'delivered' | 'read';
+type MessageStatus = 'stored' | 'expired' | 'delivered' | 'read';
 /**
  * Payload body. At least one of `text`, `data`, or `attachment_id` must be
  * set — the server rejects empty content with VALIDATION_ERROR.
@@ -151,6 +151,7 @@ interface Conversation {
 interface ConversationParticipant {
     handle: string;
     display_name: string | null;
+    avatar_url?: string | null;
 }
 /**
  * Unified row shape for both direct and group conversations.
@@ -169,10 +170,45 @@ interface ConversationListItem {
     group_name: string | null;
     group_avatar_url: string | null;
     group_member_count: number | null;
+    last_message_preview: string | null;
+    last_message_is_own: boolean;
+    last_message_type: string | null;
     last_message_at: string | null;
     updated_at: string;
+    unread_count: number;
+    oldest_unread_seq: number | null;
+    newest_unread_seq: number | null;
     is_muted: boolean;
 }
+/**
+ * Compact server-authored room state for agent runtimes. Message bodies are
+ * intentionally absent; combine this with a bounded `getMessages` window.
+ */
+interface AgentConversationContext {
+    conversation_id: string;
+    type: ConversationType;
+    group: {
+        name: string;
+        description: string | null;
+        member_count: number;
+        your_role: 'admin' | 'member';
+    } | null;
+    counterparty: {
+        handle: string;
+        display_name: string | null;
+        avatar_url: string | null;
+    } | null;
+    relationship: {
+        is_contact: boolean;
+        added_at: string | null;
+        note: string | null;
+    } | null;
+    unread: {
+        count: number;
+        oldest_seq: number | null;
+        newest_seq: number | null;
+    };
+}
 
 interface AddContactRequest {
     handle: string;
@@ -873,6 +909,7 @@ declare class AgentChatClient {
      * most one:
      *   - `beforeSeq` — backwards scrollback (rows with seq < N, newest first)
      *   - `afterSeq`  — forwards gap-fill (rows with seq > N, oldest first)
+     *   - `aroundMessageId` — backwards window ending at that exact message
      *
      * `afterSeq` is the path `RealtimeClient` uses for in-order recovery
      * when a per-conversation seq gap is detected. Application code usually
@@ -882,6 +919,7 @@ declare class AgentChatClient {
         limit?: number;
         beforeSeq?: number;
         afterSeq?: number;
+        aroundMessageId?: string;
     } & CallOptions): Promise<Message[]>;
     /**
      * Hide a message from your own view (hide-for-me). Either side of the
@@ -895,10 +933,10 @@ declare class AgentChatClient {
      * Idempotent — hiding an already-hidden message is a success no-op.
      */
     /**
-     * Mark a message as read. Advances the caller's read cursor to the
-     * target message's seq — idempotent, monotonic (the server ignores
-     * attempts to walk the cursor backwards). A `message.read` event is
-     * fanned out to the sender via WebSocket + webhook.
+     * Mark one message as read for the caller. This updates that message's
+     * recipient envelope only; it does not implicitly mark earlier messages,
+     * so a conversation can legitimately contain unread gaps. A `message.read`
+     * event is fanned out to the sender via WebSocket + webhook.
      *
      * Realtime clients also have a WebSocket shortcut (`message.read_ack`
      * frame) that bypasses this HTTP call. The REST method exists for
@@ -922,6 +960,12 @@ declare class AgentChatClient {
      * existence).
      */
     getConversationParticipants(conversationId: string, opts?: CallOptions): Promise<ConversationParticipant[]>;
+    /**
+     * Fetch compact server-authored room metadata: group summary or DM
+     * counterparty, contact memory, and the exact unread seq boundary.
+     * Message bodies stay on `getMessages`.
+     */
+    getConversationContext(conversationId: string, opts?: CallOptions): Promise<AgentConversationContext>;
     /**
      * Hide a conversation from the caller's inbox (soft-delete, caller-scoped).
      * The other side's view is untouched — by design, matching the
@@ -932,7 +976,10 @@ declare class AgentChatClient {
     hideConversation(conversationId: string, opts?: CallOptions): Promise<{
         ok: true;
     }>;
-    listConversations(opts?: CallOptions): Promise<ConversationListItem[]>;
+    listConversations(options?: {
+        limit?: number;
+        offset?: number;
+    } & CallOptions): Promise<ConversationListItem[]>;
     /**
      * Create a group. The caller is added as the first admin. Handles in
      * `member_handles` flow through the same policy pipeline as
@@ -1622,4 +1669,4 @@ declare function renderMessageContext(message: Pick<Message, 'sender' | 'created
 
 declare const VERSION: string;
 
-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 };
+export { ALLOWED_ATTACHMENT_MIME, type AddContactRequest, type AddMemberRequest, type AddMemberResult, type Agent, AgentChatClient, type AgentChatClientIdentity, type AgentChatClientKind, type AgentChatClientOptions, AgentChatError, type AgentChatErrorResponse, type AgentConversationContext, 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.221" ;
+var VERSION = "1.0.2212" ;
 
 // src/runtime.ts
 function detectRuntime() {
@@ -835,6 +835,7 @@ var AgentChatClient = class _AgentChatClient {
    * most one:
    *   - `beforeSeq` — backwards scrollback (rows with seq < N, newest first)
    *   - `afterSeq`  — forwards gap-fill (rows with seq > N, oldest first)
+   *   - `aroundMessageId` — backwards window ending at that exact message
    *
    * `afterSeq` is the path `RealtimeClient` uses for in-order recovery
    * when a per-conversation seq gap is detected. Application code usually
@@ -845,6 +846,9 @@ var AgentChatClient = class _AgentChatClient {
     params.set("limit", String(options?.limit ?? 50));
     if (options?.beforeSeq !== void 0) params.set("before_seq", String(options.beforeSeq));
     if (options?.afterSeq !== void 0) params.set("after_seq", String(options.afterSeq));
+    if (options?.aroundMessageId !== void 0) {
+      params.set("around_message_id", options.aroundMessageId);
+    }
     return this.get(
       `/v1/messages/${encodeURIComponent(conversationId)}?${params.toString()}`,
       options
@@ -862,10 +866,10 @@ var AgentChatClient = class _AgentChatClient {
    * Idempotent — hiding an already-hidden message is a success no-op.
    */
   /**
-   * Mark a message as read. Advances the caller's read cursor to the
-   * target message's seq — idempotent, monotonic (the server ignores
-   * attempts to walk the cursor backwards). A `message.read` event is
-   * fanned out to the sender via WebSocket + webhook.
+   * Mark one message as read for the caller. This updates that message's
+   * recipient envelope only; it does not implicitly mark earlier messages,
+   * so a conversation can legitimately contain unread gaps. A `message.read`
+   * event is fanned out to the sender via WebSocket + webhook.
    *
    * Realtime clients also have a WebSocket shortcut (`message.read_ack`
    * frame) that bypasses this HTTP call. The REST method exists for
@@ -902,6 +906,17 @@ var AgentChatClient = class _AgentChatClient {
       opts
     );
   }
+  /**
+   * Fetch compact server-authored room metadata: group summary or DM
+   * counterparty, contact memory, and the exact unread seq boundary.
+   * Message bodies stay on `getMessages`.
+   */
+  getConversationContext(conversationId, opts) {
+    return this.get(
+      `/v1/conversations/${encodeURIComponent(conversationId)}/context`,
+      opts
+    );
+  }
   /**
    * Hide a conversation from the caller's inbox (soft-delete, caller-scoped).
    * The other side's view is untouched — by design, matching the
@@ -915,8 +930,15 @@ var AgentChatClient = class _AgentChatClient {
       opts
     );
   }
-  listConversations(opts) {
-    return this.get("/v1/conversations", opts);
+  listConversations(options) {
+    const params = new URLSearchParams();
+    if (options?.limit !== void 0) params.set("limit", String(options.limit));
+    if (options?.offset !== void 0) params.set("offset", String(options.offset));
+    const qs = params.toString();
+    return this.get(
+      `/v1/conversations${qs ? `?${qs}` : ""}`,
+      options
+    );
   }
   // ─── Groups ───────────────────────────────────────────────────────────────
   /**