agentmail 0.5.7 → 0.5.9

package/dist/cjs/api/resources/inboxes/resources/threads/client/Client.js

@@ -58,6 +58,11 @@ class ThreadsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
+     * Lists threads in the inbox, most recent first. Pass `senders`,
+     * `recipients`, or `subject` to filter by substring. Filtered requests are
+     * served by search, which caps `limit` at 100. For relevance-ranked
+     * full-text search, use `Search Threads`.
+     *
      * **CLI:**
      * ```bash
      * agentmail inboxes:threads list --inbox-id <inbox_id>
@@ -78,7 +83,7 @@ class ThreadsClient {
     __list(inbox_id_1) {
         return __awaiter(this, arguments, void 0, function* (inbox_id, request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { limit, pageToken, labels, before, after, ascending, includeSpam, includeBlocked, includeUnauthenticated, includeTrash, } = request;
+            const { limit, pageToken, labels, before, after, ascending, includeSpam, includeBlocked, includeUnauthenticated, includeTrash, senders, recipients, subject, } = request;
             const _queryParams = {
                 limit,
                 page_token: pageToken,
@@ -99,6 +104,9 @@ class ThreadsClient {
                 include_blocked: includeBlocked,
                 include_unauthenticated: includeUnauthenticated,
                 include_trash: includeTrash,
+                senders: senders != null ? (0, json_js_1.toJson)(senders) : undefined,
+                recipients: recipients != null ? (0, json_js_1.toJson)(recipients) : undefined,
+                subject: subject != null ? (0, json_js_1.toJson)(subject) : undefined,
             };
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
@@ -147,6 +155,97 @@ class ThreadsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/inboxes/{inbox_id}/threads");
         });
     }
+    /**
+     * Full-text search across threads in the inbox, ranked by relevance. The
+     * query is matched against senders, recipients, and subject (substring)
+     * and the message body (tokenized full text). Spam, trash, blocked, and
+     * unauthenticated threads are always excluded. `limit` cannot exceed 100.
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.inboxes.SearchThreadsRequest} request
+     * @param {ThreadsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.inboxes.threads.search("inbox_id", {
+     *         q: "q"
+     *     })
+     */
+    search(inbox_id, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__search(inbox_id, request, requestOptions));
+    }
+    __search(inbox_id, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { q, limit, pageToken, before, after } = request;
+            const _queryParams = {
+                q,
+                limit,
+                page_token: pageToken,
+                before: before != null
+                    ? serializers.Before.jsonOrThrow(before, { unrecognizedObjectKeys: "strip", omitUndefined: true })
+                    : undefined,
+                after: after != null
+                    ? serializers.After.jsonOrThrow(after, { unrecognizedObjectKeys: "strip", omitUndefined: true })
+                    : undefined,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentMailEnvironment.Prod)
+                    .http, `/v0/inboxes/${core.url.encodePathParam(serializers.inboxes.InboxId.jsonOrThrow(inbox_id, { omitUndefined: true }))}/threads/search`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.SearchThreadsResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AgentMail.ValidationError(serializers.ValidationErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 404:
+                        throw new AgentMail.NotFoundError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/inboxes/{inbox_id}/threads/search");
+        });
+    }
     /**
      * **CLI:**
      * ```bash

package/dist/cjs/api/resources/inboxes/resources/threads/client/requests/ListThreadsRequest.d.ts

@@ -14,4 +14,10 @@ export interface ListThreadsRequest {
     includeBlocked?: AgentMail.IncludeBlocked;
     includeUnauthenticated?: AgentMail.IncludeUnauthenticated;
     includeTrash?: AgentMail.IncludeTrash;
+    /** Filter to threads whose senders contain this value (substring match). Repeatable; all values must match. */
+    senders?: string[];
+    /** Filter to threads whose recipients contain this value (substring match). Repeatable; all values must match. */
+    recipients?: string[];
+    /** Filter to threads whose subject contains this value (substring match). Repeatable; all values must match. */
+    subject?: string[];
 }

package/dist/cjs/api/resources/inboxes/resources/threads/client/requests/SearchThreadsRequest.d.ts

