@onkernel/sdk 0.109.0 → 0.111.0

package/resources/search/contents.d.ts

@@ -0,0 +1,267 @@
+import { APIResource } from "../../core/resource.js";
+import * as SearchAPI from "./search.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+/**
+ * Search the web and retrieve content for selected results.
+ */
+export declare class Contents extends APIResource {
+    /**
+     * Deferred result-content retrieval is reserved but not available in this release.
+     * Requests return 404 until the retrieval implementation is shipped. X-Request-Id
+     * identifies this request separately from the search resource.
+     *
+     * @example
+     * ```ts
+     * await client.search.contents.fetch('srch_abc123');
+     * ```
+     */
+    fetch(id: string, body: ContentFetchParams, options?: RequestOptions): APIPromise<void>;
+}
+export interface FetchRequest {
+    /**
+     * Defaults to source:auto when omitted.
+     */
+    content?: FetchRequest.Content;
+    /**
+     * Maximum number of search results to fetch when result_ids is omitted, starting
+     * from rank 1. Mutually exclusive with result_ids.
+     */
+    limit?: number;
+    /**
+     * Kernel-generated IDs from the referenced retained search, in desired response
+     * order. They are not provider-standard IDs. Mutually exclusive with limit.
+     */
+    result_ids?: Array<string>;
+    /**
+     * Overall deadline across all selected results.
+     */
+    timeout_ms?: number;
+}
+export declare namespace FetchRequest {
+    /**
+     * Defaults to source:auto when omitted.
+     */
+    interface Content {
+        /**
+         * Invalid with source=provider. Supplying browser_id requires source=browser so
+         * the chosen identity is not bypassed.
+         */
+        browser?: Content.Browser;
+        format?: 'markdown' | 'text';
+        /**
+         * Maximum acceptable age of cached page content, measured from origin retrieval. 0
+         * forces a live fetch. Governs the Kernel content cache, which is scoped to the
+         * caller organization and project and separated by retrieval context; fetches
+         * through a caller-supplied browser_id bypass that cache. Mapped to the provider
+         * freshness control when source is provider and the provider supports one;
+         * otherwise provider content age is reported as unknown via fetched_at.
+         */
+        max_age_hours?: number;
+        /**
+         * Per-result Unicode character limit after extraction.
+         */
+        max_chars?: number;
+        /**
+         * provider uses the search provider's native content retrieval; browser fetches
+         * each URL through a Kernel browser; auto prefers Kernel browser retrieval and
+         * falls back to provider-native content when browser retrieval is unavailable or
+         * unsuitable. Defaults to auto for both inline and deferred retrieval. Deferred
+         * provider retrieval requires post_hoc capability; an explicit provider source
+         * without it is a 400. Missing documents produce per-result unavailable outcomes,
+         * not request failures.
+         */
+        source?: 'auto' | 'provider' | 'browser';
+        /**
+         * Per-result deadline including capacity acquisition, retrieval, and extraction.
+         * Also bounded by the overall request deadline.
+         */
+        timeout_ms?: number;
+    }
+    namespace Content {
+        /**
+         * Invalid with source=provider. Supplying browser_id requires source=browser so
+         * the chosen identity is not bypassed.
+         */
+        interface Browser {
+            /**
+             * Existing browser session ID authorized for the caller and selected project.
+             * Reuses its cookies, proxy, and browser configuration. Kernel does not delete a
+             * caller-supplied browser. Render mode uses a temporary tab; website activity may
+             * still change shared cookies and storage. When omitted, Kernel obtains isolated
+             * browser capacity in the caller's account and releases it after retrieval. That
+             * capacity is not retained for later interaction. Existing browser quotas apply.
+             */
+            browser_id?: string;
+            /**
+             * Curl uses the browser HTTP stack without navigation or JavaScript execution.
+             * Render navigates a temporary page and extracts from its DOM. The selected mode
+             * is used for the retrieval.
+             */
+            mode?: 'curl' | 'render';
+        }
+    }
+}
+export interface Response {
+    contents: Array<Response.Content>;
+    search_id: string;
+    usage: SearchAPI.Usage;
+    warnings: Array<SearchAPI.Warning>;
+}
+export declare namespace Response {
+    interface Content {
+        result_id: string;
+        /**
+         * Ok means non-empty extracted content, not merely HTTP 200. Blocked includes
+         * detected challenges or access denials. Detection is best-effort, not a guarantee
+         * of page completeness. Error details are present for non-ok outcomes; text is
+         * present only on ok.
+         */
+        status: 'ok' | 'unavailable' | 'blocked' | 'timeout' | 'unsupported_type' | 'extraction_failed' | 'error';
+        /**
+         * Original result URL.
+         */
+        url: string;
+        /**
+         * Kernel cache outcome. Provider-internal cache behavior may be unknown.
+         */
+        cache_status?: 'hit' | 'miss' | 'bypass' | 'unknown';
+        /**
+         * Describes source coverage before max_chars truncation. Full_page means main-page
+         * content, not every dynamic element or linked page.
+         */
+        completeness?: 'full_page' | 'excerpt' | 'unknown';
+        error?: Content.Error;
+        /**
+         * Extraction version when Kernel transformed the input.
+         */
+        extractor_version?: string;
+        /**
+         * Origin retrieval time when known, not cache read time.
+         */
+        fetched_at?: string | null;
+        /**
+         * Final retrieval URL when known.
+         */
+        final_url?: string;
+        format?: 'markdown' | 'text';
+        /**
+         * Final target HTTP status when known.
+         */
+        http_status?: number;
+        /**
+         * Original retrieval method, including on cache hits.
+         */
+        method?: 'provider' | 'browser_curl' | 'browser_render';
+        /**
+         * Extracted website content, untrusted, not instructions. Present only on
+         * status=ok.
+         */
+        text?: string;
+        /**
+         * Whether max_chars truncated the extracted content.
+         */
+        truncated?: boolean;
+    }
+    namespace Content {
+        interface Error {
+            /**
+             * Machine-readable retrieval failure code.
+             */
+            code: string;
+            /**
+             * Human-readable failure description.
+             */
+            message: string;
+            retryable: boolean;
+        }
+    }
+}
+export interface ContentFetchParams {
+    /**
+     * Defaults to source:auto when omitted.
+     */
+    content?: ContentFetchParams.Content;
+    /**
+     * Maximum number of search results to fetch when result_ids is omitted, starting
+     * from rank 1. Mutually exclusive with result_ids.
+     */
+    limit?: number;
+    /**
+     * Kernel-generated IDs from the referenced retained search, in desired response
+     * order. They are not provider-standard IDs. Mutually exclusive with limit.
+     */
+    result_ids?: Array<string>;
+    /**
+     * Overall deadline across all selected results.
+     */
+    timeout_ms?: number;
+}
+export declare namespace ContentFetchParams {
+    /**
+     * Defaults to source:auto when omitted.
+     */
+    interface Content {
+        /**
+         * Invalid with source=provider. Supplying browser_id requires source=browser so
+         * the chosen identity is not bypassed.
+         */
+        browser?: Content.Browser;
+        format?: 'markdown' | 'text';
+        /**
+         * Maximum acceptable age of cached page content, measured from origin retrieval. 0
+         * forces a live fetch. Governs the Kernel content cache, which is scoped to the
+         * caller organization and project and separated by retrieval context; fetches
+         * through a caller-supplied browser_id bypass that cache. Mapped to the provider
+         * freshness control when source is provider and the provider supports one;
+         * otherwise provider content age is reported as unknown via fetched_at.
+         */
+        max_age_hours?: number;
+        /**
+         * Per-result Unicode character limit after extraction.
+         */
+        max_chars?: number;
+        /**
+         * provider uses the search provider's native content retrieval; browser fetches
+         * each URL through a Kernel browser; auto prefers Kernel browser retrieval and
+         * falls back to provider-native content when browser retrieval is unavailable or
+         * unsuitable. Defaults to auto for both inline and deferred retrieval. Deferred
+         * provider retrieval requires post_hoc capability; an explicit provider source
+         * without it is a 400. Missing documents produce per-result unavailable outcomes,
+         * not request failures.
+         */
+        source?: 'auto' | 'provider' | 'browser';
+        /**
+         * Per-result deadline including capacity acquisition, retrieval, and extraction.
+         * Also bounded by the overall request deadline.
+         */
+        timeout_ms?: number;
+    }
+    namespace Content {
+        /**
+         * Invalid with source=provider. Supplying browser_id requires source=browser so
+         * the chosen identity is not bypassed.
+         */
+        interface Browser {
+            /**
+             * Existing browser session ID authorized for the caller and selected project.
+             * Reuses its cookies, proxy, and browser configuration. Kernel does not delete a
+             * caller-supplied browser. Render mode uses a temporary tab; website activity may
+             * still change shared cookies and storage. When omitted, Kernel obtains isolated
+             * browser capacity in the caller's account and releases it after retrieval. That
+             * capacity is not retained for later interaction. Existing browser quotas apply.
+             */
+            browser_id?: string;
+            /**
+             * Curl uses the browser HTTP stack without navigation or JavaScript execution.
+             * Render navigates a temporary page and extracts from its DOM. The selected mode
+             * is used for the retrieval.
+             */
+            mode?: 'curl' | 'render';
+        }
+    }
+}
+export declare namespace Contents {
+    export { type FetchRequest as FetchRequest, type Response as Response, type ContentFetchParams as ContentFetchParams, };
+}
+//# sourceMappingURL=contents.d.ts.map

