agentmail 0.5.22 → 0.5.23

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "agentmail",
-        "X-Fern-SDK-Version": "0.5.22",
-        "User-Agent": "agentmail/0.5.22",
+        "X-Fern-SDK-Version": "0.5.23",
+        "User-Agent": "agentmail/0.5.23",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

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

@@ -51,6 +51,26 @@ export declare class InboxesClient {
      */
     list(request?: AgentMail.inboxes.ListInboxesRequest, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.ListInboxesResponse>;
     private __list;
+    /**
+     * Searches inboxes in the organization by address or display name, ranked
+     * by relevance. Each word in the query matches the start of a word in the
+     * address or display name, so `sup` matches `support@example.com` but
+     * `port` does not. An exact address match always ranks first. `limit`
+     * cannot exceed 100. A page can be empty and still carry a
+     * `next_page_token`; keep paging until the token is absent.
+     *
+     * @param {AgentMail.inboxes.SearchInboxesRequest} request
+     * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.search({
+     *         q: "q"
+     *     })
+     */
+    search(request: AgentMail.inboxes.SearchInboxesRequest, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.SearchInboxesResponse>;
+    private __search;
     /**
      * **CLI:**
      * ```bash

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

@@ -161,6 +161,83 @@ class InboxesClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/inboxes");
         });
     }
+    /**
+     * Searches inboxes in the organization by address or display name, ranked
+     * by relevance. Each word in the query matches the start of a word in the
+     * address or display name, so `sup` matches `support@example.com` but
+     * `port` does not. An exact address match always ranks first. `limit`
+     * cannot exceed 100. A page can be empty and still carry a
+     * `next_page_token`; keep paging until the token is absent.
+     *
+     * @param {AgentMail.inboxes.SearchInboxesRequest} request
+     * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.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 } = request;
+            const _queryParams = {
+                q,
+                limit,
+                page_token: pageToken,
+            };
+            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/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.inboxes.SearchInboxesResponse.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);
+                    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/search");
+        });
+    }
     /**
      * **CLI:**
      * ```bash

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

@@ -0,0 +1,13 @@
+import type * as AgentMail from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         q: "q"
+ *     }
+ */
+export interface SearchInboxesRequest {
+    /** Address or display name to search for. Matches word prefixes. Must be 2 to 256 characters. */
+    q: string;
+    limit?: AgentMail.Limit;
+    pageToken?: AgentMail.PageToken;
+}

package/dist/cjs/api/resources/inboxes/client/requests/SearchInboxesRequest.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/client/requests/index.d.ts

@@ -1 +1,2 @@
 export type { ListInboxesRequest } from "./ListInboxesRequest.js";
+export type { SearchInboxesRequest } from "./SearchInboxesRequest.js";

package/dist/cjs/api/resources/inboxes/types/SearchInboxesResponse.d.ts

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

package/dist/cjs/api/resources/inboxes/types/SearchInboxesResponse.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/types/index.d.ts

@@ -7,5 +7,6 @@ export * from "./InboxId.js";
 export * from "./ListInboxesResponse.js";
 export * from "./Metadata.js";
 export * from "./MetadataValue.js";
+export * from "./SearchInboxesResponse.js";
 export * from "./UpdateInboxRequest.js";
 export * from "./UpdateMetadata.js";

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

@@ -23,5 +23,6 @@ __exportStar(require("./InboxId.js"), exports);
 __exportStar(require("./ListInboxesResponse.js"), exports);
 __exportStar(require("./Metadata.js"), exports);
 __exportStar(require("./MetadataValue.js"), exports);
+__exportStar(require("./SearchInboxesResponse.js"), exports);
 __exportStar(require("./UpdateInboxRequest.js"), exports);
 __exportStar(require("./UpdateMetadata.js"), exports);

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

@@ -27,6 +27,28 @@ export declare class InboxesClient {
      */
     list(pod_id: AgentMail.pods.PodId, request?: AgentMail.pods.ListInboxesRequest, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.ListInboxesResponse>;
     private __list;
+    /**
+     * Searches inboxes in the pod by address or display name, ranked by
+     * relevance. Each word in the query matches the start of a word in the
+     * address or display name, so `sup` matches `support@example.com` but
+     * `port` does not. An exact address match always ranks first. `limit`
+     * cannot exceed 100. A page can be empty and still carry a
+     * `next_page_token`; keep paging until the token is absent.
+     *
+     * @param {AgentMail.pods.PodId} pod_id
+     * @param {AgentMail.pods.SearchInboxesRequest} request
+     * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.pods.inboxes.search("pod_id", {
+     *         q: "q"
+     *     })
+     */
+    search(pod_id: AgentMail.pods.PodId, request: AgentMail.pods.SearchInboxesRequest, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.SearchInboxesResponse>;
+    private __search;
     /**
      * **CLI:**
      * ```bash

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

@@ -130,6 +130,93 @@ class InboxesClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/pods/{pod_id}/inboxes");
         });
     }
+    /**
+     * Searches inboxes in the pod by address or display name, ranked by
+     * relevance. Each word in the query matches the start of a word in the
+     * address or display name, so `sup` matches `support@example.com` but
+     * `port` does not. An exact address match always ranks first. `limit`
+     * cannot exceed 100. A page can be empty and still carry a
+     * `next_page_token`; keep paging until the token is absent.
+     *
+     * @param {AgentMail.pods.PodId} pod_id
+     * @param {AgentMail.pods.SearchInboxesRequest} request
+     * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.pods.inboxes.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 } = request;
+            const _queryParams = {
+                q,
+                limit,
+                page_token: pageToken,
+            };
+            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 }))}/inboxes/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.inboxes.SearchInboxesResponse.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}/inboxes/search");
+        });
+    }
     /**
      * **CLI:**
      * ```bash

package/dist/cjs/api/resources/pods/resources/inboxes/client/requests/SearchInboxesRequest.d.ts

@@ -0,0 +1,13 @@
+import type * as AgentMail from "../../../../../../index.js";
+/**
+ * @example
+ *     {
+ *         q: "q"
+ *     }
+ */
+export interface SearchInboxesRequest {
+    /** Address or display name to search for. Matches word prefixes. Must be 2 to 256 characters. */
+    q: string;
+    limit?: AgentMail.Limit;
+    pageToken?: AgentMail.PageToken;
+}

package/dist/cjs/api/resources/pods/resources/inboxes/client/requests/SearchInboxesRequest.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/inboxes/client/requests/index.d.ts

@@ -1 +1,2 @@
 export type { ListInboxesRequest } from "./ListInboxesRequest.js";
+export type { SearchInboxesRequest } from "./SearchInboxesRequest.js";

package/dist/cjs/serialization/resources/inboxes/types/SearchInboxesResponse.d.ts

@@ -0,0 +1,16 @@
+import type * as AgentMail from "../../../../api/index.js";
+import * as core from "../../../../core/index.js";
+import type * as serializers from "../../../index.js";
+import { Count } from "../../../types/Count.js";
+import { Limit } from "../../../types/Limit.js";
+import { PageToken } from "../../../types/PageToken.js";
+import { Inbox } from "./Inbox.js";
+export declare const SearchInboxesResponse: core.serialization.ObjectSchema<serializers.inboxes.SearchInboxesResponse.Raw, AgentMail.inboxes.SearchInboxesResponse>;
+export declare namespace SearchInboxesResponse {
+    interface Raw {
+        count: Count.Raw;
+        limit?: Limit.Raw | null;
+        next_page_token?: PageToken.Raw | null;
+        inboxes: Inbox.Raw[];
+    }
+}

package/dist/cjs/serialization/resources/inboxes/types/SearchInboxesResponse.js

@@ -0,0 +1,48 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchInboxesResponse = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+const Count_js_1 = require("../../../types/Count.js");
+const Limit_js_1 = require("../../../types/Limit.js");
+const PageToken_js_1 = require("../../../types/PageToken.js");
+const Inbox_js_1 = require("./Inbox.js");
+exports.SearchInboxesResponse = core.serialization.object({
+    count: Count_js_1.Count,
+    limit: Limit_js_1.Limit.optional(),
+    nextPageToken: core.serialization.property("next_page_token", PageToken_js_1.PageToken.optional()),
+    inboxes: core.serialization.list(Inbox_js_1.Inbox),
+});

package/dist/cjs/serialization/resources/inboxes/types/index.d.ts

@@ -7,5 +7,6 @@ export * from "./InboxId.js";
 export * from "./ListInboxesResponse.js";
 export * from "./Metadata.js";
 export * from "./MetadataValue.js";
+export * from "./SearchInboxesResponse.js";
 export * from "./UpdateInboxRequest.js";
 export * from "./UpdateMetadata.js";

package/dist/cjs/serialization/resources/inboxes/types/index.js

@@ -23,5 +23,6 @@ __exportStar(require("./InboxId.js"), exports);
 __exportStar(require("./ListInboxesResponse.js"), exports);
 __exportStar(require("./Metadata.js"), exports);
 __exportStar(require("./MetadataValue.js"), exports);
+__exportStar(require("./SearchInboxesResponse.js"), exports);
 __exportStar(require("./UpdateInboxRequest.js"), exports);
 __exportStar(require("./UpdateMetadata.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.5.22";
+export declare const SDK_VERSION = "0.5.23";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.5.22";
+exports.SDK_VERSION = "0.5.23";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "agentmail",
-        "X-Fern-SDK-Version": "0.5.22",
-        "User-Agent": "agentmail/0.5.22",
+        "X-Fern-SDK-Version": "0.5.23",
+        "User-Agent": "agentmail/0.5.23",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/esm/api/resources/inboxes/client/Client.d.mts

@@ -51,6 +51,26 @@ export declare class InboxesClient {
      */
     list(request?: AgentMail.inboxes.ListInboxesRequest, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.ListInboxesResponse>;
     private __list;
+    /**
+     * Searches inboxes in the organization by address or display name, ranked
+     * by relevance. Each word in the query matches the start of a word in the
+     * address or display name, so `sup` matches `support@example.com` but
+     * `port` does not. An exact address match always ranks first. `limit`
+     * cannot exceed 100. A page can be empty and still carry a
+     * `next_page_token`; keep paging until the token is absent.
+     *
+     * @param {AgentMail.inboxes.SearchInboxesRequest} request
+     * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.search({
+     *         q: "q"
+     *     })
+     */
+    search(request: AgentMail.inboxes.SearchInboxesRequest, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.SearchInboxesResponse>;
+    private __search;
     /**
      * **CLI:**
      * ```bash

package/dist/esm/api/resources/inboxes/client/Client.mjs

@@ -125,6 +125,83 @@ export class InboxesClient {
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v0/inboxes");
         });
     }
+    /**
+     * Searches inboxes in the organization by address or display name, ranked
+     * by relevance. Each word in the query matches the start of a word in the
+     * address or display name, so `sup` matches `support@example.com` but
+     * `port` does not. An exact address match always ranks first. `limit`
+     * cannot exceed 100. A page can be empty and still carry a
+     * `next_page_token`; keep paging until the token is absent.
+     *
+     * @param {AgentMail.inboxes.SearchInboxesRequest} request
+     * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.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 } = request;
+            const _queryParams = {
+                q,
+                limit,
+                page_token: pageToken,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = 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/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.inboxes.SearchInboxesResponse.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);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v0/inboxes/search");
+        });
+    }
     /**
      * **CLI:**
      * ```bash

package/dist/esm/api/resources/inboxes/client/requests/SearchInboxesRequest.d.mts

@@ -0,0 +1,13 @@
+import type * as AgentMail from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         q: "q"
+ *     }
+ */
+export interface SearchInboxesRequest {
+    /** Address or display name to search for. Matches word prefixes. Must be 2 to 256 characters. */
+    q: string;
+    limit?: AgentMail.Limit;
+    pageToken?: AgentMail.PageToken;
+}

package/dist/esm/api/resources/inboxes/client/requests/SearchInboxesRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/inboxes/client/requests/index.d.mts

@@ -1 +1,2 @@
 export type { ListInboxesRequest } from "./ListInboxesRequest.mjs";
+export type { SearchInboxesRequest } from "./SearchInboxesRequest.mjs";

package/dist/esm/api/resources/inboxes/types/SearchInboxesResponse.d.mts

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

package/dist/esm/api/resources/inboxes/types/SearchInboxesResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/inboxes/types/index.d.mts

@@ -7,5 +7,6 @@ export * from "./InboxId.mjs";
 export * from "./ListInboxesResponse.mjs";
 export * from "./Metadata.mjs";
 export * from "./MetadataValue.mjs";
+export * from "./SearchInboxesResponse.mjs";
 export * from "./UpdateInboxRequest.mjs";
 export * from "./UpdateMetadata.mjs";

package/dist/esm/api/resources/inboxes/types/index.mjs

@@ -7,5 +7,6 @@ export * from "./InboxId.mjs";
 export * from "./ListInboxesResponse.mjs";
 export * from "./Metadata.mjs";
 export * from "./MetadataValue.mjs";
+export * from "./SearchInboxesResponse.mjs";
 export * from "./UpdateInboxRequest.mjs";
 export * from "./UpdateMetadata.mjs";

package/dist/esm/api/resources/pods/resources/inboxes/client/Client.d.mts

@@ -27,6 +27,28 @@ export declare class InboxesClient {
      */
     list(pod_id: AgentMail.pods.PodId, request?: AgentMail.pods.ListInboxesRequest, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.ListInboxesResponse>;
     private __list;
+    /**
+     * Searches inboxes in the pod by address or display name, ranked by
+     * relevance. Each word in the query matches the start of a word in the
+     * address or display name, so `sup` matches `support@example.com` but
+     * `port` does not. An exact address match always ranks first. `limit`
+     * cannot exceed 100. A page can be empty and still carry a
+     * `next_page_token`; keep paging until the token is absent.
+     *
+     * @param {AgentMail.pods.PodId} pod_id
+     * @param {AgentMail.pods.SearchInboxesRequest} request
+     * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.pods.inboxes.search("pod_id", {
+     *         q: "q"
+     *     })
+     */
+    search(pod_id: AgentMail.pods.PodId, request: AgentMail.pods.SearchInboxesRequest, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.SearchInboxesResponse>;
+    private __search;
     /**
      * **CLI:**
      * ```bash

package/dist/esm/api/resources/pods/resources/inboxes/client/Client.mjs

@@ -94,6 +94,93 @@ export class InboxesClient {
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v0/pods/{pod_id}/inboxes");
         });
     }
+    /**
+     * Searches inboxes in the pod by address or display name, ranked by
+     * relevance. Each word in the query matches the start of a word in the
+     * address or display name, so `sup` matches `support@example.com` but
+     * `port` does not. An exact address match always ranks first. `limit`
+     * cannot exceed 100. A page can be empty and still carry a
+     * `next_page_token`; keep paging until the token is absent.
+     *
+     * @param {AgentMail.pods.PodId} pod_id
+     * @param {AgentMail.pods.SearchInboxesRequest} request
+     * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.pods.inboxes.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 } = request;
+            const _queryParams = {
+                q,
+                limit,
+                page_token: pageToken,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = 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 }))}/inboxes/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.inboxes.SearchInboxesResponse.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 handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v0/pods/{pod_id}/inboxes/search");
+        });
+    }
     /**
      * **CLI:**
      * ```bash

package/dist/esm/api/resources/pods/resources/inboxes/client/requests/SearchInboxesRequest.d.mts

@@ -0,0 +1,13 @@
+import type * as AgentMail from "../../../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         q: "q"
+ *     }
+ */
+export interface SearchInboxesRequest {
+    /** Address or display name to search for. Matches word prefixes. Must be 2 to 256 characters. */
+    q: string;
+    limit?: AgentMail.Limit;
+    pageToken?: AgentMail.PageToken;
+}

package/dist/esm/api/resources/pods/resources/inboxes/client/requests/SearchInboxesRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/pods/resources/inboxes/client/requests/index.d.mts

@@ -1 +1,2 @@
 export type { ListInboxesRequest } from "./ListInboxesRequest.mjs";
+export type { SearchInboxesRequest } from "./SearchInboxesRequest.mjs";

package/dist/esm/serialization/resources/inboxes/types/SearchInboxesResponse.d.mts

@@ -0,0 +1,16 @@
+import type * as AgentMail from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+import type * as serializers from "../../../index.mjs";
+import { Count } from "../../../types/Count.mjs";
+import { Limit } from "../../../types/Limit.mjs";
+import { PageToken } from "../../../types/PageToken.mjs";
+import { Inbox } from "./Inbox.mjs";
+export declare const SearchInboxesResponse: core.serialization.ObjectSchema<serializers.inboxes.SearchInboxesResponse.Raw, AgentMail.inboxes.SearchInboxesResponse>;
+export declare namespace SearchInboxesResponse {
+    interface Raw {
+        count: Count.Raw;
+        limit?: Limit.Raw | null;
+        next_page_token?: PageToken.Raw | null;
+        inboxes: Inbox.Raw[];
+    }
+}

package/dist/esm/serialization/resources/inboxes/types/SearchInboxesResponse.mjs

@@ -0,0 +1,12 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../../../core/index.mjs";
+import { Count } from "../../../types/Count.mjs";
+import { Limit } from "../../../types/Limit.mjs";
+import { PageToken } from "../../../types/PageToken.mjs";
+import { Inbox } from "./Inbox.mjs";
+export const SearchInboxesResponse = core.serialization.object({
+    count: Count,
+    limit: Limit.optional(),
+    nextPageToken: core.serialization.property("next_page_token", PageToken.optional()),
+    inboxes: core.serialization.list(Inbox),
+});

package/dist/esm/serialization/resources/inboxes/types/index.d.mts

@@ -7,5 +7,6 @@ export * from "./InboxId.mjs";
 export * from "./ListInboxesResponse.mjs";
 export * from "./Metadata.mjs";
 export * from "./MetadataValue.mjs";
+export * from "./SearchInboxesResponse.mjs";
 export * from "./UpdateInboxRequest.mjs";
 export * from "./UpdateMetadata.mjs";

package/dist/esm/serialization/resources/inboxes/types/index.mjs

@@ -7,5 +7,6 @@ export * from "./InboxId.mjs";
 export * from "./ListInboxesResponse.mjs";
 export * from "./Metadata.mjs";
 export * from "./MetadataValue.mjs";
+export * from "./SearchInboxesResponse.mjs";
 export * from "./UpdateInboxRequest.mjs";
 export * from "./UpdateMetadata.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.5.22";
+export declare const SDK_VERSION = "0.5.23";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.5.22";
+export const SDK_VERSION = "0.5.23";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "agentmail",
-    "version": "0.5.22",
+    "version": "0.5.23",
     "private": false,
     "repository": {
         "type": "git",

package/reference.md

@@ -62,6 +62,76 @@ await client.inboxes.list();
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.inboxes.<a href="/src/api/resources/inboxes/client/Client.ts">search</a>({ ...params }) -> AgentMail.SearchInboxesResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Searches inboxes in the organization by address or display name, ranked
+by relevance. Each word in the query matches the start of a word in the
+address or display name, so `sup` matches `support@example.com` but
+`port` does not. An exact address match always ranks first. `limit`
+cannot exceed 100. A page can be empty and still carry a
+`next_page_token`; keep paging until the token is absent.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.inboxes.search({
+    q: "q"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.inboxes.SearchInboxesRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `InboxesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -8171,6 +8241,84 @@ await client.pods.inboxes.list("pod_id");
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.pods.inboxes.<a href="/src/api/resources/pods/resources/inboxes/client/Client.ts">search</a>(pod_id, { ...params }) -> AgentMail.SearchInboxesResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Searches inboxes in the pod by address or display name, ranked by
+relevance. Each word in the query matches the start of a word in the
+address or display name, so `sup` matches `support@example.com` but
+`port` does not. An exact address match always ranks first. `limit`
+cannot exceed 100. A page can be empty and still carry a
+`next_page_token`; keep paging until the token is absent.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.pods.inboxes.search("pod_id", {
+    q: "q"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**pod_id:** `AgentMail.PodId` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.pods.SearchInboxesRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `InboxesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>