@@ -0,0 +1,14 @@
+import type * as AgentMail from "../../../../../../index.js";
+/**
+ * @example
+ *     {
+ *         q: "q"
+ *     }
+ */
+export interface SearchThreadsRequest {
+    q: AgentMail.Query;
+    limit?: AgentMail.Limit;
+    pageToken?: AgentMail.PageToken;
+    before?: AgentMail.Before;
+    after?: AgentMail.After;
+}

package/dist/cjs/api/resources/inboxes/resources/threads/client/requests/SearchThreadsRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/inboxes/resources/threads/client/requests/index.d.ts

@@ -1,2 +1,3 @@
 export type { DeleteThreadRequest } from "./DeleteThreadRequest.js";
 export type { ListThreadsRequest } from "./ListThreadsRequest.js";
+export type { SearchThreadsRequest } from "./SearchThreadsRequest.js";

package/dist/cjs/api/resources/index.d.ts

@@ -5,6 +5,8 @@ export * as apiKeys from "./apiKeys/index.js";
 export * from "./apiKeys/types/index.js";
 export * as attachments from "./attachments/index.js";
 export * from "./attachments/types/index.js";
+export * as auth from "./auth/index.js";
+export * from "./auth/types/index.js";
 export * from "./domains/client/requests/index.js";
 export * as domains from "./domains/index.js";
 export * from "./domains/types/index.js";

package/dist/cjs/api/resources/index.js

@@ -36,7 +36,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.websockets = exports.webhooks = exports.threads = exports.pods = exports.organizations = exports.metrics = exports.messages = exports.lists = exports.inboxes = exports.inboxEvents = exports.events = exports.drafts = exports.domains = exports.attachments = exports.apiKeys = exports.agent = void 0;
+exports.websockets = exports.webhooks = exports.threads = exports.pods = exports.organizations = exports.metrics = exports.messages = exports.lists = exports.inboxes = exports.inboxEvents = exports.events = exports.drafts = exports.domains = exports.auth = exports.attachments = exports.apiKeys = exports.agent = void 0;
 exports.agent = __importStar(require("./agent/index.js"));
 __exportStar(require("./agent/types/index.js"), exports);
 __exportStar(require("./apiKeys/client/requests/index.js"), exports);
@@ -44,6 +44,8 @@ exports.apiKeys = __importStar(require("./apiKeys/index.js"));
 __exportStar(require("./apiKeys/types/index.js"), exports);
 exports.attachments = __importStar(require("./attachments/index.js"));
 __exportStar(require("./attachments/types/index.js"), exports);
+exports.auth = __importStar(require("./auth/index.js"));
+__exportStar(require("./auth/types/index.js"), exports);
 __exportStar(require("./domains/client/requests/index.js"), exports);
 exports.domains = __importStar(require("./domains/index.js"));
 __exportStar(require("./domains/types/index.js"), exports);

package/dist/cjs/api/resources/messages/types/SearchMessageHighlights.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Matched fragments per field on a message search result, with matched terms
+ * wrapped in `**`. A field key is present only when the query matched that
+ * field, so the present keys also tell you which fields produced the hit.
+ */
+export interface SearchMessageHighlights {
+    /** Matched fragments from the sender address. */
+    from?: string[];
+    /** Matched fragments from the recipient addresses (to, cc, or bcc). */
+    recipients?: string[];
+    /** Matched fragments from the subject. */
+    subject?: string[];
+    /** Matched fragments from the message body. */
+    text?: string[];
+}

package/dist/cjs/api/resources/messages/types/SearchMessageHighlights.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/messages/types/SearchMessageItem.d.ts

@@ -0,0 +1,5 @@
+import type * as AgentMail from "../../../index.js";
+export interface SearchMessageItem extends AgentMail.MessageItem {
+    /** Matched fragments per field. Present only when the query matched an indexed field. */
+    highlights?: AgentMail.SearchMessageHighlights;
+}

package/dist/cjs/api/resources/messages/types/SearchMessageItem.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/messages/types/SearchMessagesResponse.d.ts