package/resources/search/contents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contents.d.ts","sourceRoot":"","sources":["../../src/resources/search/contents.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,KAAK,SAAS,oBAAiB;AACtC,OAAO,EAAE,UAAU,EAAE,kCAA+B;AAEpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE;;GAEG;AACH,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAOxF;AAED,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC;IAE/B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE3B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yBAAiB,YAAY,CAAC;IAC5B;;OAEG;IACH,UAAiB,OAAO;QACtB;;;WAGG;QACH,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC;QAE1B,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;QAE7B;;;;;;;WAOG;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;QAEvB;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB;;;;;;;;WAQG;QACH,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;QAEzC;;;WAGG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAED,UAAiB,OAAO,CAAC;QACvB;;;WAGG;QACH,UAAiB,OAAO;YACtB;;;;;;;eAOG;YACH,UAAU,CAAC,EAAE,MAAM,CAAC;YAEpB;;;;eAIG;YACH,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;SAC1B;KACF;CACF;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAElC,SAAS,EAAE,MAAM,CAAC;IAElB,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC;IAEvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;CACpC;AAED,yBAAiB,QAAQ,CAAC;IACxB,UAAiB,OAAO;QACtB,SAAS,EAAE,MAAM,CAAC;QAElB;;;;;WAKG;QACH,MAAM,EAAE,IAAI,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,kBAAkB,GAAG,mBAAmB,GAAG,OAAO,CAAC;QAE1G;;WAEG;QACH,GAAG,EAAE,MAAM,CAAC;QAEZ;;WAEG;QACH,YAAY,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;QAErD;;;WAGG;QACH,YAAY,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;QAEnD,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC;QAEtB;;WAEG;QACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAE3B;;WAEG;QACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE3B;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;QAE7B;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB;;WAEG;QACH,MAAM,CAAC,EAAE,UAAU,GAAG,cAAc,GAAG,gBAAgB,CAAC;QAExD;;;WAGG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB;IAED,UAAiB,OAAO,CAAC;QACvB,UAAiB,KAAK;YACpB;;eAEG;YACH,IAAI,EAAE,MAAM,CAAC;YAEb;;eAEG;YACH,OAAO,EAAE,MAAM,CAAC;YAEhB,SAAS,EAAE,OAAO,CAAC;SACpB;KACF;CACF;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC;IAErC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE3B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yBAAiB,kBAAkB,CAAC;IAClC;;OAEG;IACH,UAAiB,OAAO;QACtB;;;WAGG;QACH,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC;QAE1B,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;QAE7B;;;;;;;WAOG;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;QAEvB;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB;;;;;;;;WAQG;QACH,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;QAEzC;;;WAGG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAED,UAAiB,OAAO,CAAC;QACvB;;;WAGG;QACH,UAAiB,OAAO;YACtB;;;;;;;eAOG;YACH,UAAU,CAAC,EAAE,MAAM,CAAC;YAEpB;;;;eAIG;YACH,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;SAC1B;KACF;CACF;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,YAAY,IAAI,YAAY,EACjC,KAAK,QAAQ,IAAI,QAAQ,EACzB,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}

