telnyx 7.14.0 → 7.16.0

package/resources/web-search/research.mjs

@@ -0,0 +1,53 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { path } from "../../internal/utils/path.mjs";
+/**
+ * Deep research with citations and async task polling.
+ */
+export class Research extends APIResource {
+    /**
+     * Starts a deep research task that runs multiple searches, reads sources, and
+     * synthesizes an answer with citations.
+     *
+     * ## Synchronous mode (default)
+     *
+     * When `background` is `false` or omitted, the request blocks until the research
+     * completes and returns the answer with citations. This can take up to 120 seconds
+     * depending on `research_effort`.
+     *
+     * ## Asynchronous mode
+     *
+     * When `background` is `true`, the request returns immediately with a `task_id`
+     * and `status: pending`. Poll `GET /web_search/research/{task_id}` to check when
+     * the research completes and retrieve the answer.
+     *
+     * @example
+     * ```ts
+     * const research = await client.webSearch.research.create({
+     *   query:
+     *     'Compare the performance of RAG vs fine-tuning for domain-specific QA',
+     *   max_sources: 20,
+     *   research_effort: 'standard',
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/web_search/research', { body, ...options });
+    }
+    /**
+     * Polls the status of a previously started asynchronous research task. When the
+     * status is `completed`, the response includes the answer and citations. When the
+     * status is `failed`, the response includes an error message.
+     *
+     * @example
+     * ```ts
+     * const research = await client.webSearch.research.retrieve(
+     *   'bf3026a5-dd57-44dd-b922-200041be3a4b',
+     * );
+     * ```
+     */
+    retrieve(taskID, options) {
+        return this._client.get(path `/web_search/research/${taskID}`, options);
+    }
+}
+//# sourceMappingURL=research.mjs.map

package/resources/web-search/research.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"research.mjs","sourceRoot":"","sources":["../../src/resources/web-search/research.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAIlD,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CAAC,IAA0B,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,wBAAwB,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;CACF"}

package/resources/web-search/web-search.d.mts