@@ -0,0 +1,8 @@
+import type * as AgentMail from "../../../index.js";
+export interface SearchMessagesResponse {
+    count: AgentMail.Count;
+    limit?: AgentMail.Limit;
+    nextPageToken?: AgentMail.PageToken;
+    /** Ordered by relevance, best match first. */
+    messages: AgentMail.SearchMessageItem[];
+}

package/dist/cjs/api/resources/messages/types/SearchMessagesResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/messages/types/index.d.ts

@@ -28,6 +28,9 @@ export * from "./RawMessageResponse.js";
 export * from "./ReplyAll.js";
 export * from "./ReplyAllMessageRequest.js";
 export * from "./ReplyToMessageRequest.js";
+export * from "./SearchMessageHighlights.js";
+export * from "./SearchMessageItem.js";
+export * from "./SearchMessagesResponse.js";
 export * from "./SendMessageAttachments.js";
 export * from "./SendMessageBcc.js";
 export * from "./SendMessageCc.js";

package/dist/cjs/api/resources/messages/types/index.js

@@ -44,6 +44,9 @@ __exportStar(require("./RawMessageResponse.js"), exports);
 __exportStar(require("./ReplyAll.js"), exports);
 __exportStar(require("./ReplyAllMessageRequest.js"), exports);
 __exportStar(require("./ReplyToMessageRequest.js"), exports);
+__exportStar(require("./SearchMessageHighlights.js"), exports);
+__exportStar(require("./SearchMessageItem.js"), exports);
+__exportStar(require("./SearchMessagesResponse.js"), exports);
 __exportStar(require("./SendMessageAttachments.js"), exports);
 __exportStar(require("./SendMessageBcc.js"), exports);
 __exportStar(require("./SendMessageCc.js"), exports);

package/dist/cjs/api/resources/pods/resources/threads/client/Client.d.ts

