@primitivedotdev/sdk 0.9.0 → 0.10.0

package/README.md

@@ -103,6 +103,28 @@ await client.reply(email, {
 });
 ```
 
+### HTML replies and waiting on the delivery outcome
+
+`reply()` accepts `html` as a sibling of `text`, plus the same `wait` flag the
+top-level `send()` takes:
+
+```ts
+await client.reply(email, {
+  text: "Thanks for your email.",
+  html: "<p>Thanks for your email.</p>",
+  wait: true,
+});
+```
+
+`subject` is intentionally not accepted on `reply()`. Gmail's Conversation View
+needs both a References match and a normalized-subject match to thread, so a
+custom subject silently breaks the thread for half the recipient population.
+Use `client.send(...)` if you need full subject control.
+
+If the inbound row is not in a state we can reply to (no `Message-Id` recorded,
+or content was discarded), the API returns `inbound_not_repliable` (HTTP 422)
+and the SDK throws.
+
 ### Forward an inbound email
 
 ```ts

package/dist/api/generated/index.js

@@ -1,2 +1,2 @@
 // This file is auto-generated by @hey-api/openapi-ts
-export { addDomain, createEndpoint, createFilter, deleteDomain, deleteEmail, deleteEndpoint, deleteFilter, downloadAttachments, downloadRawEmail, getAccount, getEmail, getStorageStats, getWebhookSecret, listDeliveries, listDomains, listEmails, listEndpoints, listFilters, replayDelivery, replayEmailWebhooks, rotateWebhookSecret, sendEmail, testEndpoint, updateAccount, updateDomain, updateEndpoint, updateFilter, verifyDomain } from './sdk.gen.js';
+export { addDomain, createEndpoint, createFilter, deleteDomain, deleteEmail, deleteEndpoint, deleteFilter, downloadAttachments, downloadRawEmail, getAccount, getEmail, getStorageStats, getWebhookSecret, listDeliveries, listDomains, listEmails, listEndpoints, listFilters, replayDelivery, replayEmailWebhooks, replyToEmail, rotateWebhookSecret, sendEmail, testEndpoint, updateAccount, updateDomain, updateEndpoint, updateFilter, verifyDomain } from './sdk.gen.js';

package/dist/api/generated/sdk.gen.js

@@ -184,6 +184,32 @@ export const downloadAttachments = (options) => (options.client ?? client).get({
     url: '/emails/{id}/attachments.tar.gz',
     ...options
 });