@@ -0,0 +1,204 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as WebSearchAPI from "./web-search.mjs";
+import * as ResearchAPI from "./research.mjs";
+import { Research, ResearchCitation, ResearchCreateParams, ResearchCreateResponse, ResearchRetrieveResponse } from "./research.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class WebSearch extends APIResource {
+    research: ResearchAPI.Research;
+    /**
+     * Performs a real-time web search and returns structured, LLM-ready JSON results
+     * with titles, URLs, descriptions, and snippets. Supports filtering by domain,
+     * country, safe search, freshness, and live crawl.
+     *
+     * **Note:** `include_domains` and `exclude_domains` cannot be used in the same
+     * request. Use one or the other.
+     *
+     * @example
+     * ```ts
+     * const webSearch = await client.webSearch.create({
+     *   query: 'latest AI agent frameworks',
+     *   count: 10,
+     *   country: 'US',
+     *   freshness: 'week',
+     *   include_domains: ['arxiv.org', 'github.com'],
+     *   safesearch: 'moderate',
+     * });
+     * ```
+     */
+    create(body: WebSearchCreateParams, options?: RequestOptions): APIPromise<WebSearchCreateResponse>;
+    /**
+     * Retrieves clean HTML or Markdown content from a list of URLs. Supports up to 20
+     * URLs per request (public API limit). Specify which formats to return: `html`,
+     * `markdown`, `metadata`.
+     *
+     * @example
+     * ```ts
+     * const response = await client.webSearch.contents({
+     *   urls: [
+     *     'https://en.wikipedia.org/wiki/Artificial_intelligence',
+     *   ],
+     *   crawl_timeout: 10,
+     *   formats: ['markdown', 'metadata'],
+     * });
+     * ```
+     */
+    contents(body: WebSearchContentsParams, options?: RequestOptions): APIPromise<WebSearchContentsResponse>;
+}
+export interface WebSearchResult {
+    /**
+     * Short description or excerpt.
+     */
+    description: string;
+    /**
+     * Relevant text snippets from the page.
+     */
+    snippets: Array<string>;
+    /**
+     * Result title.
+     */
+    title: string;
+    /**
+     * Result URL.
+     */
+    url: string;
+    /**
+     * Favicon URL (if available).
+     */
+    favicon_url?: string;
+    /**
+     * Thumbnail image URL (if available).
+     */
+    thumbnail_url?: string;
+}
+export interface WebSearchCreateResponse {
+    data?: WebSearchCreateResponse.Data;
+}
+export declare namespace WebSearchCreateResponse {
+    interface Data {
+        results?: Data.Results;
+    }
+    namespace Data {
+        interface Results {
+            /**
+             * Web search results.
+             */
+            web: Array<WebSearchAPI.WebSearchResult>;
+            /**
+             * News search results. Present only when the query surfaces news results.
+             */
+            news?: Array<WebSearchAPI.WebSearchResult>;
+        }
+    }
+}
+export interface WebSearchContentsResponse {
+    data?: WebSearchContentsResponse.Data;
+}
+export declare namespace WebSearchContentsResponse {
+    interface Data {
+        results?: Array<Data.Result>;
+    }
+    namespace Data {
+        interface Result {
+            /**
+             * The source URL.
+             */
+            url: string;
+            /**
+             * Cleaned HTML content (if `html` format requested; may also be present on freshly
+             * crawled pages).
+             */
+            html?: string;
+            /**
+             * Markdown content (if `markdown` format requested).
+             */
+            markdown?: string;
+            /**
+             * Page metadata (if `metadata` format requested).
+             */
+            metadata?: Result.Metadata;
+            /**
+             * Page title (if available).
+             */
+            title?: string;
+        }
+        namespace Result {
+            /**
+             * Page metadata (if `metadata` format requested).
+             */
+            interface Metadata {
+                /**
+                 * Favicon URL (if available).
+                 */
+                favicon_url?: string;
+                /**
+                 * Site name. Often empty.
+                 */
+                site_name?: string;
+                [k: string]: unknown;
+            }
+        }
+    }
+}
+export interface WebSearchCreateParams {
+    /**
+     * The search query text.
+     */
+    query: string;
+    /**
+     * Number of results to return (1-100).
+     */
+    count?: number;
+    /**
+     * Two-letter country code (ISO 3166-1 alpha-2) to bias results.
+     */
+    country?: string;
+    /**
+     * Exclude results from these domains (bare hostnames, e.g. `pinterest.com`).
+     */
+    exclude_domains?: Array<string>;
+    /**
+     * Time-based filter for results. Common values: `day`, `week`, `month`, `year`.
+     */
+    freshness?: string;
+    /**
+     * Restrict results to these domains (bare hostnames, e.g. `arxiv.org`).
+     */
+    include_domains?: Array<string>;
+    /**
+     * When true, the provider crawls pages in real-time for fresh content. The boolean
+     * is translated to the provider's internal enum internally; callers always pass
+     * `true` or `false`.
+     */
+    livecrawl?: boolean;
+    /**
+     * Safe search filter level.
+     */
+    safesearch?: 'off' | 'moderate' | 'strict';
+}
+export interface WebSearchContentsParams {
+    /**
+     * List of URLs to retrieve content from (max 20 for public API).
+     */
+    urls: Array<string>;
+    /**
+     * Timeout for crawling each URL, in seconds (1-60).
+     */
+    crawl_timeout?: number;
+    /**
+     * Content formats to return. If omitted, `html` and `metadata` are returned by
+     * default. Retrieval is best-effort per URL: a format field appears only when that
+     * content could be produced, and a freshly crawled page may also include `html`
+     * even when not requested.
+     */
+    formats?: Array<'html' | 'markdown' | 'metadata'>;
+    /**
+     * Maximum age of cached content in seconds. `null` means no limit.
+     */
+    max_age?: number | null;
+}
+export declare namespace WebSearch {
+    export { type WebSearchResult as WebSearchResult, type WebSearchCreateResponse as WebSearchCreateResponse, type WebSearchContentsResponse as WebSearchContentsResponse, type WebSearchCreateParams as WebSearchCreateParams, type WebSearchContentsParams as WebSearchContentsParams, };
+    export { Research as Research, type ResearchCitation as ResearchCitation, type ResearchCreateResponse as ResearchCreateResponse, type ResearchRetrieveResponse as ResearchRetrieveResponse, type ResearchCreateParams as ResearchCreateParams, };
+}
+//# sourceMappingURL=web-search.d.mts.map