@@ -11,6 +11,11 @@ export declare class ThreadsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<ThreadsClient.Options>;
     constructor(options?: ThreadsClient.Options);
     /**
+     * Lists threads in the pod, most recent first. Pass `senders`,
+     * `recipients`, or `subject` to filter by substring. Filtered requests are
+     * served by search, which caps `limit` at 100. For relevance-ranked
+     * full-text search, use `Search Threads`.
+     *
      * **CLI:**
      * ```bash
      * agentmail pods:threads list --pod-id <pod_id>
@@ -27,6 +32,26 @@ export declare class ThreadsClient {
      */
     list(pod_id: AgentMail.pods.PodId, request?: AgentMail.pods.ListThreadsRequest, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<AgentMail.ListThreadsResponse>;
     private __list;
+    /**
+     * Full-text search across threads in the pod, ranked by relevance. The
+     * query is matched against senders, recipients, and subject (substring)
+     * and the message body (tokenized full text). Spam, trash, blocked, and
+     * unauthenticated threads are always excluded. `limit` cannot exceed 100.
+     *
+     * @param {AgentMail.pods.PodId} pod_id
+     * @param {AgentMail.pods.SearchThreadsRequest} request
+     * @param {ThreadsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.pods.threads.search("pod_id", {
+     *         q: "q"
+     *     })
+     */
+    search(pod_id: AgentMail.pods.PodId, request: AgentMail.pods.SearchThreadsRequest, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<AgentMail.SearchThreadsResponse>;
+    private __search;
     /**
      * **CLI:**
      * ```bash

package/dist/cjs/api/resources/pods/resources/threads/client/Client.js

@@ -58,6 +58,11 @@ class ThreadsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
+     * Lists threads in the pod, most recent first. Pass `senders`,
+     * `recipients`, or `subject` to filter by substring. Filtered requests are
+     * served by search, which caps `limit` at 100. For relevance-ranked
+     * full-text search, use `Search Threads`.
+     *
      * **CLI:**
      * ```bash
      * agentmail pods:threads list --pod-id <pod_id>
@@ -78,7 +83,7 @@ class ThreadsClient {
     __list(pod_id_1) {
         return __awaiter(this, arguments, void 0, function* (pod_id, request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { limit, pageToken, labels, before, after, ascending, includeSpam, includeBlocked, includeUnauthenticated, includeTrash, } = request;
+            const { limit, pageToken, labels, before, after, ascending, includeSpam, includeBlocked, includeUnauthenticated, includeTrash, senders, recipients, subject, } = request;
             const _queryParams = {
                 limit,
                 page_token: pageToken,
@@ -99,6 +104,9 @@ class ThreadsClient {
                 include_blocked: includeBlocked,
                 include_unauthenticated: includeUnauthenticated,
                 include_trash: includeTrash,
+                senders: senders != null ? (0, json_js_1.toJson)(senders) : undefined,
+                recipients: recipients != null ? (0, json_js_1.toJson)(recipients) : undefined,
+                subject: subject != null ? (0, json_js_1.toJson)(subject) : undefined,
             };
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
@@ -147,6 +155,97 @@ class ThreadsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/pods/{pod_id}/threads");
         });
     }
+    /**
+     * Full-text search across threads in the pod, ranked by relevance. The
+     * query is matched against senders, recipients, and subject (substring)
+     * and the message body (tokenized full text). Spam, trash, blocked, and
+     * unauthenticated threads are always excluded. `limit` cannot exceed 100.
+     *
+     * @param {AgentMail.pods.PodId} pod_id
+     * @param {AgentMail.pods.SearchThreadsRequest} request
+     * @param {ThreadsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.pods.threads.search("pod_id", {
+     *         q: "q"
+     *     })
+     */
+    search(pod_id, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__search(pod_id, request, requestOptions));
+    }
+    __search(pod_id, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { q, limit, pageToken, before, after } = request;
+            const _queryParams = {
+                q,
+                limit,
+                page_token: pageToken,
+                before: before != null
+                    ? serializers.Before.jsonOrThrow(before, { unrecognizedObjectKeys: "strip", omitUndefined: true })
+                    : undefined,
+                after: after != null
+                    ? serializers.After.jsonOrThrow(after, { unrecognizedObjectKeys: "strip", omitUndefined: true })
+                    : undefined,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentMailEnvironment.Prod)
+                    .http, `/v0/pods/${core.url.encodePathParam(serializers.pods.PodId.jsonOrThrow(pod_id, { omitUndefined: true }))}/threads/search`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.SearchThreadsResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AgentMail.ValidationError(serializers.ValidationErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 404:
+                        throw new AgentMail.NotFoundError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/pods/{pod_id}/threads/search");
+        });
+    }
     /**
      * **CLI:**
      * ```bash

package/dist/cjs/api/resources/pods/resources/threads/client/requests/ListThreadsRequest.d.ts

@@ -14,4 +14,10 @@ export interface ListThreadsRequest {
     includeBlocked?: AgentMail.IncludeBlocked;
     includeUnauthenticated?: AgentMail.IncludeUnauthenticated;
     includeTrash?: AgentMail.IncludeTrash;
+    /** Filter to threads whose senders contain this value (substring match). Repeatable; all values must match. */
+    senders?: string[];
+    /** Filter to threads whose recipients contain this value (substring match). Repeatable; all values must match. */
+    recipients?: string[];
+    /** Filter to threads whose subject contains this value (substring match). Repeatable; all values must match. */
+    subject?: string[];
 }

package/dist/cjs/api/resources/pods/resources/threads/client/requests/SearchThreadsRequest.d.ts

@@ -0,0 +1,14 @@
+import type * as AgentMail from "../../../../../../index.js";
+/**
+ * @example
+ *     {
+ *         q: "q"
+ *     }
+ */
+export interface SearchThreadsRequest {
+    q: AgentMail.Query;
+    limit?: AgentMail.Limit;
+    pageToken?: AgentMail.PageToken;
+    before?: AgentMail.Before;
+    after?: AgentMail.After;
+}

package/dist/cjs/api/resources/pods/resources/threads/client/requests/SearchThreadsRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/pods/resources/threads/client/requests/index.d.ts

@@ -1,2 +1,3 @@
 export type { DeleteThreadRequest } from "./DeleteThreadRequest.js";
 export type { ListThreadsRequest } from "./ListThreadsRequest.js";
+export type { SearchThreadsRequest } from "./SearchThreadsRequest.js";

package/dist/cjs/api/resources/threads/client/Client.d.ts