+/**
+ * Reply to an inbound email
+ *
+ * Sends an outbound reply to the inbound email identified by `id`.
+ * Threading headers (`In-Reply-To`, `References`), recipient
+ * derivation (Reply-To, then From, then bare sender), and the
+ * `Re:` subject prefix are all derived server-side from the
+ * stored inbound row. The request body carries only the message
+ * body and optional `wait` flag; passing any header or recipient
+ * override is rejected by the schema (`additionalProperties:
+ * false`).
+ *
+ * Forwards through the same gates as `/send-mail`: the response
+ * status, error envelope, and `idempotent_replay` flag mirror
+ * the send-mail contract verbatim.
+ *
+ */
+export const replyToEmail = (options) => (options.client ?? client).post({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/emails/{id}/reply',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
 /**
  * Replay email webhooks
  *

package/dist/api/index.d.ts

@@ -1,2 +1,2 @@
-import { $ as AddDomainResponses, $n as ReplayDeliveryResponses, $r as VerifiedDomain, $t as GateDenial, A as getWebhookSecret, An as ListDomainsResponse, Ar as UpdateAccountError, At as DeleteFilterError, B as testEndpoint, Bn as ListEndpointsResponse, Br as UpdateDomainResponses, Bt as DownloadAttachmentsErrors, C as deleteEndpoint, Cn as ListDeliveriesError, Cr as TestEndpointError, Ct as DeleteEmailResponses, D as getAccount, Dn as ListDomainsData, Dr as TestResult, Dt as DeleteEndpointResponse, E as downloadRawEmail, En as ListDeliveriesResponses, Er as TestEndpointResponses, Et as DeleteEndpointErrors, F as listFilters, Fn as ListEmailsResponse, Fr as UpdateDomainData, Ft as DeliverySummary, G as verifyDomain, Gn as ListFiltersErrors, Gr as UpdateEndpointResponse, Gt as DownloadRawEmailErrors, H as updateDomain, Hn as ListEnvelope, Hr as UpdateEndpointError, Ht as DownloadAttachmentsResponses, I as replayDelivery, In as ListEmailsResponses, Ir as UpdateDomainError, It as Domain, J as AddDomainData, Jn as PaginationMeta, Jr as UpdateFilterError, Jt as EmailDetail, K as Account, Kn as ListFiltersResponse, Kr as UpdateEndpointResponses, Kt as DownloadRawEmailResponse, L as replayEmailWebhooks, Ln as ListEndpointsData, Lr as UpdateDomainErrors, Lt as DomainVerifyResult, M as listDomains, Mn as ListEmailsData, Mr as UpdateAccountInput, Mt as DeleteFilterResponse, N as listEmails, Nn as ListEmailsError, Nr as UpdateAccountResponse, Nt as DeleteFilterResponses, O as getEmail, On as ListDomainsError, Or as UnverifiedDomain, Ot as DeleteEndpointResponses, P as listEndpoints, Pn as ListEmailsErrors, Pr as UpdateAccountResponses, Pt as DeliveryStatus, Q as AddDomainResponse, Qn as ReplayDeliveryResponse, Qr as UpdateFilterResponses, Qt as Filter, R as rotateWebhookSecret, Rn as ListEndpointsError, Rr as UpdateDomainInput, Rt as DownloadAttachmentsData, S as deleteEmail, Sn as ListDeliveriesData, Sr as TestEndpointData, St as DeleteEmailResponse, T as downloadAttachments, Tn as ListDeliveriesResponse, Tr as TestEndpointResponse, Tt as DeleteEndpointError, U as updateEndpoint, Un as ListFiltersData, Ur as UpdateEndpointErrors, Ut as DownloadRawEmailData, V as updateAccount, Vn as ListEndpointsResponses, Vr as UpdateEndpointData, Vt as DownloadAttachmentsResponse, W as updateFilter, Wn as ListFiltersError, Wr as UpdateEndpointInput, Wt as DownloadRawEmailError, X as AddDomainErrors, Xn as ReplayDeliveryError, Xr as UpdateFilterInput, Xt as Endpoint, Y as AddDomainError, Yn as ReplayDeliveryData, Yr as UpdateFilterErrors, Yt as EmailSummary, Z as AddDomainInput, Zn as ReplayDeliveryErrors, Zr as UpdateFilterResponse, Zt as ErrorResponse, _ as Options, _n as GetWebhookSecretError, _r as SendMailInput, _t as DeleteDomainResponse, a as PrimitiveApiError, ai as WebhookSecret, an as GetAccountResponses, ar as ReplayResult, at as CreateEndpointResponse, b as createFilter, bn as GetWebhookSecretResponses, br as StorageStats, bt as DeleteEmailError, c as PrimitiveClientOptions, ci as Config, cn as GetEmailErrors, cr as RotateWebhookSecretError, ct as CreateFilterError, d as SendResult, di as RequestOptions, dn as GetStorageStatsData, dr as RotateWebhookSecretResponses, dt as CreateFilterResponse, ei as VerifyDomainData, en as GateFix, er as ReplayEmailWebhooksData, et as ClientOptions, f as SendThreadInput, fi as RequestResult, fn as GetStorageStatsError, fr as SendEmailData, ft as CreateFilterResponses, g as operations, gn as GetWebhookSecretData, gr as SendEmailResponses, gt as DeleteDomainErrors, h as createPrimitiveClient, hn as GetStorageStatsResponses, hr as SendEmailResponse, ht as DeleteDomainError, i as PrimitiveApiClientOptions, ii as VerifyDomainResponses, in as GetAccountResponse, ir as ReplayEmailWebhooksResponses, it as CreateEndpointInput, j as listDeliveries, jn as ListDomainsResponses, jr as UpdateAccountErrors, jt as DeleteFilterErrors, k as getStorageStats, kn as ListDomainsErrors, kr as UpdateAccountData, kt as DeleteFilterData, l as ReplyInput, li as CreateClientConfig, ln as GetEmailResponse, lr as RotateWebhookSecretErrors, lt as CreateFilterErrors, m as createPrimitiveApiClient, mi as Auth, mn as GetStorageStatsResponse, mr as SendEmailErrors, mt as DeleteDomainData, n as ForwardInput, ni as VerifyDomainErrors, nn as GetAccountError, nr as ReplayEmailWebhooksErrors, nt as CreateEndpointError, o as PrimitiveApiErrorDetails, oi as Client, on as GetEmailData, or as ResourceId, ot as CreateEndpointResponses, p as client, pi as ResponseStyle, pn as GetStorageStatsErrors, pr as SendEmailError, pt as Cursor, q as AccountUpdated, qn as ListFiltersResponses, qr as UpdateFilterData, qt as DownloadRawEmailResponses, r as PrimitiveApiClient, ri as VerifyDomainResponse, rn as GetAccountErrors, rr as ReplayEmailWebhooksResponse, rt as CreateEndpointErrors, s as PrimitiveClient, si as ClientOptions$1, sn as GetEmailError, sr as RotateWebhookSecretData, st as CreateFilterData, t as DEFAULT_BASE_URL, ti as VerifyDomainError, tn as GetAccountData, tr as ReplayEmailWebhooksError, tt as CreateEndpointData, u as SendInput, ui as Options$1, un as GetEmailResponses, ur as RotateWebhookSecretResponse, ut as CreateFilterInput, v as addDomain, vn as GetWebhookSecretErrors, vr as SendMailResult, vt as DeleteDomainResponses, w as deleteFilter, wn as ListDeliveriesErrors, wr as TestEndpointErrors, wt as DeleteEndpointData, x as deleteDomain, xn as Limit, xr as SuccessEnvelope, xt as DeleteEmailErrors, y as createEndpoint, yn as GetWebhookSecretResponse, yr as SentEmailStatus, yt as DeleteEmailData, z as sendEmail, zn as ListEndpointsErrors, zr as UpdateDomainResponse, zt as DownloadAttachmentsError } from "../index-DVow4Fjd.js";
-export { Account, AccountUpdated, AddDomainData, AddDomainError, AddDomainErrors, AddDomainInput, AddDomainResponse, AddDomainResponses, Auth, ClientOptions, CreateClientConfig, CreateEndpointData, CreateEndpointError, CreateEndpointErrors, CreateEndpointInput, CreateEndpointResponse, CreateEndpointResponses, CreateFilterData, CreateFilterError, CreateFilterErrors, CreateFilterInput, CreateFilterResponse, CreateFilterResponses, Cursor, DEFAULT_BASE_URL, DeleteDomainData, DeleteDomainError, DeleteDomainErrors, DeleteDomainResponse, DeleteDomainResponses, DeleteEmailData, DeleteEmailError, DeleteEmailErrors, DeleteEmailResponse, DeleteEmailResponses, DeleteEndpointData, DeleteEndpointError, DeleteEndpointErrors, DeleteEndpointResponse, DeleteEndpointResponses, DeleteFilterData, DeleteFilterError, DeleteFilterErrors, DeleteFilterResponse, DeleteFilterResponses, DeliveryStatus, DeliverySummary, Domain, DomainVerifyResult, DownloadAttachmentsData, DownloadAttachmentsError, DownloadAttachmentsErrors, DownloadAttachmentsResponse, DownloadAttachmentsResponses, DownloadRawEmailData, DownloadRawEmailError, DownloadRawEmailErrors, DownloadRawEmailResponse, DownloadRawEmailResponses, EmailDetail, EmailSummary, Endpoint, ErrorResponse, Filter, ForwardInput, GateDenial, GateFix, GetAccountData, GetAccountError, GetAccountErrors, GetAccountResponse, GetAccountResponses, GetEmailData, GetEmailError, GetEmailErrors, GetEmailResponse, GetEmailResponses, GetStorageStatsData, GetStorageStatsError, GetStorageStatsErrors, GetStorageStatsResponse, GetStorageStatsResponses, GetWebhookSecretData, GetWebhookSecretError, GetWebhookSecretErrors, GetWebhookSecretResponse, GetWebhookSecretResponses, Limit, ListDeliveriesData, ListDeliveriesError, ListDeliveriesErrors, ListDeliveriesResponse, ListDeliveriesResponses, ListDomainsData, ListDomainsError, ListDomainsErrors, ListDomainsResponse, ListDomainsResponses, ListEmailsData, ListEmailsError, ListEmailsErrors, ListEmailsResponse, ListEmailsResponses, ListEndpointsData, ListEndpointsError, ListEndpointsErrors, ListEndpointsResponse, ListEndpointsResponses, ListEnvelope, ListFiltersData, ListFiltersError, ListFiltersErrors, ListFiltersResponse, ListFiltersResponses, Options, PaginationMeta, PrimitiveApiClient, PrimitiveApiClientOptions, PrimitiveApiError, PrimitiveApiErrorDetails, PrimitiveClient, PrimitiveClientOptions, Client as PrimitiveGeneratedApiClient, ClientOptions$1 as PrimitiveGeneratedApiClientOptions, Config as PrimitiveGeneratedApiConfig, Options$1 as PrimitiveGeneratedApiOptions, RequestOptions as PrimitiveGeneratedApiRequestOptions, RequestResult as PrimitiveGeneratedApiRequestResult, ReplayDeliveryData, ReplayDeliveryError, ReplayDeliveryErrors, ReplayDeliveryResponse, ReplayDeliveryResponses, ReplayEmailWebhooksData, ReplayEmailWebhooksError, ReplayEmailWebhooksErrors, ReplayEmailWebhooksResponse, ReplayEmailWebhooksResponses, ReplayResult, ReplyInput, ResourceId, ResponseStyle, RotateWebhookSecretData, RotateWebhookSecretError, RotateWebhookSecretErrors, RotateWebhookSecretResponse, RotateWebhookSecretResponses, SendEmailData, SendEmailError, SendEmailErrors, SendEmailResponse, SendEmailResponses, SendInput, SendMailInput, SendMailResult, SendResult, SendThreadInput, SentEmailStatus, StorageStats, SuccessEnvelope, TestEndpointData, TestEndpointError, TestEndpointErrors, TestEndpointResponse, TestEndpointResponses, TestResult, UnverifiedDomain, UpdateAccountData, UpdateAccountError, UpdateAccountErrors, UpdateAccountInput, UpdateAccountResponse, UpdateAccountResponses, UpdateDomainData, UpdateDomainError, UpdateDomainErrors, UpdateDomainInput, UpdateDomainResponse, UpdateDomainResponses, UpdateEndpointData, UpdateEndpointError, UpdateEndpointErrors, UpdateEndpointInput, UpdateEndpointResponse, UpdateEndpointResponses, UpdateFilterData, UpdateFilterError, UpdateFilterErrors, UpdateFilterInput, UpdateFilterResponse, UpdateFilterResponses, VerifiedDomain, VerifyDomainData, VerifyDomainError, VerifyDomainErrors, VerifyDomainResponse, VerifyDomainResponses, WebhookSecret, addDomain, client, createEndpoint, createFilter, createPrimitiveApiClient, createPrimitiveClient, deleteDomain, deleteEmail, deleteEndpoint, deleteFilter, downloadAttachments, downloadRawEmail, getAccount, getEmail, getStorageStats, getWebhookSecret, listDeliveries, listDomains, listEmails, listEndpoints, listFilters, operations, replayDelivery, replayEmailWebhooks, rotateWebhookSecret, sendEmail, testEndpoint, updateAccount, updateDomain, updateEndpoint, updateFilter, verifyDomain };
+import { $ as AddDomainResponse, $n as ReplayDeliveryErrors, $r as UpdateEndpointResponses, $t as ErrorResponse, A as getWebhookSecret, An as ListDomainsError, Ar as TestEndpointError, At as DeleteFilterData, B as sendEmail, Bn as ListEndpointsError, Br as UpdateAccountResponse, Bt as DownloadAttachmentsError, C as deleteEndpoint, Cn as Limit, Cr as SendEmailResponses, Ct as DeleteEmailResponse, D as getAccount, Dn as ListDeliveriesResponse, Dr as StorageStats, Dt as DeleteEndpointErrors, E as downloadRawEmail, En as ListDeliveriesErrors, Er as SentEmailStatus, Et as DeleteEndpointError, F as listFilters, Fn as ListEmailsError, Fr as UnverifiedDomain, Ft as DeliveryStatus, G as updateFilter, Gn as ListFiltersData, Gr as UpdateDomainInput, Gt as DownloadRawEmailError, H as updateAccount, Hn as ListEndpointsResponse, Hr as UpdateDomainData, Ht as DownloadAttachmentsResponse, I as replayDelivery, In as ListEmailsErrors, Ir as UpdateAccountData, It as DeliverySummary, J as AccountUpdated, Jn as ListFiltersResponse, Jr as UpdateEndpointData, Jt as DownloadRawEmailResponses, K as verifyDomain, Kn as ListFiltersError, Kr as UpdateDomainResponse, Kt as DownloadRawEmailErrors, L as replayEmailWebhooks, Ln as ListEmailsResponse, Lr as UpdateAccountError, Lt as Domain, M as listDomains, Mn as ListDomainsResponse, Mr as TestEndpointResponse, Mt as DeleteFilterErrors, N as listEmails, Nn as ListDomainsResponses, Nr as TestEndpointResponses, Nt as DeleteFilterResponse, O as getEmail, On as ListDeliveriesResponses, Or as SuccessEnvelope, Ot as DeleteEndpointResponse, P as listEndpoints, Pn as ListEmailsData, Pr as TestResult, Pt as DeleteFilterResponses, Q as AddDomainInput, Qn as ReplayDeliveryError, Qr as UpdateEndpointResponse, Qt as Endpoint, R as replyToEmail, Rn as ListEmailsResponses, Rr as UpdateAccountErrors, Rt as DomainVerifyResult, S as deleteEmail, Sn as GetWebhookSecretResponses, Sr as SendEmailResponse, St as DeleteEmailErrors, T as downloadAttachments, Tn as ListDeliveriesError, Tr as SendMailResult, Tt as DeleteEndpointData, U as updateDomain, Un as ListEndpointsResponses, Ur as UpdateDomainError, Ut as DownloadAttachmentsResponses, V as testEndpoint, Vn as ListEndpointsErrors, Vr as UpdateAccountResponses, Vt as DownloadAttachmentsErrors, W as updateEndpoint, Wn as ListEnvelope, Wr as UpdateDomainErrors, Wt as DownloadRawEmailData, X as AddDomainError, Xn as PaginationMeta, Xr as UpdateEndpointErrors, Xt as EmailDetailReply, Y as AddDomainData, Yn as ListFiltersResponses, Yr as UpdateEndpointError, Yt as EmailDetail, Z as AddDomainErrors, Zn as ReplayDeliveryData, Zr as UpdateEndpointInput, Zt as EmailSummary, _ as Options, _i as Options$1, _n as GetStorageStatsResponses, _r as RotateWebhookSecretResponse, _t as DeleteDomainErrors, a as PrimitiveApiError, ai as UpdateFilterResponses, an as GetAccountErrors, ar as ReplayEmailWebhooksResponse, at as CreateEndpointInput, b as createFilter, bi as ResponseStyle, bn as GetWebhookSecretErrors, br as SendEmailError, bt as DeleteEmailData, c as PrimitiveClientOptions, ci as VerifyDomainError, cn as GetEmailData, cr as ReplyToEmailData, ct as CreateFilterData, d as SendResult, di as VerifyDomainResponses, dn as GetEmailResponse, dr as ReplyToEmailResponse, dt as CreateFilterInput, ei as UpdateFilterData, en as Filter, er as ReplayDeliveryResponse, et as AddDomainResponses, f as SendThreadInput, fi as WebhookSecret, fn as GetEmailResponses, fr as ReplyToEmailResponses, ft as CreateFilterResponse, g as operations, gi as CreateClientConfig, gn as GetStorageStatsResponse, gr as RotateWebhookSecretErrors, gt as DeleteDomainError, h as createPrimitiveClient, hi as Config, hn as GetStorageStatsErrors, hr as RotateWebhookSecretError, ht as DeleteDomainData, i as PrimitiveApiClientOptions, ii as UpdateFilterResponse, in as GetAccountError, ir as ReplayEmailWebhooksErrors, it as CreateEndpointErrors, j as listDeliveries, jn as ListDomainsErrors, jr as TestEndpointErrors, jt as DeleteFilterError, k as getStorageStats, kn as ListDomainsData, kr as TestEndpointData, kt as DeleteEndpointResponses, l as ReplyInput, li as VerifyDomainErrors, ln as GetEmailError, lr as ReplyToEmailError, lt as CreateFilterError, m as createPrimitiveApiClient, mi as ClientOptions$1, mn as GetStorageStatsError, mr as RotateWebhookSecretData, mt as Cursor, n as ForwardInput, ni as UpdateFilterErrors, nn as GateFix, nr as ReplayEmailWebhooksData, nt as CreateEndpointData, o as PrimitiveApiErrorDetails, oi as VerifiedDomain, on as GetAccountResponse, or as ReplayEmailWebhooksResponses, ot as CreateEndpointResponse, p as client, pi as Client, pn as GetStorageStatsData, pr as ResourceId, pt as CreateFilterResponses, q as Account, qn as ListFiltersErrors, qr as UpdateDomainResponses, qt as DownloadRawEmailResponse, r as PrimitiveApiClient, ri as UpdateFilterInput, rn as GetAccountData, rr as ReplayEmailWebhooksError, rt as CreateEndpointError, s as PrimitiveClient, si as VerifyDomainData, sn as GetAccountResponses, sr as ReplayResult, st as CreateEndpointResponses, t as DEFAULT_BASE_URL, ti as UpdateFilterError, tn as GateDenial, tr as ReplayDeliveryResponses, tt as ClientOptions, u as SendInput, ui as VerifyDomainResponse, un as GetEmailErrors, ur as ReplyToEmailErrors, ut as CreateFilterErrors, v as addDomain, vi as RequestOptions, vn as GetWebhookSecretData, vr as RotateWebhookSecretResponses, vt as DeleteDomainResponse, w as deleteFilter, wn as ListDeliveriesData, wr as SendMailInput, wt as DeleteEmailResponses, x as deleteDomain, xi as Auth, xn as GetWebhookSecretResponse, xr as SendEmailErrors, xt as DeleteEmailError, y as createEndpoint, yi as RequestResult, yn as GetWebhookSecretError, yr as SendEmailData, yt as DeleteDomainResponses, z as rotateWebhookSecret, zn as ListEndpointsData, zr as UpdateAccountInput, zt as DownloadAttachmentsData } from "../index-K4KbjppU.js";
+export { Account, AccountUpdated, AddDomainData, AddDomainError, AddDomainErrors, AddDomainInput, AddDomainResponse, AddDomainResponses, Auth, ClientOptions, CreateClientConfig, CreateEndpointData, CreateEndpointError, CreateEndpointErrors, CreateEndpointInput, CreateEndpointResponse, CreateEndpointResponses, CreateFilterData, CreateFilterError, CreateFilterErrors, CreateFilterInput, CreateFilterResponse, CreateFilterResponses, Cursor, DEFAULT_BASE_URL, DeleteDomainData, DeleteDomainError, DeleteDomainErrors, DeleteDomainResponse, DeleteDomainResponses, DeleteEmailData, DeleteEmailError, DeleteEmailErrors, DeleteEmailResponse, DeleteEmailResponses, DeleteEndpointData, DeleteEndpointError, DeleteEndpointErrors, DeleteEndpointResponse, DeleteEndpointResponses, DeleteFilterData, DeleteFilterError, DeleteFilterErrors, DeleteFilterResponse, DeleteFilterResponses, DeliveryStatus, DeliverySummary, Domain, DomainVerifyResult, DownloadAttachmentsData, DownloadAttachmentsError, DownloadAttachmentsErrors, DownloadAttachmentsResponse, DownloadAttachmentsResponses, DownloadRawEmailData, DownloadRawEmailError, DownloadRawEmailErrors, DownloadRawEmailResponse, DownloadRawEmailResponses, EmailDetail, EmailDetailReply, EmailSummary, Endpoint, ErrorResponse, Filter, ForwardInput, GateDenial, GateFix, GetAccountData, GetAccountError, GetAccountErrors, GetAccountResponse, GetAccountResponses, GetEmailData, GetEmailError, GetEmailErrors, GetEmailResponse, GetEmailResponses, GetStorageStatsData, GetStorageStatsError, GetStorageStatsErrors, GetStorageStatsResponse, GetStorageStatsResponses, GetWebhookSecretData, GetWebhookSecretError, GetWebhookSecretErrors, GetWebhookSecretResponse, GetWebhookSecretResponses, Limit, ListDeliveriesData, ListDeliveriesError, ListDeliveriesErrors, ListDeliveriesResponse, ListDeliveriesResponses, ListDomainsData, ListDomainsError, ListDomainsErrors, ListDomainsResponse, ListDomainsResponses, ListEmailsData, ListEmailsError, ListEmailsErrors, ListEmailsResponse, ListEmailsResponses, ListEndpointsData, ListEndpointsError, ListEndpointsErrors, ListEndpointsResponse, ListEndpointsResponses, ListEnvelope, ListFiltersData, ListFiltersError, ListFiltersErrors, ListFiltersResponse, ListFiltersResponses, Options, PaginationMeta, PrimitiveApiClient, PrimitiveApiClientOptions, PrimitiveApiError, PrimitiveApiErrorDetails, PrimitiveClient, PrimitiveClientOptions, Client as PrimitiveGeneratedApiClient, ClientOptions$1 as PrimitiveGeneratedApiClientOptions, Config as PrimitiveGeneratedApiConfig, Options$1 as PrimitiveGeneratedApiOptions, RequestOptions as PrimitiveGeneratedApiRequestOptions, RequestResult as PrimitiveGeneratedApiRequestResult, ReplayDeliveryData, ReplayDeliveryError, ReplayDeliveryErrors, ReplayDeliveryResponse, ReplayDeliveryResponses, ReplayEmailWebhooksData, ReplayEmailWebhooksError, ReplayEmailWebhooksErrors, ReplayEmailWebhooksResponse, ReplayEmailWebhooksResponses, ReplayResult, ReplyInput, ReplyToEmailData, ReplyToEmailError, ReplyToEmailErrors, ReplyToEmailResponse, ReplyToEmailResponses, ResourceId, ResponseStyle, RotateWebhookSecretData, RotateWebhookSecretError, RotateWebhookSecretErrors, RotateWebhookSecretResponse, RotateWebhookSecretResponses, SendEmailData, SendEmailError, SendEmailErrors, SendEmailResponse, SendEmailResponses, SendInput, SendMailInput, SendMailResult, SendResult, SendThreadInput, SentEmailStatus, StorageStats, SuccessEnvelope, TestEndpointData, TestEndpointError, TestEndpointErrors, TestEndpointResponse, TestEndpointResponses, TestResult, UnverifiedDomain, UpdateAccountData, UpdateAccountError, UpdateAccountErrors, UpdateAccountInput, UpdateAccountResponse, UpdateAccountResponses, UpdateDomainData, UpdateDomainError, UpdateDomainErrors, UpdateDomainInput, UpdateDomainResponse, UpdateDomainResponses, UpdateEndpointData, UpdateEndpointError, UpdateEndpointErrors, UpdateEndpointInput, UpdateEndpointResponse, UpdateEndpointResponses, UpdateFilterData, UpdateFilterError, UpdateFilterErrors, UpdateFilterInput, UpdateFilterResponse, UpdateFilterResponses, VerifiedDomain, VerifyDomainData, VerifyDomainError, VerifyDomainErrors, VerifyDomainResponse, VerifyDomainResponses, WebhookSecret, addDomain, client, createEndpoint, createFilter, createPrimitiveApiClient, createPrimitiveClient, deleteDomain, deleteEmail, deleteEndpoint, deleteFilter, downloadAttachments, downloadRawEmail, getAccount, getEmail, getStorageStats, getWebhookSecret, listDeliveries, listDomains, listEmails, listEndpoints, listFilters, operations, replayDelivery, replayEmailWebhooks, replyToEmail, rotateWebhookSecret, sendEmail, testEndpoint, updateAccount, updateDomain, updateEndpoint, updateFilter, verifyDomain };

package/dist/api/index.js

@@ -194,43 +194,50 @@ export class PrimitiveClient extends PrimitiveApiClient {
             client: this.client,
             responseStyle: "fields",
         });
-        const response = result.response;
-        if (result.error) {
-            const parsed = parseApiErrorPayload(result.error);
-            throw new PrimitiveApiError(parsed.message, {
-                payload: result.error,
-                status: response?.status,
-                code: parsed.code,
-                gates: parsed.gates,
-                requestId: parsed.requestId,
-                retryAfter: parseRetryAfterHeader(response),
-                details: parsed.details,
-            });
-        }
-        if (!result.data?.data) {
-            throw new PrimitiveApiError("Primitive API returned no send result", {
-                payload: result,
-                status: response?.status,
-            });
-        }
-        return mapSendResult(result.data.data);
+        return unwrapSendResult(result);
     }
+    /**
+     * Reply to an inbound email.
+     *
+     * Calls `POST /emails/{id}/reply`. The server derives recipients
+     * (Reply-To, then From, then sender), subject (`Re: <parent>` with
+     * idempotent prefix), and threading headers (`In-Reply-To`,
+     * `References`) from the stored inbound row. The customer controls
+     * only the body, an optional `from` override, and the `wait` flag.
+     *
+     * Subject overrides are intentionally not supported: Gmail's
+     * Conversation View needs both a References match and a normalized-
+     * subject match to thread, so a custom subject silently breaks the
+     * thread for half the recipient population.
+     */
     async reply(email, input) {
         const resolved = typeof input === "string" ? { text: input } : input;
-        return this.send({
-            from: resolved.from ?? email.receivedBy,
-            to: email.replyTarget.address,
-            subject: resolved.subject ?? email.replySubject,
-            bodyText: resolved.text,
-            thread: {
-                ...(email.thread.messageId
-                    ? { inReplyTo: email.thread.messageId }
-                    : {}),
-                references: email.thread.messageId
-                    ? [...email.thread.references, email.thread.messageId]
-                    : email.thread.references,
-            },
+        // Reject the subject override at runtime so a JS caller (no TS
+        // types) gets the same loud error as a TS caller. Without this,
+        // `client.reply(email, { text, subject: "Custom" })` silently
+        // dropped subject and sent a "Re:" reply, breaking Gmail
+        // threading without telling the caller. Mirrors Python's
+        // ValueError. Checked before the empty-body check so passing
+        // ONLY a subject surfaces the more informative error.
+        if ("subject" in resolved) {
+            throw new TypeError("reply does not support a subject override; the server prepends 'Re:' to the parent's subject for thread continuity");
+        }
+        if (!resolved.text && !resolved.html) {
+            throw new TypeError("reply requires text or html");
+        }
+        const body = {
+            ...(resolved.text !== undefined ? { body_text: resolved.text } : {}),
+            ...(resolved.html !== undefined ? { body_html: resolved.html } : {}),
+            ...(resolved.from !== undefined ? { from: resolved.from } : {}),
+            ...(resolved.wait !== undefined ? { wait: resolved.wait } : {}),
+        };
+        const result = await generatedOperations.replyToEmail({
+            body,
+            path: { id: email.id },
+            client: this.client,
+            responseStyle: "fields",
         });
+        return unwrapSendResult(result);
     }
     async forward(email, input) {
         validateForwardInput(input);
@@ -260,6 +267,34 @@ function buildForwardText(email, intro) {
     ];
     return lines.join("\n").trimEnd();
 }
+/**
+ * Shared response handler for `send`, `reply`, and any future
+ * operation that returns a SendMailResult envelope. Unifies the
+ * error-mapping path so the network call sites only have to invoke
+ * the generated operation.
+ */
+function unwrapSendResult(result) {
+    const response = result.response;
+    if (result.error) {
+        const parsed = parseApiErrorPayload(result.error);
+        throw new PrimitiveApiError(parsed.message, {
+            payload: result.error,
+            status: response?.status,
+            code: parsed.code,
+            gates: parsed.gates,
+            requestId: parsed.requestId,
+            retryAfter: parseRetryAfterHeader(response),
+            details: parsed.details,
+        });
+    }
+    if (!result.data?.data) {
+        throw new PrimitiveApiError("Primitive API returned no send result", {
+            payload: result,
+            status: response?.status,
+        });
+    }
+    return mapSendResult(result.data.data);
+}
 function mapSendResult(result) {
     return {
         id: result.id,
@@ -270,6 +305,10 @@ function mapSendResult(result) {
         clientIdempotencyKey: result.client_idempotency_key,
         requestId: result.request_id,
         contentHash: result.content_hash,
+        // Default to false if the server omits the field (old-format
+        // response, mocked partial response in a customer's tests). The
+        // type signature claims `boolean`, so undefined would be a lie.
+        idempotentReplay: result.idempotent_replay ?? false,
         ...(result.delivery_status !== undefined
             ? { deliveryStatus: result.delivery_status }
             : {}),

package/dist/{api-COSr-Fqm.js → api-CLLpjjWy.js}

@@ -633,6 +633,7 @@ var sdk_gen_exports = /* @__PURE__ */ __exportAll({
 	listFilters: () => listFilters,
 	replayDelivery: () => replayDelivery,
 	replayEmailWebhooks: () => replayEmailWebhooks,
+	replyToEmail: () => replyToEmail,
 	rotateWebhookSecret: () => rotateWebhookSecret,
 	sendEmail: () => sendEmail,
 	testEndpoint: () => testEndpoint,
@@ -872,6 +873,35 @@ const downloadAttachments = (options) => (options.client ?? client$1).get({
 	...options
 });
 /**
+* Reply to an inbound email
+*
+* Sends an outbound reply to the inbound email identified by `id`.
+* Threading headers (`In-Reply-To`, `References`), recipient
+* derivation (Reply-To, then From, then bare sender), and the
+* `Re:` subject prefix are all derived server-side from the
+* stored inbound row. The request body carries only the message
+* body and optional `wait` flag; passing any header or recipient
+* override is rejected by the schema (`additionalProperties:
+* false`).
+*
+* Forwards through the same gates as `/send-mail`: the response
+* status, error envelope, and `idempotent_replay` flag mirror
+* the send-mail contract verbatim.
+*
+*/
+const replyToEmail = (options) => (options.client ?? client$1).post({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/emails/{id}/reply",
+	...options,
+	headers: {
+		"Content-Type": "application/json",
+		...options.headers
+	}
+});
+/**
 * Replay email webhooks
 *
 * Re-delivers the webhook payload for this email to all active
@@ -1211,7 +1241,7 @@ var PrimitiveApiClient = class {
 var PrimitiveClient = class extends PrimitiveApiClient {
 	async send(input) {
 		validateSendInput(input);
-		const result = await sendEmail({
+		return unwrapSendResult(await sendEmail({
 			body: {
 				from: input.from,
 				to: input.to,
@@ -1226,38 +1256,37 @@ var PrimitiveClient = class extends PrimitiveApiClient {
 			...input.idempotencyKey ? { headers: { "Idempotency-Key": input.idempotencyKey } } : {},
 			client: this.client,
 			responseStyle: "fields"
-		});
-		const response = result.response;
-		if (result.error) {
-			const parsed = parseApiErrorPayload(result.error);
-			throw new PrimitiveApiError(parsed.message, {
-				payload: result.error,
-				status: response?.status,
-				code: parsed.code,
-				gates: parsed.gates,
-				requestId: parsed.requestId,
-				retryAfter: parseRetryAfterHeader(response),
-				details: parsed.details
-			});
-		}
-		if (!result.data?.data) throw new PrimitiveApiError("Primitive API returned no send result", {
-			payload: result,
-			status: response?.status
-		});
-		return mapSendResult(result.data.data);
+		}));
 	}
+	/**
+	* Reply to an inbound email.
+	*
+	* Calls `POST /emails/{id}/reply`. The server derives recipients
+	* (Reply-To, then From, then sender), subject (`Re: <parent>` with
+	* idempotent prefix), and threading headers (`In-Reply-To`,
+	* `References`) from the stored inbound row. The customer controls
+	* only the body, an optional `from` override, and the `wait` flag.
+	*
+	* Subject overrides are intentionally not supported: Gmail's
+	* Conversation View needs both a References match and a normalized-
+	* subject match to thread, so a custom subject silently breaks the
+	* thread for half the recipient population.
+	*/
 	async reply(email, input) {
 		const resolved = typeof input === "string" ? { text: input } : input;
-		return this.send({
-			from: resolved.from ?? email.receivedBy,
-			to: email.replyTarget.address,
-			subject: resolved.subject ?? email.replySubject,
-			bodyText: resolved.text,
-			thread: {
-				...email.thread.messageId ? { inReplyTo: email.thread.messageId } : {},
-				references: email.thread.messageId ? [...email.thread.references, email.thread.messageId] : email.thread.references
-			}
-		});
+		if ("subject" in resolved) throw new TypeError("reply does not support a subject override; the server prepends 'Re:' to the parent's subject for thread continuity");
+		if (!resolved.text && !resolved.html) throw new TypeError("reply requires text or html");
+		return unwrapSendResult(await replyToEmail({
+			body: {
+				...resolved.text !== void 0 ? { body_text: resolved.text } : {},
+				...resolved.html !== void 0 ? { body_html: resolved.html } : {},
+				...resolved.from !== void 0 ? { from: resolved.from } : {},
+				...resolved.wait !== void 0 ? { wait: resolved.wait } : {}
+			},
+			path: { id: email.id },
+			client: this.client,
+			responseStyle: "fields"
+		}));
 	}
 	async forward(email, input) {
 		validateForwardInput(input);
@@ -1282,6 +1311,32 @@ function buildForwardText(email, intro) {
 		email.text ?? ""
 	].join("\n").trimEnd();
 }
+/**
+* Shared response handler for `send`, `reply`, and any future
+* operation that returns a SendMailResult envelope. Unifies the
+* error-mapping path so the network call sites only have to invoke
+* the generated operation.
+*/
+function unwrapSendResult(result) {
+	const response = result.response;
+	if (result.error) {
+		const parsed = parseApiErrorPayload(result.error);
+		throw new PrimitiveApiError(parsed.message, {
+			payload: result.error,
+			status: response?.status,
+			code: parsed.code,
+			gates: parsed.gates,
+			requestId: parsed.requestId,
+			retryAfter: parseRetryAfterHeader(response),
+			details: parsed.details
+		});
+	}
+	if (!result.data?.data) throw new PrimitiveApiError("Primitive API returned no send result", {
+		payload: result,
+		status: response?.status
+	});
+	return mapSendResult(result.data.data);
+}
 function mapSendResult(result) {
 	return {
 		id: result.id,
@@ -1292,6 +1347,7 @@ function mapSendResult(result) {
 		clientIdempotencyKey: result.client_idempotency_key,
 		requestId: result.request_id,
 		contentHash: result.content_hash,
+		idempotentReplay: result.idempotent_replay ?? false,
 		...result.delivery_status !== void 0 ? { deliveryStatus: result.delivery_status } : {},
 		...result.smtp_response_code !== void 0 ? { smtpResponseCode: result.smtp_response_code } : {},
 		...result.smtp_response_text !== void 0 ? { smtpResponseText: result.smtp_response_text } : {}
@@ -1308,4 +1364,4 @@ function client(options = {}) {
 }
 const operations = sdk_gen_exports;
 //#endregion
-export { sendEmail as A, listDomains as C, replayDelivery as D, listFilters as E, updateFilter as F, verifyDomain as I, updateAccount as M, updateDomain as N, replayEmailWebhooks as O, updateEndpoint as P, listDeliveries as S, listEndpoints as T, downloadRawEmail as _, client as a, getStorageStats as b, operations as c, createFilter as d, deleteDomain as f, downloadAttachments as g, deleteFilter as h, PrimitiveClient as i, testEndpoint as j, rotateWebhookSecret as k, addDomain as l, deleteEndpoint as m, PrimitiveApiClient as n, createPrimitiveApiClient as o, deleteEmail as p, PrimitiveApiError as r, createPrimitiveClient as s, DEFAULT_BASE_URL as t, createEndpoint as u, getAccount as v, listEmails as w, getWebhookSecret as x, getEmail as y };
+export { rotateWebhookSecret as A, listDomains as C, replayDelivery as D, listFilters as E, updateEndpoint as F, updateFilter as I, verifyDomain as L, testEndpoint as M, updateAccount as N, replayEmailWebhooks as O, updateDomain as P, listDeliveries as S, listEndpoints as T, downloadRawEmail as _, client as a, getStorageStats as b, operations as c, createFilter as d, deleteDomain as f, downloadAttachments as g, deleteFilter as h, PrimitiveClient as i, sendEmail as j, replyToEmail as k, addDomain as l, deleteEndpoint as m, PrimitiveApiClient as n, createPrimitiveApiClient as o, deleteEmail as p, PrimitiveApiError as r, createPrimitiveClient as s, DEFAULT_BASE_URL as t, createEndpoint as u, getAccount as v, listEmails as w, getWebhookSecret as x, getEmail as y };

package/dist/{index-DVow4Fjd.d.ts → index-K4KbjppU.d.ts}

@@ -347,7 +347,7 @@ type PaginationMeta = {
 type ErrorResponse = {
   success: boolean;
   error: {
-    code: 'unauthorized' | 'forbidden' | 'not_found' | 'validation_error' | 'rate_limit_exceeded' | 'internal_error' | 'conflict' | 'mx_conflict' | 'outbound_disabled' | 'cannot_send_from_domain' | 'recipient_not_allowed' | 'outbound_key_missing' | 'outbound_unreachable' | 'outbound_key_invalid' | 'outbound_capacity_exhausted' | 'outbound_response_malformed' | 'outbound_relay_failed';
+    code: 'unauthorized' | 'forbidden' | 'not_found' | 'validation_error' | 'rate_limit_exceeded' | 'internal_error' | 'conflict' | 'mx_conflict' | 'outbound_disabled' | 'cannot_send_from_domain' | 'recipient_not_allowed' | 'outbound_key_missing' | 'outbound_unreachable' | 'outbound_key_invalid' | 'outbound_capacity_exhausted' | 'outbound_response_malformed' | 'outbound_relay_failed' | 'inbound_not_repliable';
     message: string;
     /**
      * Optional structured data that callers can inspect to recover
@@ -579,6 +579,14 @@ type EmailDetail = {
   sender: string;
   recipient: string;
   subject?: string | null;
+  /**
+   * Plain-text body parsed from the inbound MIME, matching the `email.parsed.body_text` field on the webhook payload. Null when the message had no text part or parsing failed.
+   */
+  body_text?: string | null;
+  /**
+   * HTML body parsed from the inbound MIME, matching the `email.parsed.body_html` field on the webhook payload. Null when the message had no HTML part or parsing failed.
+   */
+  body_html?: string | null;
   status: 'pending' | 'accepted' | 'completed' | 'rejected';
   domain: string;
   spam_score?: number | null;
@@ -607,6 +615,42 @@ type EmailDetail = {
    * Parsed to address (same as recipient)
    */
   to_email: string;
+  /**
+   * True when the inbound's sender address has a matching grant
+   * in the org's known-send-addresses list. Advisory: a true
+   * value does not by itself guarantee that a reply will be
+   * accepted by send-mail's gates; the per-send check at send
+   * time remains authoritative.
+   *
+   */
+  from_known_address?: boolean;
+  /**
+   * Sent emails recorded as replies to this inbound, in send
+   * order (ascending). Populated when a customer's send-mail
+   * request carries an `in_reply_to` Message-ID that matches
+   * this inbound's `message_id` in the same org. Includes
+   * attempts that were gate-denied, so the array reflects every
+   * recorded reply attempt regardless of outcome.
+   *
+   */
+  replies: Array<EmailDetailReply>;
+};
+type EmailDetailReply = {
+  /**
+   * Sent-email row id.
+   */
+  id: string;
+  status: SentEmailStatus;
+  /**
+   * Recipient address as recorded on the sent_emails row.
+   */
+  to_address: string;
+  subject?: string | null;
+  created_at: string;
+  /**
+   * Outbound relay queue identifier when available.
+   */
+  queue_id?: string | null;
 };
 type SendMailInput = {
   /**
@@ -648,6 +692,44 @@ type SendMailInput = {
 };
 type SentEmailStatus = 'queued' | 'submitted_to_agent' | 'agent_failed' | 'unknown' | 'delivered' | 'bounced' | 'deferred' | 'wait_timeout';
 type DeliveryStatus = 'delivered' | 'bounced' | 'deferred' | 'wait_timeout';
+/**
+ * Body shape for `/emails/{id}/reply`. Intentionally narrow:
+ * recipients (`to`), subject, and threading headers
+ * (`in_reply_to`, `references`) are derived server-side from
+ * the inbound row referenced by the path id and are rejected by
+ * `additionalProperties` if passed (returns 400).
+ *
+ * `from` IS allowed because of legitimate use cases (display-name
+ * addition, replying from a different verified outbound address,
+ * multi-team triage). Send-mail's per-send `canSendFrom` gate
+ * validates the from-domain regardless, so the override carries
+ * no extra privilege.
+ *
+ */
+type ReplyInput$1 = {
+  /**
+   * Plain-text reply body. At least one of body_text or body_html is required. The combined UTF-8 byte length of body_text and body_html must be at most 262144 bytes (same cap as send-mail).
+   */
+  body_text?: string;
+  /**
+   * HTML reply body. At least one of body_text or body_html is required.
+   */
+  body_html?: string;
+  /**
+   * Optional override for the reply's From header. Defaults to
+   * the inbound's recipient. Use to add a display name (`"Acme
+   * Support" <agent@company.com>`) or to reply from a different
+   * verified outbound address (e.g. multi-team routing where
+   * support@ triages to billing@). The from-domain must be a
+   * verified outbound domain for your org, same as send-mail.
+   *
+   */
+  from?: string;
+  /**
+   * When true, wait for the first downstream SMTP delivery outcome before returning, mirroring the send-mail `wait` semantics.
+   */
+  wait?: boolean;
+};
 type SendMailResult = {
   /**
    * Persisted sent-email attempt ID.
@@ -687,6 +769,15 @@ type SendMailResult = {
    * SMTP response text from the first downstream delivery outcome when wait is true.
    */
   smtp_response_text?: string;
+  /**
+   * True when the response replays a previously-recorded send
+   * keyed by `client_idempotency_key` (same key, same canonical
+   * payload). False on a fresh send and on gate-denied
+   * responses. Lets callers branch on cache state without
+   * diffing fields.
+   *
+   */
+  idempotent_replay: boolean;
 };
 type Endpoint = {
   id: string;
@@ -1359,6 +1450,68 @@ type DownloadAttachmentsResponses = {
   200: Blob | File;
 };
 type DownloadAttachmentsResponse = DownloadAttachmentsResponses[keyof DownloadAttachmentsResponses];
+type ReplyToEmailData = {
+  body: ReplyInput$1;
+  path: {
+    /**
+     * Resource UUID
+     */
+    id: string;
+  };
+  query?: never;
+  url: '/emails/{id}/reply';
+};
+type ReplyToEmailErrors = {
+  /**
+   * Invalid request parameters
+   */
+  400: ErrorResponse;
+  /**
+   * Invalid or missing API key
+   */
+  401: ErrorResponse;
+  /**
+   * Authenticated caller lacks permission for the operation
+   */
+  403: ErrorResponse;
+  /**
+   * Resource not found
+   */
+  404: ErrorResponse;
+  /**
+   * Inbound is not repliable: the row exists but lacks a
+   * `message_id` (no thread anchor) or a `recipient` (cannot
+   * derive the From address).
+   *
+   */
+  422: ErrorResponse;
+  /**
+   * Rate limit exceeded
+   */
+  429: ErrorResponse;
+  /**
+   * Primitive encountered an internal error
+   */
+  500: ErrorResponse;
+  /**
+   * Primitive could not complete the downstream SMTP request
+   */
+  502: ErrorResponse;
+  /**
+   * Primitive is temporarily unable to process the request
+   */
+  503: ErrorResponse;
+};
+type ReplyToEmailError = ReplyToEmailErrors[keyof ReplyToEmailErrors];
+type ReplyToEmailResponses = {
+  /**
+   * Outbound relay result
+   */
+  200: SuccessEnvelope & {
+    data?: SendMailResult;
+  };
+};
+type ReplyToEmailResponse = ReplyToEmailResponses[keyof ReplyToEmailResponses];
 type ReplayEmailWebhooksData = {
   body?: never;
   path: {
@@ -1829,7 +1982,7 @@ type SendEmailResponses = {
 };
 type SendEmailResponse = SendEmailResponses[keyof SendEmailResponses];
 declare namespace sdk_gen_d_exports {
-  export { Options, addDomain, createEndpoint, createFilter, deleteDomain, deleteEmail, deleteEndpoint, deleteFilter, downloadAttachments, downloadRawEmail, getAccount, getEmail, getStorageStats, getWebhookSecret, listDeliveries, listDomains, listEmails, listEndpoints, listFilters, replayDelivery, replayEmailWebhooks, rotateWebhookSecret, sendEmail, testEndpoint, updateAccount, updateDomain, updateEndpoint, updateFilter, verifyDomain };
+  export { Options, addDomain, createEndpoint, createFilter, deleteDomain, deleteEmail, deleteEndpoint, deleteFilter, downloadAttachments, downloadRawEmail, getAccount, getEmail, getStorageStats, getWebhookSecret, listDeliveries, listDomains, listEmails, listEndpoints, listFilters, replayDelivery, replayEmailWebhooks, replyToEmail, rotateWebhookSecret, sendEmail, testEndpoint, updateAccount, updateDomain, updateEndpoint, updateFilter, verifyDomain };
 }
 type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options$1<TData, ThrowOnError, TResponse> & {
   /**
@@ -1948,6 +2101,24 @@ declare const downloadRawEmail: <ThrowOnError extends boolean = false>(options:
  *
  */
 declare const downloadAttachments: <ThrowOnError extends boolean = false>(options: Options<DownloadAttachmentsData, ThrowOnError>) => RequestResult<DownloadAttachmentsResponses, DownloadAttachmentsErrors, ThrowOnError, "fields">;
+/**
+ * Reply to an inbound email
+ *
+ * Sends an outbound reply to the inbound email identified by `id`.
+ * Threading headers (`In-Reply-To`, `References`), recipient
+ * derivation (Reply-To, then From, then bare sender), and the
+ * `Re:` subject prefix are all derived server-side from the
+ * stored inbound row. The request body carries only the message
+ * body and optional `wait` flag; passing any header or recipient
+ * override is rejected by the schema (`additionalProperties:
+ * false`).
+ *
+ * Forwards through the same gates as `/send-mail`: the response
+ * status, error envelope, and `idempotent_replay` flag mirror
+ * the send-mail contract verbatim.
+ *
+ */
+declare const replyToEmail: <ThrowOnError extends boolean = false>(options: Options<ReplyToEmailData, ThrowOnError>) => RequestResult<ReplyToEmailResponses, ReplyToEmailErrors, ThrowOnError, "fields">;
 /**
  * Replay email webhooks
  *
@@ -2077,10 +2248,34 @@ interface SendInput {
   waitTimeoutMs?: number;
   idempotencyKey?: string;
 }
+/**
+ * Input shape for `client.reply(email, input)`.
+ *
+ * Can be a bare string (treated as `text`) or an object. The reply
+ * operation calls the server's `/emails/{id}/reply` endpoint, which
+ * derives recipients, subject (`Re: <parent>`), and threading headers
+ * from the inbound row. The shape here is the small subset of fields
+ * the customer can still control:
+ *
+ * - `text` / `html`: the reply body. At least one is required.
+ * - `from`: optional override for the From header. Defaults server-
+ *   side to the address that received the inbound. Use to add a
+ *   display name (`"Acme Support" <agent@company.com>`) or to reply
+ *   from a different verified outbound address. The from-domain must
+ *   be a verified outbound domain for your org.
+ * - `wait`: when true, wait for the first downstream SMTP delivery
+ *   outcome before resolving. Mirrors send-mail's `wait` semantics.
+ *
+ * `subject` is intentionally not accepted: a custom subject silently
+ * breaks Gmail's threading because Gmail's Conversation View requires
+ * both a References match and a normalized-subject match. Always
+ * sends `Re: <parent>` with idempotent prefixing.
+ */
 type ReplyInput = string | {
-  text: string;
-  subject?: string;
+  text?: string;
+  html?: string;
   from?: string;
+  wait?: boolean;
 };
 interface ForwardInput {
   to: string;
@@ -2097,6 +2292,12 @@ interface SendResult {
   clientIdempotencyKey: string;
   requestId: string;
   contentHash: string;
+  /**
+   * True when the response replays a previously-recorded send keyed by
+   * `clientIdempotencyKey` (same key, same canonical payload). False on
+   * a fresh send and on gate-denied responses.
+   */
+  idempotentReplay: boolean;
   deliveryStatus?: SendMailResult["delivery_status"];
   smtpResponseCode?: number | null;
   smtpResponseText?: string;
@@ -2129,6 +2330,20 @@ declare class PrimitiveApiClient {
 type PrimitiveClientOptions = PrimitiveApiClientOptions;
 declare class PrimitiveClient extends PrimitiveApiClient {
   send(input: SendInput): Promise<SendResult>;
+  /**
+   * Reply to an inbound email.
+   *
+   * Calls `POST /emails/{id}/reply`. The server derives recipients
+   * (Reply-To, then From, then sender), subject (`Re: <parent>` with
+   * idempotent prefix), and threading headers (`In-Reply-To`,
+   * `References`) from the stored inbound row. The customer controls
+   * only the body, an optional `from` override, and the `wait` flag.
+   *
+   * Subject overrides are intentionally not supported: Gmail's
+   * Conversation View needs both a References match and a normalized-
+   * subject match to thread, so a custom subject silently breaks the
+   * thread for half the recipient population.
+   */
   reply(email: ReceivedEmail, input: ReplyInput): Promise<SendResult>;
   forward(email: ReceivedEmail, input: ForwardInput): Promise<SendResult>;
 }
@@ -2137,4 +2352,4 @@ declare function createPrimitiveClient(options?: PrimitiveClientOptions): Primit
 declare function client(options?: PrimitiveClientOptions): PrimitiveClient;
 declare const operations: typeof sdk_gen_d_exports;
 //#endregion
-export { AddDomainResponses as $, ReplayDeliveryResponses as $n, VerifiedDomain as $r, GateDenial as $t, getWebhookSecret as A, ListDomainsResponse as An, UpdateAccountError as Ar, DeleteFilterError as At, testEndpoint as B, ListEndpointsResponse as Bn, UpdateDomainResponses as Br, DownloadAttachmentsErrors as Bt, deleteEndpoint as C, ListDeliveriesError as Cn, TestEndpointError as Cr, DeleteEmailResponses as Ct, getAccount as D, ListDomainsData as Dn, TestResult as Dr, DeleteEndpointResponse as Dt, downloadRawEmail as E, ListDeliveriesResponses as En, TestEndpointResponses as Er, DeleteEndpointErrors as Et, listFilters as F, ListEmailsResponse as Fn, UpdateDomainData as Fr, DeliverySummary as Ft, verifyDomain as G, ListFiltersErrors as Gn, UpdateEndpointResponse as Gr, DownloadRawEmailErrors as Gt, updateDomain as H, ListEnvelope as Hn, UpdateEndpointError as Hr, DownloadAttachmentsResponses as Ht, replayDelivery as I, ListEmailsResponses as In, UpdateDomainError as Ir, Domain as It, AddDomainData as J, PaginationMeta as Jn, UpdateFilterError as Jr, EmailDetail as Jt, Account as K, ListFiltersResponse as Kn, UpdateEndpointResponses as Kr, DownloadRawEmailResponse as Kt, replayEmailWebhooks as L, ListEndpointsData as Ln, UpdateDomainErrors as Lr, DomainVerifyResult as Lt, listDomains as M, ListEmailsData as Mn, UpdateAccountInput as Mr, DeleteFilterResponse as Mt, listEmails as N, ListEmailsError as Nn, UpdateAccountResponse as Nr, DeleteFilterResponses as Nt, getEmail as O, ListDomainsError as On, UnverifiedDomain as Or, DeleteEndpointResponses as Ot, listEndpoints as P, ListEmailsErrors as Pn, UpdateAccountResponses as Pr, DeliveryStatus as Pt, AddDomainResponse as Q, ReplayDeliveryResponse as Qn, UpdateFilterResponses as Qr, Filter as Qt, rotateWebhookSecret as R, ListEndpointsError as Rn, UpdateDomainInput as Rr, DownloadAttachmentsData as Rt, deleteEmail as S, ListDeliveriesData as Sn, TestEndpointData as Sr, DeleteEmailResponse as St, downloadAttachments as T, ListDeliveriesResponse as Tn, TestEndpointResponse as Tr, DeleteEndpointError as Tt, updateEndpoint as U, ListFiltersData as Un, UpdateEndpointErrors as Ur, DownloadRawEmailData as Ut, updateAccount as V, ListEndpointsResponses as Vn, UpdateEndpointData as Vr, DownloadAttachmentsResponse as Vt, updateFilter as W, ListFiltersError as Wn, UpdateEndpointInput as Wr, DownloadRawEmailError as Wt, AddDomainErrors as X, ReplayDeliveryError as Xn, UpdateFilterInput as Xr, Endpoint as Xt, AddDomainError as Y, ReplayDeliveryData as Yn, UpdateFilterErrors as Yr, EmailSummary as Yt, AddDomainInput as Z, ReplayDeliveryErrors as Zn, UpdateFilterResponse as Zr, ErrorResponse as Zt, Options as _, GetWebhookSecretError as _n, SendMailInput as _r, DeleteDomainResponse as _t, PrimitiveApiError as a, WebhookSecret as ai, GetAccountResponses as an, ReplayResult as ar, CreateEndpointResponse as at, createFilter as b, GetWebhookSecretResponses as bn, StorageStats as br, DeleteEmailError as bt, PrimitiveClientOptions as c, Config as ci, GetEmailErrors as cn, RotateWebhookSecretError as cr, CreateFilterError as ct, SendResult as d, RequestOptions as di, GetStorageStatsData as dn, RotateWebhookSecretResponses as dr, CreateFilterResponse as dt, VerifyDomainData as ei, GateFix as en, ReplayEmailWebhooksData as er, ClientOptions as et, SendThreadInput as f, RequestResult as fi, GetStorageStatsError as fn, SendEmailData as fr, CreateFilterResponses as ft, operations as g, GetWebhookSecretData as gn, SendEmailResponses as gr, DeleteDomainErrors as gt, createPrimitiveClient as h, GetStorageStatsResponses as hn, SendEmailResponse as hr, DeleteDomainError as ht, PrimitiveApiClientOptions as i, VerifyDomainResponses as ii, GetAccountResponse as in, ReplayEmailWebhooksResponses as ir, CreateEndpointInput as it, listDeliveries as j, ListDomainsResponses as jn, UpdateAccountErrors as jr, DeleteFilterErrors as jt, getStorageStats as k, ListDomainsErrors as kn, UpdateAccountData as kr, DeleteFilterData as kt, ReplyInput as l, CreateClientConfig as li, GetEmailResponse as ln, RotateWebhookSecretErrors as lr, CreateFilterErrors as lt, createPrimitiveApiClient as m, Auth as mi, GetStorageStatsResponse as mn, SendEmailErrors as mr, DeleteDomainData as mt, ForwardInput as n, VerifyDomainErrors as ni, GetAccountError as nn, ReplayEmailWebhooksErrors as nr, CreateEndpointError as nt, PrimitiveApiErrorDetails as o, Client as oi, GetEmailData as on, ResourceId as or, CreateEndpointResponses as ot, client as p, ResponseStyle as pi, GetStorageStatsErrors as pn, SendEmailError as pr, Cursor as pt, AccountUpdated as q, ListFiltersResponses as qn, UpdateFilterData as qr, DownloadRawEmailResponses as qt, PrimitiveApiClient as r, VerifyDomainResponse as ri, GetAccountErrors as rn, ReplayEmailWebhooksResponse as rr, CreateEndpointErrors as rt, PrimitiveClient as s, ClientOptions$1 as si, GetEmailError as sn, RotateWebhookSecretData as sr, CreateFilterData as st, DEFAULT_BASE_URL as t, VerifyDomainError as ti, GetAccountData as tn, ReplayEmailWebhooksError as tr, CreateEndpointData as tt, SendInput as u, Options$1 as ui, GetEmailResponses as un, RotateWebhookSecretResponse as ur, CreateFilterInput as ut, addDomain as v, GetWebhookSecretErrors as vn, SendMailResult as vr, DeleteDomainResponses as vt, deleteFilter as w, ListDeliveriesErrors as wn, TestEndpointErrors as wr, DeleteEndpointData as wt, deleteDomain as x, Limit as xn, SuccessEnvelope as xr, DeleteEmailErrors as xt, createEndpoint as y, GetWebhookSecretResponse as yn, SentEmailStatus as yr, DeleteEmailData as yt, sendEmail as z, ListEndpointsErrors as zn, UpdateDomainResponse as zr, DownloadAttachmentsError as zt };
+export { AddDomainResponse as $, ReplayDeliveryErrors as $n, UpdateEndpointResponses as $r, ErrorResponse as $t, getWebhookSecret as A, ListDomainsError as An, TestEndpointError as Ar, DeleteFilterData as At, sendEmail as B, ListEndpointsError as Bn, UpdateAccountResponse as Br, DownloadAttachmentsError as Bt, deleteEndpoint as C, Limit as Cn, SendEmailResponses as Cr, DeleteEmailResponse as Ct, getAccount as D, ListDeliveriesResponse as Dn, StorageStats as Dr, DeleteEndpointErrors as Dt, downloadRawEmail as E, ListDeliveriesErrors as En, SentEmailStatus as Er, DeleteEndpointError as Et, listFilters as F, ListEmailsError as Fn, UnverifiedDomain as Fr, DeliveryStatus as Ft, updateFilter as G, ListFiltersData as Gn, UpdateDomainInput as Gr, DownloadRawEmailError as Gt, updateAccount as H, ListEndpointsResponse as Hn, UpdateDomainData as Hr, DownloadAttachmentsResponse as Ht, replayDelivery as I, ListEmailsErrors as In, UpdateAccountData as Ir, DeliverySummary as It, AccountUpdated as J, ListFiltersResponse as Jn, UpdateEndpointData as Jr, DownloadRawEmailResponses as Jt, verifyDomain as K, ListFiltersError as Kn, UpdateDomainResponse as Kr, DownloadRawEmailErrors as Kt, replayEmailWebhooks as L, ListEmailsResponse as Ln, UpdateAccountError as Lr, Domain as Lt, listDomains as M, ListDomainsResponse as Mn, TestEndpointResponse as Mr, DeleteFilterErrors as Mt, listEmails as N, ListDomainsResponses as Nn, TestEndpointResponses as Nr, DeleteFilterResponse as Nt, getEmail as O, ListDeliveriesResponses as On, SuccessEnvelope as Or, DeleteEndpointResponse as Ot, listEndpoints as P, ListEmailsData as Pn, TestResult as Pr, DeleteFilterResponses as Pt, AddDomainInput as Q, ReplayDeliveryError as Qn, UpdateEndpointResponse as Qr, Endpoint as Qt, replyToEmail as R, ListEmailsResponses as Rn, UpdateAccountErrors as Rr, DomainVerifyResult as Rt, deleteEmail as S, GetWebhookSecretResponses as Sn, SendEmailResponse as Sr, DeleteEmailErrors as St, downloadAttachments as T, ListDeliveriesError as Tn, SendMailResult as Tr, DeleteEndpointData as Tt, updateDomain as U, ListEndpointsResponses as Un, UpdateDomainError as Ur, DownloadAttachmentsResponses as Ut, testEndpoint as V, ListEndpointsErrors as Vn, UpdateAccountResponses as Vr, DownloadAttachmentsErrors as Vt, updateEndpoint as W, ListEnvelope as Wn, UpdateDomainErrors as Wr, DownloadRawEmailData as Wt, AddDomainError as X, PaginationMeta as Xn, UpdateEndpointErrors as Xr, EmailDetailReply as Xt, AddDomainData as Y, ListFiltersResponses as Yn, UpdateEndpointError as Yr, EmailDetail as Yt, AddDomainErrors as Z, ReplayDeliveryData as Zn, UpdateEndpointInput as Zr, EmailSummary as Zt, Options as _, Options$1 as _i, GetStorageStatsResponses as _n, RotateWebhookSecretResponse as _r, DeleteDomainErrors as _t, PrimitiveApiError as a, UpdateFilterResponses as ai, GetAccountErrors as an, ReplayEmailWebhooksResponse as ar, CreateEndpointInput as at, createFilter as b, ResponseStyle as bi, GetWebhookSecretErrors as bn, SendEmailError as br, DeleteEmailData as bt, PrimitiveClientOptions as c, VerifyDomainError as ci, GetEmailData as cn, ReplyToEmailData as cr, CreateFilterData as ct, SendResult as d, VerifyDomainResponses as di, GetEmailResponse as dn, ReplyToEmailResponse as dr, CreateFilterInput as dt, UpdateFilterData as ei, Filter as en, ReplayDeliveryResponse as er, AddDomainResponses as et, SendThreadInput as f, WebhookSecret as fi, GetEmailResponses as fn, ReplyToEmailResponses as fr, CreateFilterResponse as ft, operations as g, CreateClientConfig as gi, GetStorageStatsResponse as gn, RotateWebhookSecretErrors as gr, DeleteDomainError as gt, createPrimitiveClient as h, Config as hi, GetStorageStatsErrors as hn, RotateWebhookSecretError as hr, DeleteDomainData as ht, PrimitiveApiClientOptions as i, UpdateFilterResponse as ii, GetAccountError as in, ReplayEmailWebhooksErrors as ir, CreateEndpointErrors as it, listDeliveries as j, ListDomainsErrors as jn, TestEndpointErrors as jr, DeleteFilterError as jt, getStorageStats as k, ListDomainsData as kn, TestEndpointData as kr, DeleteEndpointResponses as kt, ReplyInput as l, VerifyDomainErrors as li, GetEmailError as ln, ReplyToEmailError as lr, CreateFilterError as lt, createPrimitiveApiClient as m, ClientOptions$1 as mi, GetStorageStatsError as mn, RotateWebhookSecretData as mr, Cursor as mt, ForwardInput as n, UpdateFilterErrors as ni, GateFix as nn, ReplayEmailWebhooksData as nr, CreateEndpointData as nt, PrimitiveApiErrorDetails as o, VerifiedDomain as oi, GetAccountResponse as on, ReplayEmailWebhooksResponses as or, CreateEndpointResponse as ot, client as p, Client as pi, GetStorageStatsData as pn, ResourceId as pr, CreateFilterResponses as pt, Account as q, ListFiltersErrors as qn, UpdateDomainResponses as qr, DownloadRawEmailResponse as qt, PrimitiveApiClient as r, UpdateFilterInput as ri, GetAccountData as rn, ReplayEmailWebhooksError as rr, CreateEndpointError as rt, PrimitiveClient as s, VerifyDomainData as si, GetAccountResponses as sn, ReplayResult as sr, CreateEndpointResponses as st, DEFAULT_BASE_URL as t, UpdateFilterError as ti, GateDenial as tn, ReplayDeliveryResponses as tr, ClientOptions as tt, SendInput as u, VerifyDomainResponse as ui, GetEmailErrors as un, ReplyToEmailErrors as ur, CreateFilterErrors as ut, addDomain as v, RequestOptions as vi, GetWebhookSecretData as vn, RotateWebhookSecretResponses as vr, DeleteDomainResponse as vt, deleteFilter as w, ListDeliveriesData as wn, SendMailInput as wr, DeleteEmailResponses as wt, deleteDomain as x, Auth as xi, GetWebhookSecretResponse as xn, SendEmailErrors as xr, DeleteEmailError as xt, createEndpoint as y, RequestResult as yi, GetWebhookSecretError as yn, SendEmailData as yr, DeleteDomainResponses as yt, rotateWebhookSecret as z, ListEndpointsData as zn, UpdateAccountInput as zr, DownloadAttachmentsData as zt };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { A as UnknownEvent, C as ParsedDataFailed, D as RawContentDownloadOnly, E as RawContent, M as WebhookAttachment, N as WebhookEvent, O as RawContentInline, S as ParsedDataComplete, T as ParsedStatus, _ as ForwardResultInline, a as DmarcPolicy, b as KnownWebhookEvent, c as EmailAnalysis, d as EventType, f as ForwardAnalysis, g as ForwardResultAttachmentSkipped, h as ForwardResultAttachmentAnalyzed, i as DkimSignature, j as ValidateEmailAuthResult, k as SpfResult, l as EmailAuth, m as ForwardResult, n as AuthVerdict, o as DmarcResult, p as ForwardOriginalSender, r as DkimResult, s as EmailAddress, t as AuthConfidence, u as EmailReceivedEvent, v as ForwardVerdict, w as ParsedError, x as ParsedData, y as ForwardVerification } from "./types-9vXGZjPd.js";
 import { a as buildReplySubject, c as parseHeaderAddress, i as buildForwardSubject, n as ReceivedEmailAddress, o as formatAddress, r as ReceivedEmailThread, s as normalizeReceivedEmail, t as ReceivedEmail } from "./received-email-DNjpq_Wt.js";
-import { a as PrimitiveApiError, c as PrimitiveClientOptions, d as SendResult, f as SendThreadInput, h as createPrimitiveClient, l as ReplyInput, n as ForwardInput, p as client, s as PrimitiveClient, u as SendInput } from "./index-DVow4Fjd.js";
+import { a as PrimitiveApiError, c as PrimitiveClientOptions, d as SendResult, f as SendThreadInput, h as createPrimitiveClient, l as ReplyInput, n as ForwardInput, p as client, s as PrimitiveClient, u as SendInput } from "./index-K4KbjppU.js";
 import { A as VerifyOptions, B as PAYLOAD_ERRORS, C as signStandardWebhooksPayload, D as PRIMITIVE_CONFIRMED_HEADER, E as LEGACY_SIGNATURE_HEADER, F as VerifyDownloadTokenResult, G as VERIFICATION_ERRORS, H as RAW_EMAIL_ERRORS, I as generateDownloadToken, J as WebhookPayloadErrorCode, K as WebhookErrorCode, L as verifyDownloadToken, M as verifyWebhookSignature, N as GenerateDownloadTokenOptions, O as PRIMITIVE_SIGNATURE_HEADER, P as VerifyDownloadTokenOptions, Q as WebhookVerificationErrorCode, R as safeValidateEmailReceivedEvent, S as StandardWebhooksVerifyOptions, T as LEGACY_CONFIRMED_HEADER, U as RawEmailDecodeError, V as PrimitiveWebhookError, W as RawEmailDecodeErrorCode, X as WebhookValidationErrorCode, Y as WebhookValidationError, Z as WebhookVerificationError, _ as emailReceivedEventJsonSchema, a as confirmedHeaders, b as STANDARD_WEBHOOK_TIMESTAMP_HEADER, c as handleWebhook, d as isRawIncluded, f as parseWebhookEvent, g as validateEmailAuth, h as WEBHOOK_VERSION, i as WebhookHeaders, j as signWebhookPayload, k as SignResult, l as isDownloadExpired, m as verifyRawEmailDownload, n as HandleWebhookOptions, o as decodeRawEmail, p as receive, q as WebhookPayloadError, r as ReceiveRequestOptions, s as getDownloadTimeRemaining, t as DecodeRawEmailOptions, u as isEmailReceivedEvent, v as STANDARD_WEBHOOK_ID_HEADER, w as verifyStandardWebhooksSignature, x as StandardWebhooksSignResult, y as STANDARD_WEBHOOK_SIGNATURE_HEADER, z as validateEmailReceivedEvent } from "./index-CbEivn3S.js";
 
 //#region src/index.d.ts

package/dist/index.js

@@ -1,5 +1,5 @@
 import { a as parseHeaderAddress, i as normalizeReceivedEmail, n as buildReplySubject, r as formatAddress, t as buildForwardSubject } from "./received-email-D6tKtWwW.js";
-import { a as client, i as PrimitiveClient, r as PrimitiveApiError, s as createPrimitiveClient } from "./api-COSr-Fqm.js";
+import { a as client, i as PrimitiveClient, r as PrimitiveApiError, s as createPrimitiveClient } from "./api-CLLpjjWy.js";
 import { A as PRIMITIVE_CONFIRMED_HEADER, B as RAW_EMAIL_ERRORS, C as STANDARD_WEBHOOK_ID_HEADER, D as verifyStandardWebhooksSignature, E as signStandardWebhooksPayload, F as verifyDownloadToken, G as WebhookVerificationError, H as VERIFICATION_ERRORS, I as safeValidateEmailReceivedEvent, L as validateEmailReceivedEvent, M as signWebhookPayload, N as verifyWebhookSignature, O as LEGACY_CONFIRMED_HEADER, P as generateDownloadToken, R as PAYLOAD_ERRORS, S as emailReceivedEventJsonSchema, T as STANDARD_WEBHOOK_TIMESTAMP_HEADER, U as WebhookPayloadError, V as RawEmailDecodeError, W as WebhookValidationError, _ as DmarcResult, a as isDownloadExpired, b as ParsedStatus, c as parseWebhookEvent, d as WEBHOOK_VERSION, f as validateEmailAuth, g as DmarcPolicy, h as DkimResult, i as handleWebhook, j as PRIMITIVE_SIGNATURE_HEADER, k as LEGACY_SIGNATURE_HEADER, l as receive, m as AuthVerdict, n as decodeRawEmail, o as isEmailReceivedEvent, p as AuthConfidence, r as getDownloadTimeRemaining, s as isRawIncluded, t as confirmedHeaders, u as verifyRawEmailDownload, v as EventType, w as STANDARD_WEBHOOK_SIGNATURE_HEADER, x as SpfResult, y as ForwardVerdict, z as PrimitiveWebhookError } from "./webhook-zkN4wUTs.js";
 //#region src/index.ts
 const primitive = {

package/dist/openapi/openapi.generated.js

@@ -842,6 +842,96 @@ export const openapiDocument = {
                 }
             }
         },
+        "/emails/{id}/reply": {
+            "parameters": [
+                {
+                    "$ref": "#/components/parameters/ResourceId"
+                }
+            ],
+            "post": {
+                "operationId": "replyToEmail",
+                "summary": "Reply to an inbound email",
+                "description": "Sends an outbound reply to the inbound email identified by `id`.\nThreading headers (`In-Reply-To`, `References`), recipient\nderivation (Reply-To, then From, then bare sender), and the\n`Re:` subject prefix are all derived server-side from the\nstored inbound row. The request body carries only the message\nbody and optional `wait` flag; passing any header or recipient\noverride is rejected by the schema (`additionalProperties:\nfalse`).\n\nForwards through the same gates as `/send-mail`: the response\nstatus, error envelope, and `idempotent_replay` flag mirror\nthe send-mail contract verbatim.\n",
+                "tags": [
+                    "Sending"
+                ],
+                "requestBody": {
+                    "required": true,
+                    "content": {
+                        "application/json": {
+                            "schema": {
+                                "$ref": "#/components/schemas/ReplyInput"
+                            }
+                        }
+                    }
+                },
+                "responses": {
+                    "200": {
+                        "description": "Outbound relay result",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "allOf": [
+                                        {
+                                            "$ref": "#/components/schemas/SuccessEnvelope"
+                                        },
+                                        {
+                                            "type": "object",
+                                            "properties": {
+                                                "data": {
+                                                    "$ref": "#/components/schemas/SendMailResult"
+                                                }
+                                            }
+                                        }
+                                    ]
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "$ref": "#/components/responses/ValidationError"
+                    },
+                    "401": {
+                        "$ref": "#/components/responses/Unauthorized"
+                    },
+                    "403": {
+                        "$ref": "#/components/responses/Forbidden"
+                    },
+                    "404": {
+                        "$ref": "#/components/responses/NotFound"
+                    },
+                    "422": {
+                        "description": "Inbound is not repliable: the row exists but lacks a\n`message_id` (no thread anchor) or a `recipient` (cannot\nderive the From address).\n",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/ErrorResponse"
+                                },
+                                "example": {
+                                    "success": false,
+                                    "error": {
+                                        "code": "inbound_not_repliable",
+                                        "message": "inbound has no Message-ID; cannot anchor a reply thread"
+                                    }
+                                }
+                            }
+                        }
+                    },
+                    "429": {
+                        "$ref": "#/components/responses/RateLimited"
+                    },
+                    "500": {
+                        "$ref": "#/components/responses/InternalError"
+                    },
+                    "502": {
+                        "$ref": "#/components/responses/BadGateway"
+                    },
+                    "503": {
+                        "$ref": "#/components/responses/ServiceUnavailable"
+                    }
+                }
+            }
+        },
         "/emails/{id}/replay": {
             "parameters": [
                 {
@@ -1819,7 +1909,8 @@ export const openapiDocument = {
                                     "outbound_key_invalid",
                                     "outbound_capacity_exhausted",
                                     "outbound_response_malformed",
-                                    "outbound_relay_failed"
+                                    "outbound_relay_failed",
+                                    "inbound_not_repliable"
                                 ]
                             },
                             "message": {
@@ -2443,6 +2534,20 @@ export const openapiDocument = {
                             "null"
                         ]
                     },
+                    "body_text": {
+                        "type": [
+                            "string",
+                            "null"
+                        ],
+                        "description": "Plain-text body parsed from the inbound MIME, matching the `email.parsed.body_text` field on the webhook payload. Null when the message had no text part or parsing failed."
+                    },
+                    "body_html": {
+                        "type": [
+                            "string",
+                            "null"
+                        ],
+                        "description": "HTML body parsed from the inbound MIME, matching the `email.parsed.body_html` field on the webhook payload. Null when the message had no HTML part or parsing failed."
+                    },
                     "status": {
                         "type": "string",
                         "enum": [
@@ -2577,6 +2682,17 @@ export const openapiDocument = {
                     "to_email": {
                         "type": "string",
                         "description": "Parsed to address (same as recipient)"
+                    },
+                    "from_known_address": {
+                        "type": "boolean",
+                        "description": "True when the inbound's sender address has a matching grant\nin the org's known-send-addresses list. Advisory: a true\nvalue does not by itself guarantee that a reply will be\naccepted by send-mail's gates; the per-send check at send\ntime remains authoritative.\n"
+                    },
+                    "replies": {
+                        "type": "array",
+                        "description": "Sent emails recorded as replies to this inbound, in send\norder (ascending). Populated when a customer's send-mail\nrequest carries an `in_reply_to` Message-ID that matches\nthis inbound's `message_id` in the same org. Includes\nattempts that were gate-denied, so the array reflects every\nrecorded reply attempt regardless of outcome.\n",
+                        "items": {
+                            "$ref": "#/components/schemas/EmailDetailReply"
+                        }
                     }
                 },
                 "required": [
@@ -2589,7 +2705,48 @@ export const openapiDocument = {
                     "received_at",
                     "webhook_attempt_count",
                     "from_email",
-                    "to_email"
+                    "to_email",
+                    "replies"
+                ]
+            },
+            "EmailDetailReply": {
+                "type": "object",
+                "properties": {
+                    "id": {
+                        "type": "string",
+                        "format": "uuid",
+                        "description": "Sent-email row id."
+                    },
+                    "status": {
+                        "$ref": "#/components/schemas/SentEmailStatus"
+                    },
+                    "to_address": {
+                        "type": "string",
+                        "description": "Recipient address as recorded on the sent_emails row."
+                    },
+                    "subject": {
+                        "type": [
+                            "string",
+                            "null"
+                        ]
+                    },
+                    "created_at": {
+                        "type": "string",
+                        "format": "date-time"
+                    },
+                    "queue_id": {
+                        "type": [
+                            "string",
+                            "null"
+                        ],
+                        "description": "Outbound relay queue identifier when available."
+                    }
+                },
+                "required": [
+                    "id",
+                    "status",
+                    "to_address",
+                    "created_at"
                 ]
             },
             "SendMailInput": {
@@ -2679,6 +2836,31 @@ export const openapiDocument = {
                     "wait_timeout"
                 ]
             },
+            "ReplyInput": {
+                "type": "object",
+                "additionalProperties": false,
+                "description": "Body shape for `/emails/{id}/reply`. Intentionally narrow:\nrecipients (`to`), subject, and threading headers\n(`in_reply_to`, `references`) are derived server-side from\nthe inbound row referenced by the path id and are rejected by\n`additionalProperties` if passed (returns 400).\n\n`from` IS allowed because of legitimate use cases (display-name\naddition, replying from a different verified outbound address,\nmulti-team triage). Send-mail's per-send `canSendFrom` gate\nvalidates the from-domain regardless, so the override carries\nno extra privilege.\n",
+                "properties": {
+                    "body_text": {
+                        "type": "string",
+                        "description": "Plain-text reply body. At least one of body_text or body_html is required. The combined UTF-8 byte length of body_text and body_html must be at most 262144 bytes (same cap as send-mail)."
+                    },
+                    "body_html": {
+                        "type": "string",
+                        "description": "HTML reply body. At least one of body_text or body_html is required."
+                    },
+                    "from": {
+                        "type": "string",
+                        "minLength": 3,
+                        "maxLength": 998,
+                        "description": "Optional override for the reply's From header. Defaults to\nthe inbound's recipient. Use to add a display name (`\"Acme\nSupport\" <agent@company.com>`) or to reply from a different\nverified outbound address (e.g. multi-team routing where\nsupport@ triages to billing@). The from-domain must be a\nverified outbound domain for your org, same as send-mail.\n"
+                    },
+                    "wait": {
+                        "type": "boolean",
+                        "description": "When true, wait for the first downstream SMTP delivery outcome before returning, mirroring the send-mail `wait` semantics."
+                    }
+                }
+            },
             "SendMailResult": {
                 "type": "object",
                 "properties": {
@@ -2735,6 +2917,10 @@ export const openapiDocument = {
                     "smtp_response_text": {
                         "type": "string",
                         "description": "SMTP response text from the first downstream delivery outcome when wait is true."
+                    },
+                    "idempotent_replay": {
+                        "type": "boolean",
+                        "description": "True when the response replays a previously-recorded send\nkeyed by `client_idempotency_key` (same key, same canonical\npayload). False on a fresh send and on gate-denied\nresponses. Lets callers branch on cache state without\ndiffing fields.\n"
                     }
                 },
                 "required": [
@@ -2745,7 +2931,8 @@ export const openapiDocument = {
                     "rejected",
                     "client_idempotency_key",
                     "request_id",
-                    "content_hash"
+                    "content_hash",
+                    "idempotent_replay"
                 ]
             },
             "Endpoint": {

package/dist/openapi/operations.generated.js

@@ -752,6 +752,55 @@ export const operationManifest = [
         "tag": "Filters",
         "tagCommand": "filters"
     },
+    {
+        "binaryResponse": false,
+        "bodyRequired": true,
+        "command": "reply-to-email",
+        "description": "Sends an outbound reply to the inbound email identified by `id`.\nThreading headers (`In-Reply-To`, `References`), recipient\nderivation (Reply-To, then From, then bare sender), and the\n`Re:` subject prefix are all derived server-side from the\nstored inbound row. The request body carries only the message\nbody and optional `wait` flag; passing any header or recipient\noverride is rejected by the schema (`additionalProperties:\nfalse`).\n\nForwards through the same gates as `/send-mail`: the response\nstatus, error envelope, and `idempotent_replay` flag mirror\nthe send-mail contract verbatim.\n",
+        "hasJsonBody": true,
+        "method": "POST",
+        "operationId": "replyToEmail",
+        "path": "/emails/{id}/reply",
+        "pathParams": [
+            {
+                "description": "Resource UUID",
+                "enum": null,
+                "name": "id",
+                "required": true,
+                "type": "string"
+            }
+        ],
+        "queryParams": [],
+        "requestSchema": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "Body shape for `/emails/{id}/reply`. Intentionally narrow:\nrecipients (`to`), subject, and threading headers\n(`in_reply_to`, `references`) are derived server-side from\nthe inbound row referenced by the path id and are rejected by\n`additionalProperties` if passed (returns 400).\n\n`from` IS allowed because of legitimate use cases (display-name\naddition, replying from a different verified outbound address,\nmulti-team triage). Send-mail's per-send `canSendFrom` gate\nvalidates the from-domain regardless, so the override carries\nno extra privilege.\n",
+            "properties": {
+                "body_text": {
+                    "type": "string",
+                    "description": "Plain-text reply body. At least one of body_text or body_html is required. The combined UTF-8 byte length of body_text and body_html must be at most 262144 bytes (same cap as send-mail)."
+                },
+                "body_html": {
+                    "type": "string",
+                    "description": "HTML reply body. At least one of body_text or body_html is required."
+                },
+                "from": {
+                    "type": "string",
+                    "minLength": 3,
+                    "maxLength": 998,
+                    "description": "Optional override for the reply's From header. Defaults to\nthe inbound's recipient. Use to add a display name (`\"Acme\nSupport\" <agent@company.com>`) or to reply from a different\nverified outbound address (e.g. multi-team routing where\nsupport@ triages to billing@). The from-domain must be a\nverified outbound domain for your org, same as send-mail.\n"
+                },
+                "wait": {
+                    "type": "boolean",
+                    "description": "When true, wait for the first downstream SMTP delivery outcome before returning, mirroring the send-mail `wait` semantics."
+                }
+            }
+        },
+        "sdkName": "replyToEmail",
+        "summary": "Reply to an inbound email",
+        "tag": "Sending",
+        "tagCommand": "sending"
+    },
     {
         "binaryResponse": false,
         "bodyRequired": true,

package/oclif.manifest.json

@@ -1136,6 +1136,60 @@
       "summary": "Update a filter rule",
       "enableJsonFlag": false
     },
+    "sending:reply-to-email": {
+      "aliases": [],
+      "args": {},
+      "description": "Sends an outbound reply to the inbound email identified by `id`.\nThreading headers (`In-Reply-To`, `References`), recipient\nderivation (Reply-To, then From, then bare sender), and the\n`Re:` subject prefix are all derived server-side from the\nstored inbound row. The request body carries only the message\nbody and optional `wait` flag; passing any header or recipient\noverride is rejected by the schema (`additionalProperties:\nfalse`).\n\nForwards through the same gates as `/send-mail`: the response\nstatus, error envelope, and `idempotent_replay` flag mirror\nthe send-mail contract verbatim.\n\n\nBody fields (JSON --body):\n   body_html  string  HTML reply body. At least one of body_text or body_html is required.\n   body_text  string  Plain-text reply body. At least one of body_text or body_html is required. ...\n   from       string  Optional override for the reply's From header. Defaults to\n   wait       boolean  When true, wait for the first downstream SMTP delivery outcome before retur...\n(* = required)",
+      "flags": {
+        "api-key": {
+          "description": "Primitive API key (defaults to PRIMITIVE_API_KEY)",
+          "env": "PRIMITIVE_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "API base URL (defaults to PRIMITIVE_API_URL or production)",
+          "env": "PRIMITIVE_API_URL",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "id": {
+          "description": "Resource UUID",
+          "name": "id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "body": {
+          "description": "JSON request body",
+          "name": "body",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "body-file": {
+          "description": "Path to a JSON file used as the request body",
+          "name": "body-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sending:reply-to-email",
+      "pluginAlias": "@primitivedotdev/sdk",
+      "pluginName": "@primitivedotdev/sdk",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Reply to an inbound email",
+      "enableJsonFlag": false
+    },
     "sending:send-email": {
       "aliases": [],
       "args": {},
@@ -1309,5 +1363,5 @@
       "enableJsonFlag": false
     }
   },
-  "version": "0.9.0"
+  "version": "0.10.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primitivedotdev/sdk",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Official Primitive Node.js SDK — webhook, api, openapi, contract, and parser modules",
   "type": "module",
   "module": "./dist/index.js",