package/resources/web-search/web-search.d.mts.map

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

package/resources/web-search/web-search.d.ts

@@ -0,0 +1,204 @@
+import { APIResource } from "../../core/resource.js";
+import * as WebSearchAPI from "./web-search.js";
+import * as ResearchAPI from "./research.js";
+import { Research, ResearchCitation, ResearchCreateParams, ResearchCreateResponse, ResearchRetrieveResponse } from "./research.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class WebSearch extends APIResource {
+    research: ResearchAPI.Research;
+    /**
+     * Performs a real-time web search and returns structured, LLM-ready JSON results
+     * with titles, URLs, descriptions, and snippets. Supports filtering by domain,
+     * country, safe search, freshness, and live crawl.
+     *
+     * **Note:** `include_domains` and `exclude_domains` cannot be used in the same
+     * request. Use one or the other.
+     *
+     * @example
+     * ```ts
+     * const webSearch = await client.webSearch.create({
+     *   query: 'latest AI agent frameworks',
+     *   count: 10,
+     *   country: 'US',
+     *   freshness: 'week',
+     *   include_domains: ['arxiv.org', 'github.com'],
+     *   safesearch: 'moderate',
+     * });
+     * ```
+     */
+    create(body: WebSearchCreateParams, options?: RequestOptions): APIPromise<WebSearchCreateResponse>;
+    /**
+     * Retrieves clean HTML or Markdown content from a list of URLs. Supports up to 20
+     * URLs per request (public API limit). Specify which formats to return: `html`,
+     * `markdown`, `metadata`.
+     *
+     * @example
+     * ```ts
+     * const response = await client.webSearch.contents({
+     *   urls: [
+     *     'https://en.wikipedia.org/wiki/Artificial_intelligence',
+     *   ],
+     *   crawl_timeout: 10,
+     *   formats: ['markdown', 'metadata'],
+     * });
+     * ```
+     */
+    contents(body: WebSearchContentsParams, options?: RequestOptions): APIPromise<WebSearchContentsResponse>;
+}
+export interface WebSearchResult {
+    /**
+     * Short description or excerpt.
+     */
+    description: string;
+    /**
+     * Relevant text snippets from the page.
+     */
+    snippets: Array<string>;
+    /**
+     * Result title.
+     */
+    title: string;
+    /**
+     * Result URL.
+     */
+    url: string;
+    /**
+     * Favicon URL (if available).
+     */
+    favicon_url?: string;
+    /**
+     * Thumbnail image URL (if available).
+     */
+    thumbnail_url?: string;
+}
+export interface WebSearchCreateResponse {
+    data?: WebSearchCreateResponse.Data;
+}
+export declare namespace WebSearchCreateResponse {
+    interface Data {
+        results?: Data.Results;
+    }
+    namespace Data {
+        interface Results {
+            /**
+             * Web search results.
+             */
+            web: Array<WebSearchAPI.WebSearchResult>;
+            /**
+             * News search results. Present only when the query surfaces news results.
+             */
+            news?: Array<WebSearchAPI.WebSearchResult>;
+        }
+    }
+}
+export interface WebSearchContentsResponse {
+    data?: WebSearchContentsResponse.Data;
+}
+export declare namespace WebSearchContentsResponse {
+    interface Data {
+        results?: Array<Data.Result>;
+    }
+    namespace Data {
+        interface Result {
+            /**
+             * The source URL.
+             */
+            url: string;
+            /**
+             * Cleaned HTML content (if `html` format requested; may also be present on freshly
+             * crawled pages).
+             */
+            html?: string;
+            /**
+             * Markdown content (if `markdown` format requested).
+             */
+            markdown?: string;
+            /**
+             * Page metadata (if `metadata` format requested).
+             */
+            metadata?: Result.Metadata;
+            /**
+             * Page title (if available).
+             */
+            title?: string;
+        }
+        namespace Result {
+            /**
+             * Page metadata (if `metadata` format requested).
+             */
+            interface Metadata {
+                /**
+                 * Favicon URL (if available).
+                 */
+                favicon_url?: string;
+                /**
+                 * Site name. Often empty.
+                 */
+                site_name?: string;
+                [k: string]: unknown;
+            }
+        }
+    }
+}
+export interface WebSearchCreateParams {
+    /**
+     * The search query text.
+     */
+    query: string;
+    /**
+     * Number of results to return (1-100).
+     */
+    count?: number;
+    /**
+     * Two-letter country code (ISO 3166-1 alpha-2) to bias results.
+     */
+    country?: string;
+    /**
+     * Exclude results from these domains (bare hostnames, e.g. `pinterest.com`).
+     */
+    exclude_domains?: Array<string>;
+    /**
+     * Time-based filter for results. Common values: `day`, `week`, `month`, `year`.
+     */
+    freshness?: string;
+    /**
+     * Restrict results to these domains (bare hostnames, e.g. `arxiv.org`).
+     */
+    include_domains?: Array<string>;
+    /**
+     * When true, the provider crawls pages in real-time for fresh content. The boolean
+     * is translated to the provider's internal enum internally; callers always pass
+     * `true` or `false`.
+     */
+    livecrawl?: boolean;
+    /**
+     * Safe search filter level.
+     */
+    safesearch?: 'off' | 'moderate' | 'strict';
+}
+export interface WebSearchContentsParams {
+    /**
+     * List of URLs to retrieve content from (max 20 for public API).
+     */
+    urls: Array<string>;
+    /**
+     * Timeout for crawling each URL, in seconds (1-60).
+     */
+    crawl_timeout?: number;
+    /**
+     * Content formats to return. If omitted, `html` and `metadata` are returned by
+     * default. Retrieval is best-effort per URL: a format field appears only when that
+     * content could be produced, and a freshly crawled page may also include `html`
+     * even when not requested.
+     */
+    formats?: Array<'html' | 'markdown' | 'metadata'>;
+    /**
+     * Maximum age of cached content in seconds. `null` means no limit.
+     */
+    max_age?: number | null;
+}
+export declare namespace WebSearch {
+    export { type WebSearchResult as WebSearchResult, type WebSearchCreateResponse as WebSearchCreateResponse, type WebSearchContentsResponse as WebSearchContentsResponse, type WebSearchCreateParams as WebSearchCreateParams, type WebSearchContentsParams as WebSearchContentsParams, };
+    export { Research as Research, type ResearchCitation as ResearchCitation, type ResearchCreateResponse as ResearchCreateResponse, type ResearchRetrieveResponse as ResearchRetrieveResponse, type ResearchCreateParams as ResearchCreateParams, };
+}
+//# sourceMappingURL=web-search.d.ts.map