package/resources/search/contents.js

@@ -0,0 +1,31 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Contents = void 0;
+const resource_1 = require("../../core/resource.js");
+const headers_1 = require("../../internal/headers.js");
+const path_1 = require("../../internal/utils/path.js");
+/**
+ * Search the web and retrieve content for selected results.
+ */
+class Contents extends resource_1.APIResource {
+    /**
+     * Deferred result-content retrieval is reserved but not available in this release.
+     * Requests return 404 until the retrieval implementation is shipped. X-Request-Id
+     * identifies this request separately from the search resource.
+     *
+     * @example
+     * ```ts
+     * await client.search.contents.fetch('srch_abc123');
+     * ```
+     */
+    fetch(id, body, options) {
+        return this._client.post((0, path_1.path) `/search/${id}/contents`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.Contents = Contents;
+//# sourceMappingURL=contents.js.map

package/resources/search/contents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contents.js","sourceRoot":"","sources":["../../src/resources/search/contents.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAGlD,uDAAsD;AAEtD,uDAAiD;AAEjD;;GAEG;AACH,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAU,EAAE,IAAwB,EAAE,OAAwB;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,WAAW,EAAE,WAAW,EAAE;YACrD,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AAlBD,4BAkBC"}

package/resources/search/contents.mjs

@@ -0,0 +1,27 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+import { path } from "../../internal/utils/path.mjs";
+/**
+ * Search the web and retrieve content for selected results.
+ */
+export class Contents extends APIResource {
+    /**
+     * Deferred result-content retrieval is reserved but not available in this release.
+     * Requests return 404 until the retrieval implementation is shipped. X-Request-Id
+     * identifies this request separately from the search resource.
+     *
+     * @example
+     * ```ts
+     * await client.search.contents.fetch('srch_abc123');
+     * ```
+     */
+    fetch(id, body, options) {
+        return this._client.post(path `/search/${id}/contents`, {
+            body,
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+//# sourceMappingURL=contents.mjs.map

package/resources/search/contents.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contents.mjs","sourceRoot":"","sources":["../../src/resources/search/contents.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAGlD,OAAO,EAAE,YAAY,EAAE,mCAA+B;AAEtD,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAU,EAAE,IAAwB,EAAE,OAAwB;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,WAAW,EAAE,WAAW,EAAE;YACrD,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF"}

package/resources/search/index.d.mts

@@ -0,0 +1,4 @@
+export { Contents, type FetchRequest, type Response, type ContentFetchParams } from "./contents.mjs";
+export { Providers, type Provider, type ProviderListResponse, type ProviderListParams } from "./providers.mjs";
+export { SearchResource, type Attempt, type ProviderTarget, type Request, type Result, type Search, type Strategy, type Usage, type Warning, type SearchCreateParams, } from "./search.mjs";
+//# sourceMappingURL=index.d.mts.map

package/resources/search/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/search/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,uBAAmB;AACjG,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,wBAAoB;AAC3G,OAAO,EACL,cAAc,EACd,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,MAAM,EACX,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,KAAK,EACV,KAAK,OAAO,EACZ,KAAK,kBAAkB,GACxB,qBAAiB"}

package/resources/search/index.d.ts

@@ -0,0 +1,4 @@
+export { Contents, type FetchRequest, type Response, type ContentFetchParams } from "./contents.js";
+export { Providers, type Provider, type ProviderListResponse, type ProviderListParams } from "./providers.js";
+export { SearchResource, type Attempt, type ProviderTarget, type Request, type Result, type Search, type Strategy, type Usage, type Warning, type SearchCreateParams, } from "./search.js";
+//# sourceMappingURL=index.d.ts.map

package/resources/search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/search/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,sBAAmB;AACjG,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,uBAAoB;AAC3G,OAAO,EACL,cAAc,EACd,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,MAAM,EACX,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,KAAK,EACV,KAAK,OAAO,EACZ,KAAK,kBAAkB,GACxB,oBAAiB"}

package/resources/search/index.js

@@ -0,0 +1,11 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchResource = exports.Providers = exports.Contents = void 0;
+var contents_1 = require("./contents.js");
+Object.defineProperty(exports, "Contents", { enumerable: true, get: function () { return contents_1.Contents; } });
+var providers_1 = require("./providers.js");
+Object.defineProperty(exports, "Providers", { enumerable: true, get: function () { return providers_1.Providers; } });
+var search_1 = require("./search.js");
+Object.defineProperty(exports, "SearchResource", { enumerable: true, get: function () { return search_1.SearchResource; } });
+//# sourceMappingURL=index.js.map

package/resources/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/search/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,0CAAiG;AAAxF,oGAAA,QAAQ,OAAA;AACjB,4CAA2G;AAAlG,sGAAA,SAAS,OAAA;AAClB,sCAWkB;AAVhB,wGAAA,cAAc,OAAA"}

package/resources/search/index.mjs

@@ -0,0 +1,5 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { Contents } from "./contents.mjs";
+export { Providers } from "./providers.mjs";
+export { SearchResource, } from "./search.mjs";
+//# sourceMappingURL=index.mjs.map

package/resources/search/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/search/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,QAAQ,EAA6D,uBAAmB;AACjG,OAAO,EAAE,SAAS,EAAqE,wBAAoB;AAC3G,OAAO,EACL,cAAc,GAUf,qBAAiB"}

package/resources/search/providers.d.mts

@@ -0,0 +1,141 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+/**
+ * Search the web and retrieve content for selected results.
+ */
+export declare class Providers extends APIResource {
+    /**
+     * Lists providers, capabilities, and machine-readable native-option schemas. Auto
+     * and fallback are strategies, not provider entries. The list is not paginated and
+     * contains no latency benchmarks. X-Request-Id identifies the request.
+     *
+     * @example
+     * ```ts
+     * const providers = await client.search.providers.list();
+     * ```
+     */
+    list(query?: ProviderListParams | null | undefined, options?: RequestOptions): APIPromise<ProviderListResponse>;
+}
+export interface Provider {
+    content: Provider.Content;
+    max_results_cap: number;
+    params: Provider.Params;
+    provider_options: Provider.ProviderOptions;
+    slug: string;
+    /**
+     * Provider-specific limitations, conditional filter support, and warnings about
+     * search modes.
+     */
+    notes?: Array<string>;
+}
+export declare namespace Provider {
+    interface Content {
+        /**
+         * Can enforce the requested maximum content age.
+         */
+        freshness_control: boolean;
+        /**
+         * Supports content retrieval with the search request.
+         */
+        inline: boolean;
+        /**
+         * Supports content retrieval after the search completes.
+         */
+        post_hoc: boolean;
+    }
+    interface Params {
+        country: Params.Country;
+        end_date: Params.EndDate;
+        exclude_domains: Params.ExcludeDomains;
+        include_domains: Params.IncludeDomains;
+        language: Params.Language;
+        recency: Params.Recency;
+        safe_search: Params.SafeSearch;
+        start_date: Params.StartDate;
+    }
+    namespace Params {
+        interface Country {
+            support: 'native' | 'emulated' | 'unsupported';
+            /**
+             * Translation behavior, limitations, and precision.
+             */
+            notes?: string;
+        }
+        interface EndDate {
+            support: 'native' | 'emulated' | 'unsupported';
+            /**
+             * Translation behavior, limitations, and precision.
+             */
+            notes?: string;
+        }
+        interface ExcludeDomains {
+            support: 'native' | 'emulated' | 'unsupported';
+            /**
+             * Translation behavior, limitations, and precision.
+             */
+            notes?: string;
+        }
+        interface IncludeDomains {
+            support: 'native' | 'emulated' | 'unsupported';
+            /**
+             * Translation behavior, limitations, and precision.
+             */
+            notes?: string;
+        }
+        interface Language {
+            support: 'native' | 'emulated' | 'unsupported';
+            /**
+             * Translation behavior, limitations, and precision.
+             */
+            notes?: string;
+        }
+        interface Recency {
+            support: 'native' | 'emulated' | 'unsupported';
+            /**
+             * Translation behavior, limitations, and precision.
+             */
+            notes?: string;
+        }
+        interface SafeSearch {
+            support: 'native' | 'emulated' | 'unsupported';
+            /**
+             * Translation behavior, limitations, and precision.
+             */
+            notes?: string;
+        }
+        interface StartDate {
+            support: 'native' | 'emulated' | 'unsupported';
+            /**
+             * Translation behavior, limitations, and precision.
+             */
+            notes?: string;
+        }
+    }
+    interface ProviderOptions {
+        /**
+         * JSON Schema for the provider-native options accepted by POST /search.
+         */
+        schema: {
+            [key: string]: unknown;
+        };
+        /**
+         * OpenAPI component name for the matching typed provider-options schema.
+         */
+        schema_ref: string;
+        examples?: Array<{
+            [key: string]: unknown;
+        }>;
+    }
+}
+export type ProviderListResponse = Array<Provider>;
+export interface ProviderListParams {
+    /**
+     * Optional concrete provider slug filter. Omit to list every provider.
+     */
+    slug?: 'brave' | 'exa' | 'perplexity' | 'context' | 'parallel' | 'valyu' | 'octen' | 'you' | 'tavily' | 'serpapi';
+}
+export declare namespace Providers {
+    export { type Provider as Provider, type ProviderListResponse as ProviderListResponse, type ProviderListParams as ProviderListParams, };
+}
+//# sourceMappingURL=providers.d.mts.map

package/resources/search/providers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.mts","sourceRoot":"","sources":["../../src/resources/search/providers.ts"],"names":[],"mappings":"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"}