@@ -11,6 +11,12 @@ export declare class ThreadsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<ThreadsClient.Options>;
     constructor(options?: ThreadsClient.Options);
     /**
+     * Lists threads, most recent first. Pass `senders`, `recipients`, or
+     * `subject` to filter by substring. Filtered requests are served by
+     * search, which caps `limit` at 100. For relevance-ranked full-text
+     * search across senders, recipients, subject, and message body, use
+     * `Search Threads`.
+     *
      * **CLI:**
      * ```bash
      * agentmail threads list
@@ -26,6 +32,26 @@ export declare class ThreadsClient {
      */
     list(request?: AgentMail.ListThreadsRequest, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<AgentMail.ListThreadsResponse>;
     private __list;
+    /**
+     * Full-text search across threads in the organization, ranked by
+     * relevance. The query is matched against senders, recipients, and
+     * subject (substring) and the message body (tokenized full text). Spam,
+     * trash, blocked, and unauthenticated threads are always excluded.
+     * `limit` cannot exceed 100.
+     *
+     * @param {AgentMail.SearchThreadsRequest} request
+     * @param {ThreadsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.threads.search({
+     *         q: "q"
+     *     })
+     */
+    search(request: AgentMail.SearchThreadsRequest, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<AgentMail.SearchThreadsResponse>;
+    private __search;
     /**
      * **CLI:**
      * ```bash

package/dist/cjs/api/resources/threads/client/Client.js

@@ -58,6 +58,12 @@ class ThreadsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
+     * Lists threads, most recent first. Pass `senders`, `recipients`, or
+     * `subject` to filter by substring. Filtered requests are served by
+     * search, which caps `limit` at 100. For relevance-ranked full-text
+     * search across senders, recipients, subject, and message body, use
+     * `Search Threads`.
+     *
      * **CLI:**
      * ```bash
      * agentmail threads list
@@ -77,7 +83,7 @@ class ThreadsClient {
     __list() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { limit, pageToken, labels, before, after, ascending, includeSpam, includeBlocked, includeUnauthenticated, includeTrash, } = request;
+            const { limit, pageToken, labels, before, after, ascending, includeSpam, includeBlocked, includeUnauthenticated, includeTrash, senders, recipients, subject, } = request;
             const _queryParams = {
                 limit,
                 page_token: pageToken,
@@ -98,6 +104,9 @@ class ThreadsClient {
                 include_blocked: includeBlocked,
                 include_unauthenticated: includeUnauthenticated,
                 include_trash: includeTrash,
+                senders: senders != null ? (0, json_js_1.toJson)(senders) : undefined,
+                recipients: recipients != null ? (0, json_js_1.toJson)(recipients) : undefined,
+                subject: subject != null ? (0, json_js_1.toJson)(subject) : undefined,
             };
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
@@ -146,6 +155,97 @@ class ThreadsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/threads");
         });
     }
+    /**
+     * Full-text search across threads in the organization, ranked by
+     * relevance. The query is matched against senders, recipients, and
+     * subject (substring) and the message body (tokenized full text). Spam,
+     * trash, blocked, and unauthenticated threads are always excluded.
+     * `limit` cannot exceed 100.
+     *
+     * @param {AgentMail.SearchThreadsRequest} request
+     * @param {ThreadsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.threads.search({
+     *         q: "q"
+     *     })
+     */
+    search(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__search(request, requestOptions));
+    }
+    __search(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { q, limit, pageToken, before, after } = request;
+            const _queryParams = {
+                q,
+                limit,
+                page_token: pageToken,
+                before: before != null
+                    ? serializers.Before.jsonOrThrow(before, { unrecognizedObjectKeys: "strip", omitUndefined: true })
+                    : undefined,
+                after: after != null
+                    ? serializers.After.jsonOrThrow(after, { unrecognizedObjectKeys: "strip", omitUndefined: true })
+                    : undefined,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentMailEnvironment.Prod)
+                    .http, "/v0/threads/search"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.SearchThreadsResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AgentMail.ValidationError(serializers.ValidationErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 404:
+                        throw new AgentMail.NotFoundError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/threads/search");
+        });
+    }
     /**
      * **CLI:**
      * ```bash