package/resources/web-search/web-search.d.ts.map

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

package/resources/web-search/web-search.js

@@ -0,0 +1,59 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSearch = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const ResearchAPI = tslib_1.__importStar(require("./research.js"));
+const research_1 = require("./research.js");
+class WebSearch extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.research = new ResearchAPI.Research(this._client);
+    }
+    /**
+     * Performs a real-time web search and returns structured, LLM-ready JSON results
+     * with titles, URLs, descriptions, and snippets. Supports filtering by domain,
+     * country, safe search, freshness, and live crawl.
+     *
+     * **Note:** `include_domains` and `exclude_domains` cannot be used in the same
+     * request. Use one or the other.
+     *
+     * @example
+     * ```ts
+     * const webSearch = await client.webSearch.create({
+     *   query: 'latest AI agent frameworks',
+     *   count: 10,
+     *   country: 'US',
+     *   freshness: 'week',
+     *   include_domains: ['arxiv.org', 'github.com'],
+     *   safesearch: 'moderate',
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/web_search', { body, ...options });
+    }
+    /**
+     * Retrieves clean HTML or Markdown content from a list of URLs. Supports up to 20
+     * URLs per request (public API limit). Specify which formats to return: `html`,
+     * `markdown`, `metadata`.
+     *
+     * @example
+     * ```ts
+     * const response = await client.webSearch.contents({
+     *   urls: [
+     *     'https://en.wikipedia.org/wiki/Artificial_intelligence',
+     *   ],
+     *   crawl_timeout: 10,
+     *   formats: ['markdown', 'metadata'],
+     * });
+     * ```
+     */
+    contents(body, options) {
+        return this._client.post('/web_search/contents', { body, ...options });
+    }
+}
+exports.WebSearch = WebSearch;
+WebSearch.Research = research_1.Research;
+//# sourceMappingURL=web-search.js.map

