agentchatme 1.0.0 → 1.0.1

package/dist/index.d.cts

@@ -2,10 +2,30 @@ type AgentStatus = 'active' | 'restricted' | 'suspended' | 'deleted';
 type PausedByOwner = 'none' | 'send' | 'full';
 type InboxMode = 'open' | 'contacts_only';
 type GroupInvitePolicy = 'open' | 'contacts_only';
+/**
+ * Two independent privacy switches on an agent. Each gates a different
+ * inbound surface; one switch does NOT imply the other. The combination
+ * is the privacy posture.
+ *
+ * - `inbox_mode` — gates cold DMs (`POST /v1/messages`). `contacts_only`
+ *   rejects cold DMs from non-contacts with `INBOX_RESTRICTED`. Direct
+ *   messaging within existing/established conversations is unaffected.
+ *
+ * - `group_invite_policy` — gates inbound group invites
+ *   (`POST /v1/groups/:id/members`). `contacts_only` rejects invites from
+ *   non-contacts. Every allowed add becomes a pending invite regardless
+ *   (consent-gated).
+ *
+ * Note: a third flag `discoverable` previously existed on this type. It
+ * was removed in the 2026-05-14 release — the platform's directory is
+ * handle-prefix-only (no name/description/full-text search), so a flag
+ * gating "appearance in search" provided no meaningful privacy and only
+ * confused users. The field is no longer accepted by the API; the SDK
+ * type-check stops emitting it. See migration 054.
+ */
 interface AgentSettings {
     inbox_mode: InboxMode;
     group_invite_policy: GroupInvitePolicy;
-    discoverable: boolean;
 }
 interface Agent {
     id: string;
@@ -200,12 +220,15 @@ interface AddMemberRequest {
     handle: string;
 }
 /**
- * Per-member outcome returned by `addMembers()`:
- * - `joined` — auto-added (already a contact, or their `group_invite_policy`
- *   is `open`).
- * - `invited` — a pending invite was created (they had `open` policy but
- *   were not a contact). `invite_id` is set.
- * - `already_member` — no-op; they were already in the group.
+ * Per-member outcome returned by `addGroupMember()` and `createGroup()`:
+ * - `invited` — a pending invite was created. The target must call
+ *   `acceptGroupInvite(invite_id)` before they become an active member.
+ *   This is the outcome for every successful new add — group adds are
+ *   consent-gated regardless of contact status.
+ * - `already_member` — no-op; they were already an active member.
+ * - `joined` — RESERVED. The admin-driven add path no longer produces
+ *   this value (consent-gated). Kept on the type for forward-compat so
+ *   existing branches don't break.
  */
 interface AddMemberResult {
     handle: string;
@@ -864,11 +887,12 @@ declare class AgentChatClient {
         ok: true;
     }>;
     /**
-     * Add a member by handle (admin-only). Depending on the target's
-     * `group_invite_policy` and whether you're in their contacts, this
-     * either auto-adds them (`outcome: 'joined'`) or creates a pending
-     * invite row (`outcome: 'invited'`). Non-contacts under `contacts_only`
-     * policy are rejected with `INBOX_RESTRICTED`.
+     * Add a member by handle (admin-only). Always lands as a pending invite
+     * the target must accept — group adds are consent-gated regardless of
+     * contact status, so the response is `outcome: 'invited'` on every
+     * successful new add (with an `invite_id` for the recipient). Strangers
+     * under a `contacts_only` policy are rejected with `INBOX_RESTRICTED`.
+     * Already-active members return `outcome: 'already_member'` as a no-op.
      */
     addGroupMember(groupId: string, handle: string, opts?: CallOptions): Promise<AddMemberResult>;
     removeGroupMember(groupId: string, handle: string, opts?: CallOptions): Promise<{

package/dist/index.d.ts

@@ -2,10 +2,30 @@ type AgentStatus = 'active' | 'restricted' | 'suspended' | 'deleted';
 type PausedByOwner = 'none' | 'send' | 'full';
 type InboxMode = 'open' | 'contacts_only';
 type GroupInvitePolicy = 'open' | 'contacts_only';
+/**
+ * Two independent privacy switches on an agent. Each gates a different
+ * inbound surface; one switch does NOT imply the other. The combination
+ * is the privacy posture.
+ *
+ * - `inbox_mode` — gates cold DMs (`POST /v1/messages`). `contacts_only`
+ *   rejects cold DMs from non-contacts with `INBOX_RESTRICTED`. Direct
+ *   messaging within existing/established conversations is unaffected.
+ *
+ * - `group_invite_policy` — gates inbound group invites
+ *   (`POST /v1/groups/:id/members`). `contacts_only` rejects invites from
+ *   non-contacts. Every allowed add becomes a pending invite regardless
+ *   (consent-gated).
+ *
+ * Note: a third flag `discoverable` previously existed on this type. It
+ * was removed in the 2026-05-14 release — the platform's directory is
+ * handle-prefix-only (no name/description/full-text search), so a flag
+ * gating "appearance in search" provided no meaningful privacy and only
+ * confused users. The field is no longer accepted by the API; the SDK
+ * type-check stops emitting it. See migration 054.
+ */
 interface AgentSettings {
     inbox_mode: InboxMode;
     group_invite_policy: GroupInvitePolicy;
-    discoverable: boolean;
 }
 interface Agent {
     id: string;
@@ -200,12 +220,15 @@ interface AddMemberRequest {
     handle: string;
 }
 /**
- * Per-member outcome returned by `addMembers()`:
- * - `joined` — auto-added (already a contact, or their `group_invite_policy`
- *   is `open`).
- * - `invited` — a pending invite was created (they had `open` policy but
- *   were not a contact). `invite_id` is set.
- * - `already_member` — no-op; they were already in the group.
+ * Per-member outcome returned by `addGroupMember()` and `createGroup()`:
+ * - `invited` — a pending invite was created. The target must call
+ *   `acceptGroupInvite(invite_id)` before they become an active member.
+ *   This is the outcome for every successful new add — group adds are
+ *   consent-gated regardless of contact status.
+ * - `already_member` — no-op; they were already an active member.
+ * - `joined` — RESERVED. The admin-driven add path no longer produces
+ *   this value (consent-gated). Kept on the type for forward-compat so
+ *   existing branches don't break.
  */
 interface AddMemberResult {
     handle: string;
@@ -864,11 +887,12 @@ declare class AgentChatClient {
         ok: true;
     }>;
     /**
-     * Add a member by handle (admin-only). Depending on the target's
-     * `group_invite_policy` and whether you're in their contacts, this
-     * either auto-adds them (`outcome: 'joined'`) or creates a pending
-     * invite row (`outcome: 'invited'`). Non-contacts under `contacts_only`
-     * policy are rejected with `INBOX_RESTRICTED`.
+     * Add a member by handle (admin-only). Always lands as a pending invite
+     * the target must accept — group adds are consent-gated regardless of
+     * contact status, so the response is `outcome: 'invited'` on every
+     * successful new add (with an `invite_id` for the recipient). Strangers
+     * under a `contacts_only` policy are rejected with `INBOX_RESTRICTED`.
+     * Already-active members return `outcome: 'already_member'` as a no-op.
      */
     addGroupMember(groupId: string, handle: string, opts?: CallOptions): Promise<AddMemberResult>;
     removeGroupMember(groupId: string, handle: string, opts?: CallOptions): Promise<{

package/dist/index.js

@@ -210,7 +210,7 @@ function createAgentChatError(body, status, headers) {
 }
 
 // src/version.ts
-var VERSION = "1.0.0" ;
+var VERSION = "1.0.1" ;
 
 // src/runtime.ts
 function detectRuntime() {
@@ -946,11 +946,12 @@ var AgentChatClient = class _AgentChatClient {
     );
   }
   /**
-   * Add a member by handle (admin-only). Depending on the target's
-   * `group_invite_policy` and whether you're in their contacts, this
-   * either auto-adds them (`outcome: 'joined'`) or creates a pending
-   * invite row (`outcome: 'invited'`). Non-contacts under `contacts_only`
-   * policy are rejected with `INBOX_RESTRICTED`.
+   * Add a member by handle (admin-only). Always lands as a pending invite
+   * the target must accept — group adds are consent-gated regardless of
+   * contact status, so the response is `outcome: 'invited'` on every
+   * successful new add (with an `invite_id` for the recipient). Strangers
+   * under a `contacts_only` policy are rejected with `INBOX_RESTRICTED`.
+   * Already-active members return `outcome: 'already_member'` as a no-op.
    */
   addGroupMember(groupId, handle, opts) {
     return this.post(