@pidgeon-ai/sdk 1.31.0 → 1.31.1

package/CHANGELOG.md

@@ -7,6 +7,13 @@ the two would publish a release for every unrelated product deploy.
 Semver applies to **this package's own surface** — the exported names, the
 call shapes, the result shape — not to the API behind it.
 
+## 1.31.1 — inbox, address, folder
+
+Descriptions only. Where the docs said "mailbox" they now say inbox (what an
+agent or a person has), address (`name@domain`, which the API calls an
+identity) or folder. Every name stays: `mailboxes.list`, `/v1/mailboxes`,
+`identity_id`. No shape moves.
+
 ## 1.31.0 — `receive_policy`
 
 Every address carries `receive_policy`: `open` (anyone, the default) or

package/dist/index.d.cts

@@ -331,7 +331,7 @@ type ClientOptions = {
     baseUrl: 'https://pidgeon.ai/api/v1' | (string & {});
 };
 /**
- * A mailbox, with the display name when one was given.
+ * An address, with the display name when one was given.
  */
 type Address = {
     email: string;
@@ -442,13 +442,13 @@ type Message = {
     id: string;
     thread_id: string;
     /**
-     * The mailbox this message is in, as an id. What `POST /attachments` and the other endpoints that take a mailbox expect — `identity` below is the same address as text.
+     * The address this message is in, as an id. What `POST /attachments` and the other endpoints that take an `identity_id` expect — `identity` below is the same address as text.
      */
     identity_id: string | null;
     identity: string | null;
     direction: string;
     /**
-     * A mailbox, with the display name when one was given.
+     * An address, with the display name when one was given.
      */
     from: {
         email: string;
@@ -662,13 +662,13 @@ type AwaitedMessage = {
         id: string;
         thread_id: string;
         /**
-         * The mailbox this message is in, as an id. What `POST /attachments` and the other endpoints that take a mailbox expect — `identity` below is the same address as text.
+         * The address this message is in, as an id. What `POST /attachments` and the other endpoints that take an `identity_id` expect — `identity` below is the same address as text.
          */
         identity_id: string | null;
         identity: string | null;
         direction: string;
         /**
-         * A mailbox, with the display name when one was given.
+         * An address, with the display name when one was given.
          */
         from: {
             email: string;
@@ -1180,7 +1180,7 @@ type EventResponse = {
         updated_at: string;
     };
     /**
-     * Which of the mailbox’s addresses answered.
+     * Which of the inbox’s addresses answered.
      */
     attendee: string;
     status: string;
@@ -1192,7 +1192,7 @@ type EventResponse = {
 type InvitationResponse = {
     status: string;
     /**
-     * Which of the mailbox’s addresses answered.
+     * Which of the inbox’s addresses answered.
      */
     attendee: string;
     /**
@@ -1816,7 +1816,7 @@ type SearchHit = {
      */
     folder: 'inbox' | 'starred' | 'sent' | 'drafts' | 'scheduled' | 'snoozed' | 'archive' | 'spam' | 'trash' | 'unauthenticated';
     /**
-     * The mailbox it was found in, as the address. `identity_id` is the same row.
+     * The inbox it was found in, as the address. `identity_id` is the same row.
      */
     identity: string | null;
 };

package/dist/index.d.ts

@@ -331,7 +331,7 @@ type ClientOptions = {
     baseUrl: 'https://pidgeon.ai/api/v1' | (string & {});
 };
 /**
- * A mailbox, with the display name when one was given.
+ * An address, with the display name when one was given.
  */
 type Address = {
     email: string;
@@ -442,13 +442,13 @@ type Message = {
     id: string;
     thread_id: string;
     /**
-     * The mailbox this message is in, as an id. What `POST /attachments` and the other endpoints that take a mailbox expect — `identity` below is the same address as text.
+     * The address this message is in, as an id. What `POST /attachments` and the other endpoints that take an `identity_id` expect — `identity` below is the same address as text.
      */
     identity_id: string | null;
     identity: string | null;
     direction: string;
     /**
-     * A mailbox, with the display name when one was given.
+     * An address, with the display name when one was given.
      */
     from: {
         email: string;
@@ -662,13 +662,13 @@ type AwaitedMessage = {
         id: string;
         thread_id: string;
         /**
-         * The mailbox this message is in, as an id. What `POST /attachments` and the other endpoints that take a mailbox expect — `identity` below is the same address as text.
+         * The address this message is in, as an id. What `POST /attachments` and the other endpoints that take an `identity_id` expect — `identity` below is the same address as text.
          */
         identity_id: string | null;
         identity: string | null;
         direction: string;
         /**
-         * A mailbox, with the display name when one was given.
+         * An address, with the display name when one was given.
          */
         from: {
             email: string;
@@ -1180,7 +1180,7 @@ type EventResponse = {
         updated_at: string;
     };
     /**
-     * Which of the mailbox’s addresses answered.
+     * Which of the inbox’s addresses answered.
      */
     attendee: string;
     status: string;
@@ -1192,7 +1192,7 @@ type EventResponse = {
 type InvitationResponse = {
     status: string;
     /**
-     * Which of the mailbox’s addresses answered.
+     * Which of the inbox’s addresses answered.
      */
     attendee: string;
     /**
@@ -1816,7 +1816,7 @@ type SearchHit = {
      */
     folder: 'inbox' | 'starred' | 'sent' | 'drafts' | 'scheduled' | 'snoozed' | 'archive' | 'spam' | 'trash' | 'unauthenticated';
     /**
-     * The mailbox it was found in, as the address. `identity_id` is the same row.
+     * The inbox it was found in, as the address. `identity_id` is the same row.
      */
     identity: string | null;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pidgeon-ai/sdk",
-  "version": "1.31.0",
+  "version": "1.31.1",
   "description": "Email inboxes for AI agents — TypeScript SDK for Pidgeon: create addresses, send, receive and reply.",
   "keywords": [
     "email",