package/resources/web-search/web-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.js","sourceRoot":"","sources":["../../src/resources/web-search/web-search.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAElD,mEAA0C;AAC1C,4CAMoB;AAIpB,MAAa,SAAU,SAAQ,sBAAW;IAA1C;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA6C1E,CAAC;IA3CC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,IAA2B,EAAE,OAAwB;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,IAA6B,EAAE,OAAwB;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;CACF;AA9CD,8BA8CC;AA0LD,SAAS,CAAC,QAAQ,GAAG,mBAAQ,CAAC"}

package/resources/web-search/web-search.mjs

@@ -0,0 +1,54 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import * as ResearchAPI from "./research.mjs";
+import { Research, } from "./research.mjs";
+export class WebSearch extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.research = new ResearchAPI.Research(this._client);
+    }
+    /**
+     * Performs a real-time web search and returns structured, LLM-ready JSON results
+     * with titles, URLs, descriptions, and snippets. Supports filtering by domain,
+     * country, safe search, freshness, and live crawl.
+     *
+     * **Note:** `include_domains` and `exclude_domains` cannot be used in the same
+     * request. Use one or the other.
+     *
+     * @example
+     * ```ts
+     * const webSearch = await client.webSearch.create({
+     *   query: 'latest AI agent frameworks',
+     *   count: 10,
+     *   country: 'US',
+     *   freshness: 'week',
+     *   include_domains: ['arxiv.org', 'github.com'],
+     *   safesearch: 'moderate',
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/web_search', { body, ...options });
+    }
+    /**
+     * Retrieves clean HTML or Markdown content from a list of URLs. Supports up to 20
+     * URLs per request (public API limit). Specify which formats to return: `html`,
+     * `markdown`, `metadata`.
+     *
+     * @example
+     * ```ts
+     * const response = await client.webSearch.contents({
+     *   urls: [
+     *     'https://en.wikipedia.org/wiki/Artificial_intelligence',
+     *   ],
+     *   crawl_timeout: 10,
+     *   formats: ['markdown', 'metadata'],
+     * });
+     * ```
+     */
+    contents(body, options) {
+        return this._client.post('/web_search/contents', { body, ...options });
+    }
+}
+WebSearch.Research = Research;
+//# sourceMappingURL=web-search.mjs.map

package/resources/web-search/web-search.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.mjs","sourceRoot":"","sources":["../../src/resources/web-search/web-search.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAElD,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EACL,QAAQ,GAKT,uBAAmB;AAIpB,MAAM,OAAO,SAAU,SAAQ,WAAW;IAA1C;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA6C1E,CAAC;IA3CC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,IAA2B,EAAE,OAAwB;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,IAA6B,EAAE,OAAwB;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;CACF;AA0LD,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC"}

package/resources/web-search.d.mts

@@ -0,0 +1,2 @@
+export * from "./web-search/index.mjs";
+//# sourceMappingURL=web-search.d.mts.map

package/resources/web-search.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.mts","sourceRoot":"","sources":["../src/resources/web-search.ts"],"names":[],"mappings":"AAEA,uCAAmC"}

package/resources/web-search.d.ts

@@ -0,0 +1,2 @@
+export * from "./web-search/index.js";
+//# sourceMappingURL=web-search.d.ts.map

package/resources/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../src/resources/web-search.ts"],"names":[],"mappings":"AAEA,sCAAmC"}

package/resources/web-search.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../internal/tslib.js");
+tslib_1.__exportStar(require("./web-search/index.js"), exports);
+//# sourceMappingURL=web-search.js.map

package/resources/web-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.js","sourceRoot":"","sources":["../src/resources/web-search.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,gEAAmC"}

package/resources/web-search.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./web-search/index.mjs";
+//# sourceMappingURL=web-search.mjs.map

package/resources/web-search.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.mjs","sourceRoot":"","sources":["../src/resources/web-search.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,uCAAmC"}