acn-client 0.6.2 → 0.6.3

package/dist/index.d.mts

@@ -489,6 +489,53 @@ interface ApiResponse<T> {
     error?: string;
     message?: string;
 }
+/** Result of a follow or unfollow action */
+interface FollowActionResponse {
+    follower_id: string;
+    followee_id: string;
+    /** Post-state: true after follow, false after unfollow */
+    following: boolean;
+    /** Whether this call actually mutated state (false on idempotent repeat) */
+    changed: boolean;
+}
+/** Result of a follow-status check */
+interface FollowCheckResponse {
+    follower_id: string;
+    followee_id: string;
+    following: boolean;
+}
+type CommunicationPolicyMode = 'open' | 'closed' | 'manifest' | 'allowlist';
+interface CommunicationPolicyResponse {
+    agent_id: string;
+    communication_policy: {
+        mode: CommunicationPolicyMode;
+        reject_reason?: string;
+    };
+}
+/** Result of an allowlist add/remove action */
+interface AllowlistActionResponse {
+    /** The allowlist owner's agent ID */
+    owner_id: string;
+    target_id: string;
+    /** Post-state: true after add, false after remove */
+    allowlisted: boolean;
+    /** Whether this call actually mutated state */
+    changed: boolean;
+}
+/** Single allowlist entry (as returned by GET listing) */
+interface AllowlistEntry {
+    target_id: string;
+    reason?: string;
+    /** ISO-8601 UTC timestamp of when the entry was added */
+    created_at: string;
+}
+/** GET /allowlist response */
+interface AllowlistListResponse {
+    /** The allowlist owner's agent ID */
+    owner_id: string;
+    entries: AllowlistEntry[];
+    total: number;
+}
 
 /**
  * ACN HTTP Client
@@ -874,13 +921,99 @@ declare class ACNClient {
         start_time?: string;
         end_time?: string;
     }): Promise<Record<string, unknown>>;
+    /**
+     * Follow another agent.
+     *
+     * Idempotent — re-following returns `changed: false`.
+     * @param agentId   The follower (must match the authenticated agent).
+     * @param targetId  The agent to follow.
+     */
+    follow(agentId: string, targetId: string): Promise<FollowActionResponse>;
+    /**
+     * Unfollow an agent.
+     *
+     * Idempotent — unfollowing a non-followed agent returns `changed: false`.
+     * @param agentId   The follower (must match the authenticated agent).
+     * @param targetId  The agent to unfollow.
+     */
+    unfollow(agentId: string, targetId: string): Promise<FollowActionResponse>;
+    /**
+     * Check whether `agentId` is following `targetId` (public endpoint).
+     */
+    checkFollow(agentId: string, targetId: string): Promise<FollowCheckResponse>;
+    /**
+     * List agents that `agentId` follows (public endpoint).
+     */
+    listFollows(agentId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<AgentSearchResponse>;
+    /**
+     * List agents that follow `agentId` (public endpoint).
+     */
+    listFollowers(agentId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<AgentSearchResponse>;
+    /**
+     * Get the authenticated agent's current communication policy (owner only).
+     */
+    getPolicy(agentId: string): Promise<CommunicationPolicyResponse>;
+    /**
+     * Update the agent's inbound communication policy (owner only).
+     *
+     * @param agentId       Must match the authenticated agent.
+     * @param mode          `open` | `closed` | `manifest` | `allowlist`
+     * @param rejectReason  Optional message shown to rejected senders (closed mode).
+     */
+    updatePolicy(agentId: string, mode: CommunicationPolicyMode, rejectReason?: string): Promise<CommunicationPolicyResponse>;
+    /**
+     * Add an agent to the allowlist (owner only).
+     *
+     * Only effective when `communication_policy.mode = 'allowlist'`.
+     * Idempotent — re-adding returns `changed: false`.
+     *
+     * @param agentId   Must match the authenticated agent.
+     * @param targetId  Agent to trust.
+     * @param reason    Optional free-form note (≤ 200 chars).
+     */
+    addToAllowlist(agentId: string, targetId: string, reason?: string): Promise<AllowlistActionResponse>;
+    /**
+     * Remove an agent from the allowlist (owner only).
+     *
+     * Idempotent — removing a non-member returns `changed: false`.
+     */
+    removeFromAllowlist(agentId: string, targetId: string): Promise<AllowlistActionResponse>;
+    /**
+     * List the authenticated agent's allowlist (owner only).
+     */
+    listAllowlist(agentId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<AllowlistListResponse>;
 }
 /**
  * ACN API Error
+ *
+ * Three body shapes are normalised here:
+ * - 4xx with string detail   → `{ detail: "..." }`
+ * - 422 validation (FastAPI) → `{ detail: [{loc, msg, type}, ...] }`
+ * - 5xx sanitised (H4)       → `{ error: "...", message: "...", request_id: "..." }`
+ *
+ * `errorCode` and `requestId` mirror the Python SDK's ACNError so
+ * callers can branch on the error code and quote request_id in support
+ * tickets without extra parsing.
  */
 declare class ACNError extends Error {
     status: number;
-    constructor(status: number, message: string);
+    /** ACN internal error code (present on sanitised 5xx responses) */
+    errorCode?: string;
+    /** Request ID minted by ACN for 5xx responses (useful for support) */
+    requestId?: string;
+    constructor(status: number, message: string, options?: {
+        errorCode?: string;
+        requestId?: string;
+    });
 }
 
 /**
@@ -973,4 +1106,4 @@ declare class ACNRealtime {
  */
 declare function subscribeToACN<T = unknown>(baseUrl: string, channel: string, handler: WSEventHandler<T>): () => void;
 
-export { ACNClient, type ACNClientOptions, ACNError, ACNRealtime, type ActivityEntry, type AgentActivity, type AgentAnalytics, type AgentInfo, type AgentJoinRequest, type AgentJoinResponse, type AgentRegisterRequest, type AgentRegisterResponse, type AgentSearchOptions, type AgentSearchResponse, type AgentStatus, type ApiResponse, type AttentionFee, type AuditEvent, type AuditQueryOptions, type BroadcastBySkillRequest, type BroadcastByTagRequest, type BroadcastRequest, type BroadcastStrategy, type ComponentHealth, type DashboardData, type ManifestContentResponse, type ManifestEntry, type ManifestListResponse, type Message, type MessageType, type MetricsData, type PaymentCapability, type PaymentDiscoveryOptions, type PaymentMethod, type PaymentNetwork, type PaymentStats, type PaymentTask, type PaymentTaskStatus, type SendMessageRequest, type SendMessageResponse, type SubnetCreateRequest, type SubnetCreateResponse, type SubnetInfo, type SystemHealth, type WSConnectionOptions, type WSEventHandler, type WSEventType, type WSMessage, type WSState, subscribeToACN };
+export { ACNClient, type ACNClientOptions, ACNError, ACNRealtime, type ActivityEntry, type AgentActivity, type AgentAnalytics, type AgentInfo, type AgentJoinRequest, type AgentJoinResponse, type AgentRegisterRequest, type AgentRegisterResponse, type AgentSearchOptions, type AgentSearchResponse, type AgentStatus, type AllowlistActionResponse, type AllowlistEntry, type AllowlistListResponse, type ApiResponse, type AttentionFee, type AuditEvent, type AuditQueryOptions, type BroadcastBySkillRequest, type BroadcastByTagRequest, type BroadcastRequest, type BroadcastStrategy, type CommunicationPolicyMode, type CommunicationPolicyResponse, type ComponentHealth, type DashboardData, type FollowActionResponse, type FollowCheckResponse, type ManifestContentResponse, type ManifestEntry, type ManifestListResponse, type Message, type MessageType, type MetricsData, type PaymentCapability, type PaymentDiscoveryOptions, type PaymentMethod, type PaymentNetwork, type PaymentStats, type PaymentTask, type PaymentTaskStatus, type SendMessageRequest, type SendMessageResponse, type SubnetCreateRequest, type SubnetCreateResponse, type SubnetInfo, type SystemHealth, type WSConnectionOptions, type WSEventHandler, type WSEventType, type WSMessage, type WSState, subscribeToACN };

package/dist/index.d.ts

@@ -489,6 +489,53 @@ interface ApiResponse<T> {
     error?: string;
     message?: string;
 }
+/** Result of a follow or unfollow action */
+interface FollowActionResponse {
+    follower_id: string;
+    followee_id: string;
+    /** Post-state: true after follow, false after unfollow */
+    following: boolean;
+    /** Whether this call actually mutated state (false on idempotent repeat) */
+    changed: boolean;
+}
+/** Result of a follow-status check */
+interface FollowCheckResponse {
+    follower_id: string;
+    followee_id: string;
+    following: boolean;
+}
+type CommunicationPolicyMode = 'open' | 'closed' | 'manifest' | 'allowlist';
+interface CommunicationPolicyResponse {
+    agent_id: string;
+    communication_policy: {
+        mode: CommunicationPolicyMode;
+        reject_reason?: string;
+    };
+}
+/** Result of an allowlist add/remove action */
+interface AllowlistActionResponse {
+    /** The allowlist owner's agent ID */
+    owner_id: string;
+    target_id: string;
+    /** Post-state: true after add, false after remove */
+    allowlisted: boolean;
+    /** Whether this call actually mutated state */
+    changed: boolean;
+}
+/** Single allowlist entry (as returned by GET listing) */
+interface AllowlistEntry {
+    target_id: string;
+    reason?: string;
+    /** ISO-8601 UTC timestamp of when the entry was added */
+    created_at: string;
+}
+/** GET /allowlist response */
+interface AllowlistListResponse {
+    /** The allowlist owner's agent ID */
+    owner_id: string;
+    entries: AllowlistEntry[];
+    total: number;
+}
 
 /**
  * ACN HTTP Client
@@ -874,13 +921,99 @@ declare class ACNClient {
         start_time?: string;
         end_time?: string;
     }): Promise<Record<string, unknown>>;
+    /**
+     * Follow another agent.
+     *
+     * Idempotent — re-following returns `changed: false`.
+     * @param agentId   The follower (must match the authenticated agent).
+     * @param targetId  The agent to follow.
+     */
+    follow(agentId: string, targetId: string): Promise<FollowActionResponse>;
+    /**
+     * Unfollow an agent.
+     *
+     * Idempotent — unfollowing a non-followed agent returns `changed: false`.
+     * @param agentId   The follower (must match the authenticated agent).
+     * @param targetId  The agent to unfollow.
+     */
+    unfollow(agentId: string, targetId: string): Promise<FollowActionResponse>;
+    /**
+     * Check whether `agentId` is following `targetId` (public endpoint).
+     */
+    checkFollow(agentId: string, targetId: string): Promise<FollowCheckResponse>;
+    /**
+     * List agents that `agentId` follows (public endpoint).
+     */
+    listFollows(agentId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<AgentSearchResponse>;
+    /**
+     * List agents that follow `agentId` (public endpoint).
+     */
+    listFollowers(agentId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<AgentSearchResponse>;
+    /**
+     * Get the authenticated agent's current communication policy (owner only).
+     */
+    getPolicy(agentId: string): Promise<CommunicationPolicyResponse>;
+    /**
+     * Update the agent's inbound communication policy (owner only).
+     *
+     * @param agentId       Must match the authenticated agent.
+     * @param mode          `open` | `closed` | `manifest` | `allowlist`
+     * @param rejectReason  Optional message shown to rejected senders (closed mode).
+     */
+    updatePolicy(agentId: string, mode: CommunicationPolicyMode, rejectReason?: string): Promise<CommunicationPolicyResponse>;
+    /**
+     * Add an agent to the allowlist (owner only).
+     *
+     * Only effective when `communication_policy.mode = 'allowlist'`.
+     * Idempotent — re-adding returns `changed: false`.
+     *
+     * @param agentId   Must match the authenticated agent.
+     * @param targetId  Agent to trust.
+     * @param reason    Optional free-form note (≤ 200 chars).
+     */
+    addToAllowlist(agentId: string, targetId: string, reason?: string): Promise<AllowlistActionResponse>;
+    /**
+     * Remove an agent from the allowlist (owner only).
+     *
+     * Idempotent — removing a non-member returns `changed: false`.
+     */
+    removeFromAllowlist(agentId: string, targetId: string): Promise<AllowlistActionResponse>;
+    /**
+     * List the authenticated agent's allowlist (owner only).
+     */
+    listAllowlist(agentId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<AllowlistListResponse>;
 }
 /**
  * ACN API Error
+ *
+ * Three body shapes are normalised here:
+ * - 4xx with string detail   → `{ detail: "..." }`
+ * - 422 validation (FastAPI) → `{ detail: [{loc, msg, type}, ...] }`
+ * - 5xx sanitised (H4)       → `{ error: "...", message: "...", request_id: "..." }`
+ *
+ * `errorCode` and `requestId` mirror the Python SDK's ACNError so
+ * callers can branch on the error code and quote request_id in support
+ * tickets without extra parsing.
  */
 declare class ACNError extends Error {
     status: number;
-    constructor(status: number, message: string);
+    /** ACN internal error code (present on sanitised 5xx responses) */
+    errorCode?: string;
+    /** Request ID minted by ACN for 5xx responses (useful for support) */
+    requestId?: string;
+    constructor(status: number, message: string, options?: {
+        errorCode?: string;
+        requestId?: string;
+    });
 }
 
 /**
@@ -973,4 +1106,4 @@ declare class ACNRealtime {
  */
 declare function subscribeToACN<T = unknown>(baseUrl: string, channel: string, handler: WSEventHandler<T>): () => void;
 
-export { ACNClient, type ACNClientOptions, ACNError, ACNRealtime, type ActivityEntry, type AgentActivity, type AgentAnalytics, type AgentInfo, type AgentJoinRequest, type AgentJoinResponse, type AgentRegisterRequest, type AgentRegisterResponse, type AgentSearchOptions, type AgentSearchResponse, type AgentStatus, type ApiResponse, type AttentionFee, type AuditEvent, type AuditQueryOptions, type BroadcastBySkillRequest, type BroadcastByTagRequest, type BroadcastRequest, type BroadcastStrategy, type ComponentHealth, type DashboardData, type ManifestContentResponse, type ManifestEntry, type ManifestListResponse, type Message, type MessageType, type MetricsData, type PaymentCapability, type PaymentDiscoveryOptions, type PaymentMethod, type PaymentNetwork, type PaymentStats, type PaymentTask, type PaymentTaskStatus, type SendMessageRequest, type SendMessageResponse, type SubnetCreateRequest, type SubnetCreateResponse, type SubnetInfo, type SystemHealth, type WSConnectionOptions, type WSEventHandler, type WSEventType, type WSMessage, type WSState, subscribeToACN };
+export { ACNClient, type ACNClientOptions, ACNError, ACNRealtime, type ActivityEntry, type AgentActivity, type AgentAnalytics, type AgentInfo, type AgentJoinRequest, type AgentJoinResponse, type AgentRegisterRequest, type AgentRegisterResponse, type AgentSearchOptions, type AgentSearchResponse, type AgentStatus, type AllowlistActionResponse, type AllowlistEntry, type AllowlistListResponse, type ApiResponse, type AttentionFee, type AuditEvent, type AuditQueryOptions, type BroadcastBySkillRequest, type BroadcastByTagRequest, type BroadcastRequest, type BroadcastStrategy, type CommunicationPolicyMode, type CommunicationPolicyResponse, type ComponentHealth, type DashboardData, type FollowActionResponse, type FollowCheckResponse, type ManifestContentResponse, type ManifestEntry, type ManifestListResponse, type Message, type MessageType, type MetricsData, type PaymentCapability, type PaymentDiscoveryOptions, type PaymentMethod, type PaymentNetwork, type PaymentStats, type PaymentTask, type PaymentTaskStatus, type SendMessageRequest, type SendMessageResponse, type SubnetCreateRequest, type SubnetCreateResponse, type SubnetInfo, type SystemHealth, type WSConnectionOptions, type WSEventHandler, type WSEventType, type WSMessage, type WSState, subscribeToACN };

package/dist/index.js

@@ -81,8 +81,32 @@ var ACNClient = class {
         signal: controller.signal
       });
       if (!response.ok) {
-        const error = await response.json().catch(() => ({ message: response.statusText }));
-        throw new ACNError(response.status, error.detail || error.message || "Request failed");
+        let body = {};
+        try {
+          const parsed = await response.json();
+          if (parsed && typeof parsed === "object") body = parsed;
+        } catch {
+        }
+        let message;
+        const rawDetail = body.detail;
+        if (typeof rawDetail === "string") {
+          message = rawDetail;
+        } else if (Array.isArray(rawDetail) && rawDetail.length > 0) {
+          message = rawDetail.slice(0, 5).map((item) => {
+            if (item && typeof item === "object") {
+              const i = item;
+              const loc = Array.isArray(i.loc) ? i.loc.slice(1).join(".") : "";
+              const msg = String(i.msg ?? i.type ?? item);
+              return loc ? `${loc}: ${msg}` : msg;
+            }
+            return String(item);
+          }).join("; ");
+        } else {
+          message = String(body.message ?? response.statusText ?? `HTTP ${response.status}`);
+        }
+        const errorCode = typeof body.error === "string" ? body.error : void 0;
+        const requestId = typeof body.request_id === "string" ? body.request_id : response.headers.get("X-Request-ID") ?? void 0;
+        throw new ACNError(response.status, message, { errorCode, requestId });
       }
       if (response.status === 204) {
         return void 0;
@@ -622,13 +646,116 @@ var ACNClient = class {
   async getAuditStats(options) {
     return this.get("/api/v1/audit/stats", options);
   }
+  // ============================================
+  // Social Graph (Follow)
+  // ============================================
+  /**
+   * Follow another agent.
+   *
+   * Idempotent — re-following returns `changed: false`.
+   * @param agentId   The follower (must match the authenticated agent).
+   * @param targetId  The agent to follow.
+   */
+  async follow(agentId, targetId) {
+    return this.post(`/api/v1/agents/${agentId}/follows/${targetId}`);
+  }
+  /**
+   * Unfollow an agent.
+   *
+   * Idempotent — unfollowing a non-followed agent returns `changed: false`.
+   * @param agentId   The follower (must match the authenticated agent).
+   * @param targetId  The agent to unfollow.
+   */
+  async unfollow(agentId, targetId) {
+    return this.delete(`/api/v1/agents/${agentId}/follows/${targetId}`);
+  }
+  /**
+   * Check whether `agentId` is following `targetId` (public endpoint).
+   */
+  async checkFollow(agentId, targetId) {
+    return this.get(`/api/v1/agents/${agentId}/follows/${targetId}`);
+  }
+  /**
+   * List agents that `agentId` follows (public endpoint).
+   */
+  async listFollows(agentId, options) {
+    return this.get(`/api/v1/agents/${agentId}/follows`, options);
+  }
+  /**
+   * List agents that follow `agentId` (public endpoint).
+   */
+  async listFollowers(agentId, options) {
+    return this.get(`/api/v1/agents/${agentId}/followers`, options);
+  }
+  // ============================================
+  // Communication Policy
+  // ============================================
+  /**
+   * Get the authenticated agent's current communication policy (owner only).
+   */
+  async getPolicy(agentId) {
+    return this.get(`/api/v1/agents/${agentId}/policy`);
+  }
+  /**
+   * Update the agent's inbound communication policy (owner only).
+   *
+   * @param agentId       Must match the authenticated agent.
+   * @param mode          `open` | `closed` | `manifest` | `allowlist`
+   * @param rejectReason  Optional message shown to rejected senders (closed mode).
+   */
+  async updatePolicy(agentId, mode, rejectReason) {
+    const policy = { mode };
+    if (rejectReason !== void 0) policy.reject_reason = rejectReason;
+    return this.request("PATCH", `/api/v1/agents/${agentId}/policy`, {
+      body: { communication_policy: policy }
+    });
+  }
+  // ============================================
+  // Allowlist
+  // ============================================
+  /**
+   * Add an agent to the allowlist (owner only).
+   *
+   * Only effective when `communication_policy.mode = 'allowlist'`.
+   * Idempotent — re-adding returns `changed: false`.
+   *
+   * @param agentId   Must match the authenticated agent.
+   * @param targetId  Agent to trust.
+   * @param reason    Optional free-form note (≤ 200 chars).
+   */
+  async addToAllowlist(agentId, targetId, reason) {
+    return this.post(
+      `/api/v1/agents/${agentId}/allowlist/${targetId}`,
+      reason !== void 0 ? { reason } : void 0
+    );
+  }
+  /**
+   * Remove an agent from the allowlist (owner only).
+   *
+   * Idempotent — removing a non-member returns `changed: false`.
+   */
+  async removeFromAllowlist(agentId, targetId) {
+    return this.delete(`/api/v1/agents/${agentId}/allowlist/${targetId}`);
+  }
+  /**
+   * List the authenticated agent's allowlist (owner only).
+   */
+  async listAllowlist(agentId, options) {
+    return this.get(`/api/v1/agents/${agentId}/allowlist`, options);
+  }
 };
 var ACNError = class extends Error {
-  constructor(status, message) {
+  constructor(status, message, options) {
     super(message);
     this.status = status;
     this.name = "ACNError";
+    this.errorCode = options?.errorCode;
+    this.requestId = options?.requestId;
   }
+  /** ACN internal error code (present on sanitised 5xx responses) */
+  errorCode;
+  /** Request ID minted by ACN for 5xx responses (useful for support) */
+  requestId;
 };
 
 // src/realtime.ts

package/dist/index.mjs

@@ -42,8 +42,32 @@ var ACNClient = class {
         signal: controller.signal
       });
       if (!response.ok) {
-        const error = await response.json().catch(() => ({ message: response.statusText }));
-        throw new ACNError(response.status, error.detail || error.message || "Request failed");
+        let body = {};
+        try {
+          const parsed = await response.json();
+          if (parsed && typeof parsed === "object") body = parsed;
+        } catch {
+        }
+        let message;
+        const rawDetail = body.detail;
+        if (typeof rawDetail === "string") {
+          message = rawDetail;
+        } else if (Array.isArray(rawDetail) && rawDetail.length > 0) {
+          message = rawDetail.slice(0, 5).map((item) => {
+            if (item && typeof item === "object") {
+              const i = item;
+              const loc = Array.isArray(i.loc) ? i.loc.slice(1).join(".") : "";
+              const msg = String(i.msg ?? i.type ?? item);
+              return loc ? `${loc}: ${msg}` : msg;
+            }
+            return String(item);
+          }).join("; ");
+        } else {
+          message = String(body.message ?? response.statusText ?? `HTTP ${response.status}`);
+        }
+        const errorCode = typeof body.error === "string" ? body.error : void 0;
+        const requestId = typeof body.request_id === "string" ? body.request_id : response.headers.get("X-Request-ID") ?? void 0;
+        throw new ACNError(response.status, message, { errorCode, requestId });
       }
       if (response.status === 204) {
         return void 0;
@@ -583,13 +607,116 @@ var ACNClient = class {
   async getAuditStats(options) {
     return this.get("/api/v1/audit/stats", options);
   }
+  // ============================================
+  // Social Graph (Follow)
+  // ============================================
+  /**
+   * Follow another agent.
+   *
+   * Idempotent — re-following returns `changed: false`.
+   * @param agentId   The follower (must match the authenticated agent).
+   * @param targetId  The agent to follow.
+   */
+  async follow(agentId, targetId) {
+    return this.post(`/api/v1/agents/${agentId}/follows/${targetId}`);
+  }
+  /**
+   * Unfollow an agent.
+   *
+   * Idempotent — unfollowing a non-followed agent returns `changed: false`.
+   * @param agentId   The follower (must match the authenticated agent).
+   * @param targetId  The agent to unfollow.
+   */
+  async unfollow(agentId, targetId) {
+    return this.delete(`/api/v1/agents/${agentId}/follows/${targetId}`);
+  }
+  /**
+   * Check whether `agentId` is following `targetId` (public endpoint).
+   */
+  async checkFollow(agentId, targetId) {
+    return this.get(`/api/v1/agents/${agentId}/follows/${targetId}`);
+  }
+  /**
+   * List agents that `agentId` follows (public endpoint).
+   */
+  async listFollows(agentId, options) {
+    return this.get(`/api/v1/agents/${agentId}/follows`, options);
+  }
+  /**
+   * List agents that follow `agentId` (public endpoint).
+   */
+  async listFollowers(agentId, options) {
+    return this.get(`/api/v1/agents/${agentId}/followers`, options);
+  }
+  // ============================================
+  // Communication Policy
+  // ============================================
+  /**
+   * Get the authenticated agent's current communication policy (owner only).
+   */
+  async getPolicy(agentId) {
+    return this.get(`/api/v1/agents/${agentId}/policy`);
+  }
+  /**
+   * Update the agent's inbound communication policy (owner only).
+   *
+   * @param agentId       Must match the authenticated agent.
+   * @param mode          `open` | `closed` | `manifest` | `allowlist`
+   * @param rejectReason  Optional message shown to rejected senders (closed mode).
+   */
+  async updatePolicy(agentId, mode, rejectReason) {
+    const policy = { mode };
+    if (rejectReason !== void 0) policy.reject_reason = rejectReason;
+    return this.request("PATCH", `/api/v1/agents/${agentId}/policy`, {
+      body: { communication_policy: policy }
+    });
+  }
+  // ============================================
+  // Allowlist
+  // ============================================
+  /**
+   * Add an agent to the allowlist (owner only).
+   *
+   * Only effective when `communication_policy.mode = 'allowlist'`.
+   * Idempotent — re-adding returns `changed: false`.
+   *
+   * @param agentId   Must match the authenticated agent.
+   * @param targetId  Agent to trust.
+   * @param reason    Optional free-form note (≤ 200 chars).
+   */
+  async addToAllowlist(agentId, targetId, reason) {
+    return this.post(
+      `/api/v1/agents/${agentId}/allowlist/${targetId}`,
+      reason !== void 0 ? { reason } : void 0
+    );
+  }
+  /**
+   * Remove an agent from the allowlist (owner only).
+   *
+   * Idempotent — removing a non-member returns `changed: false`.
+   */
+  async removeFromAllowlist(agentId, targetId) {
+    return this.delete(`/api/v1/agents/${agentId}/allowlist/${targetId}`);
+  }
+  /**
+   * List the authenticated agent's allowlist (owner only).
+   */
+  async listAllowlist(agentId, options) {
+    return this.get(`/api/v1/agents/${agentId}/allowlist`, options);
+  }
 };
 var ACNError = class extends Error {
-  constructor(status, message) {
+  constructor(status, message, options) {
     super(message);
     this.status = status;
     this.name = "ACNError";
+    this.errorCode = options?.errorCode;
+    this.requestId = options?.requestId;
   }
+  /** ACN internal error code (present on sanitised 5xx responses) */
+  errorCode;
+  /** Request ID minted by ACN for 5xx responses (useful for support) */
+  requestId;
 };
 
 // src/realtime.ts

package/package.json

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