acn-client 0.4.0 → 0.5.1

package/README.md

@@ -124,7 +124,7 @@ Options:
 | `sendMessage(request)` | Send message to agent |
 | `broadcast(request)` | Broadcast to multiple agents |
 | `broadcastBySkill(request)` | Broadcast by skill |
-| `getMessageHistory(agentId, options?)` | Get message history |
+| `getMessageHistory(agentId, options?)` | Get offline inbox (pending messages); pass `{ consume: true }` to clear after read |
 
 #### Payment Methods
 

package/dist/index.d.mts

@@ -384,9 +384,20 @@ declare class ACNClient {
         success: boolean;
         delivered_count: number;
     }>;
-    /** Get message history for an agent */
+    /**
+     * Get the agent's offline inbox (messages that failed delivery while offline).
+     *
+     * This is a pending-delivery inbox, not a full message archive. Server-side
+     * storage is capped at 50 messages per agent with a 30-day TTL.
+     *
+     * @param options.limit   Max messages to return (newest first).
+     * @param options.consume If true, clear the inbox after reading. Use a large
+     *                        enough `limit` to avoid silently discarding messages.
+     * @param options.offset  Deprecated and ignored server-side.
+     */
     getMessageHistory(agentId: string, options?: {
         limit?: number;
+        consume?: boolean;
         offset?: number;
     }): Promise<{
         messages: Message[];

package/dist/index.d.ts

@@ -384,9 +384,20 @@ declare class ACNClient {
         success: boolean;
         delivered_count: number;
     }>;
-    /** Get message history for an agent */
+    /**
+     * Get the agent's offline inbox (messages that failed delivery while offline).
+     *
+     * This is a pending-delivery inbox, not a full message archive. Server-side
+     * storage is capped at 50 messages per agent with a 30-day TTL.
+     *
+     * @param options.limit   Max messages to return (newest first).
+     * @param options.consume If true, clear the inbox after reading. Use a large
+     *                        enough `limit` to avoid silently discarding messages.
+     * @param options.offset  Deprecated and ignored server-side.
+     */
     getMessageHistory(agentId: string, options?: {
         limit?: number;
+        consume?: boolean;
         offset?: number;
     }): Promise<{
         messages: Message[];

package/dist/index.js

@@ -198,9 +198,22 @@ var ACNClient = class {
   async broadcastBySkill(request) {
     return this.post("/api/v1/communication/broadcast-by-skill", request);
   }
-  /** Get message history for an agent */
+  /**
+   * Get the agent's offline inbox (messages that failed delivery while offline).
+   *
+   * This is a pending-delivery inbox, not a full message archive. Server-side
+   * storage is capped at 50 messages per agent with a 30-day TTL.
+   *
+   * @param options.limit   Max messages to return (newest first).
+   * @param options.consume If true, clear the inbox after reading. Use a large
+   *                        enough `limit` to avoid silently discarding messages.
+   * @param options.offset  Deprecated and ignored server-side.
+   */
   async getMessageHistory(agentId, options) {
-    return this.get(`/api/v1/communication/history/${agentId}`, options);
+    const params = {};
+    if (options?.limit !== void 0) params.limit = options.limit;
+    if (options?.consume) params.ack = true;
+    return this.get(`/api/v1/communication/history/${agentId}`, params);
   }
   // ============================================
   // Payment Discovery

package/dist/index.mjs

@@ -159,9 +159,22 @@ var ACNClient = class {
   async broadcastBySkill(request) {
     return this.post("/api/v1/communication/broadcast-by-skill", request);
   }
-  /** Get message history for an agent */
+  /**
+   * Get the agent's offline inbox (messages that failed delivery while offline).
+   *
+   * This is a pending-delivery inbox, not a full message archive. Server-side
+   * storage is capped at 50 messages per agent with a 30-day TTL.
+   *
+   * @param options.limit   Max messages to return (newest first).
+   * @param options.consume If true, clear the inbox after reading. Use a large
+   *                        enough `limit` to avoid silently discarding messages.
+   * @param options.offset  Deprecated and ignored server-side.
+   */
   async getMessageHistory(agentId, options) {
-    return this.get(`/api/v1/communication/history/${agentId}`, options);
+    const params = {};
+    if (options?.limit !== void 0) params.limit = options.limit;
+    if (options?.consume) params.ack = true;
+    return this.get(`/api/v1/communication/history/${agentId}`, params);
   }
   // ============================================
   // Payment Discovery

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acn-client",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Official TypeScript/JavaScript client for ACN (Agent Collaboration Network)",
   "main": "dist/index.js",
   "module": "dist/index.mjs",