@melara/sdk 0.0.0-stage → 0.1.0

package/esm/models/websearchconfig.d.ts

@@ -0,0 +1,70 @@
+import * as z from "zod/v4";
+import { SearchQualityLevel } from "./searchqualitylevel.js";
+import { WebSearchEngineEnum } from "./websearchengineenum.js";
+import { WebSearchMode } from "./websearchmode.js";
+import { WebSearchUserLocationServerTool, WebSearchUserLocationServerTool$Outbound } from "./websearchuserlocationservertool.js";
+import { XSearchOptions, XSearchOptions$Outbound } from "./xsearchoptions.js";
+export type WebSearchConfig = {
+    /**
+     * Limit search results to these domains. Supported by Exa, Firecrawl, Parallel, Perplexity, and most native providers (Anthropic, OpenAI, SpaceXAI). Cannot be used with excluded_domains.
+     */
+    allowedDomains?: Array<string> | undefined;
+    /**
+     * Which search engine to use. "auto" (default) uses native if the provider supports it, otherwise Exa. "native" forces the provider's built-in search. "exa" forces the Exa search API. "firecrawl" uses Firecrawl (requires BYOK). "parallel" uses the Parallel search API. "perplexity" uses the Perplexity Search API (raw ranked results).
+     */
+    engine?: WebSearchEngineEnum | undefined;
+    /**
+     * Exclude search results from these domains. Supported by Exa, Firecrawl, Parallel, Perplexity, Anthropic, OpenAI, and SpaceXAI. Cannot be used with allowed_domains.
+     */
+    excludedDomains?: Array<string> | undefined;
+    /**
+     * Exact maximum number of characters of content per search result. Applies to the Exa, Parallel, and Perplexity engines; ignored with native provider search and Firecrawl. For Exa, caps highlight content per result. For Parallel, caps excerpt content per result (default 1,500 when omitted). For Perplexity, maps to the native `max_tokens_per_page` parameter (converted from characters to tokens) and trims the response to the exact character cap. When both `max_characters` and `search_context_size` are set, `max_characters` takes precedence. When omitted, falls back to `search_context_size` mapping (Exa) or engine defaults (Parallel, Perplexity).
+     */
+    maxCharacters?: number | undefined;
+    /**
+     * Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, Parallel, and Perplexity engines; ignored with native provider search. Perplexity supports a maximum of 20; values above 20 are clamped.
+     */
+    maxResults?: number | undefined;
+    /**
+     * Maximum total number of search results across all search calls in a single request. Once this limit is reached, the tool will stop returning new results. Useful for controlling cost and context size in agentic loops. Defaults to 50 when not specified.
+     */
+    maxTotalResults?: number | undefined;
+    /**
+     * Maximum number of web searches the model may perform in a single request. Once reached, further search calls return an error result instead of executing. Applies to the Exa, Firecrawl, Parallel, and Perplexity engines. With native provider search, forwarded only to Anthropic (as `max_uses`); other native search providers have no equivalent parameter and ignore it.
+     */
+    maxUses?: number | undefined;
+    /**
+     * Engine-native search mode. Exa supports instant, fast, auto (default), deep-lite, deep, and deep-reasoning. Parallel supports turbo, fast, basic (default), and advanced. Modes unsupported by the selected engine are ignored.
+     */
+    mode?: WebSearchMode | undefined;
+    /**
+     * How much context to retrieve per result. Applies to Exa, Parallel, and Perplexity engines; ignored with native provider search and Firecrawl. For Exa, pins a fixed per-result character cap (low=5,000, medium=15,000, high=30,000); when omitted, Exa picks an adaptive size per query and document (typically ~2,000–4,000 characters per result). For Parallel, controls the total characters across all results; when omitted, Parallel uses its own default size. For Perplexity, maps directly to the Search API's native search_context_size parameter. Overridden by `max_characters` when both are set.
+     */
+    searchContextSize?: SearchQualityLevel | undefined;
+    /**
+     * Approximate user location for location-biased results.
+     */
+    userLocation?: WebSearchUserLocationServerTool | undefined;
+    /**
+     * Enable SpaceXAI X (Twitter) search alongside native web search, with optional filters. Only applies to SpaceXAI endpoints with native search; omit to search the web only. X search is billed separately by SpaceXAI, per post and per user profile fetched.
+     */
+    xSearch?: XSearchOptions | undefined;
+};
+/** @internal */
+export type WebSearchConfig$Outbound = {
+    allowed_domains?: Array<string> | undefined;
+    engine?: string | undefined;
+    excluded_domains?: Array<string> | undefined;
+    max_characters?: number | undefined;
+    max_results?: number | undefined;
+    max_total_results?: number | undefined;
+    max_uses?: number | undefined;
+    mode?: string | undefined;
+    search_context_size?: string | undefined;
+    user_location?: WebSearchUserLocationServerTool$Outbound | undefined;
+    x_search?: XSearchOptions$Outbound | undefined;
+};
+/** @internal */
+export declare const WebSearchConfig$outboundSchema: z.ZodType<WebSearchConfig$Outbound, WebSearchConfig>;
+export declare function webSearchConfigToJSON(webSearchConfig: WebSearchConfig): string;
+//# sourceMappingURL=websearchconfig.d.ts.map

package/esm/models/websearchconfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websearchconfig.d.ts","sourceRoot":"","sources":["../../src/models/websearchconfig.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EACL,kBAAkB,EAEnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,EAEpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,aAAa,EAEd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,+BAA+B,EAC/B,wCAAwC,EAEzC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,cAAc,EACd,uBAAuB,EAExB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,eAAe,GAAG;IAC5B;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAC3C;;OAEG;IACH,MAAM,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACzC;;OAEG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAC5C;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B;;OAEG;IACH,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC;;OAEG;IACH,iBAAiB,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACnD;;OAEG;IACH,YAAY,CAAC,EAAE,+BAA+B,GAAG,SAAS,CAAC;IAC3D;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;CACtC,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,wBAAwB,GAAG;IACrC,eAAe,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,gBAAgB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAC7C,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,aAAa,CAAC,EAAE,wCAAwC,GAAG,SAAS,CAAC;IACrE,QAAQ,CAAC,EAAE,uBAAuB,GAAG,SAAS,CAAC;CAChD,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,8BAA8B,EAAE,CAAC,CAAC,OAAO,CACpD,wBAAwB,EACxB,eAAe,CAyBf,CAAC;AAEH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,eAAe,GAC/B,MAAM,CAER"}

package/esm/models/websearchconfig.js

@@ -0,0 +1,41 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: d43f37b9a707
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import { SearchQualityLevel$outboundSchema, } from "./searchqualitylevel.js";
+import { WebSearchEngineEnum$outboundSchema, } from "./websearchengineenum.js";
+import { WebSearchMode$outboundSchema, } from "./websearchmode.js";
+import { WebSearchUserLocationServerTool$outboundSchema, } from "./websearchuserlocationservertool.js";
+import { XSearchOptions$outboundSchema, } from "./xsearchoptions.js";
+/** @internal */
+export const WebSearchConfig$outboundSchema = z.object({
+    allowedDomains: z.array(z.string()).optional(),
+    engine: WebSearchEngineEnum$outboundSchema.optional(),
+    excludedDomains: z.array(z.string()).optional(),
+    maxCharacters: z.int().optional(),
+    maxResults: z.int().optional(),
+    maxTotalResults: z.int().optional(),
+    maxUses: z.int().optional(),
+    mode: WebSearchMode$outboundSchema.optional(),
+    searchContextSize: SearchQualityLevel$outboundSchema.optional(),
+    userLocation: WebSearchUserLocationServerTool$outboundSchema.optional(),
+    xSearch: XSearchOptions$outboundSchema.optional(),
+}).transform((v) => {
+    return remap$(v, {
+        allowedDomains: "allowed_domains",
+        excludedDomains: "excluded_domains",
+        maxCharacters: "max_characters",
+        maxResults: "max_results",
+        maxTotalResults: "max_total_results",
+        maxUses: "max_uses",
+        searchContextSize: "search_context_size",
+        userLocation: "user_location",
+        xSearch: "x_search",
+    });
+});
+export function webSearchConfigToJSON(webSearchConfig) {
+    return JSON.stringify(WebSearchConfig$outboundSchema.parse(webSearchConfig));
+}
+//# sourceMappingURL=websearchconfig.js.map

package/esm/models/websearchconfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websearchconfig.js","sourceRoot":"","sources":["../../src/models/websearchconfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAEL,iCAAiC,GAClC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,kCAAkC,GACnC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,8CAA8C,GAC/C,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAGL,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAgE7B,gBAAgB;AAChB,MAAM,CAAC,MAAM,8BAA8B,GAGvC,CAAC,CAAC,MAAM,CAAC;IACX,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9C,MAAM,EAAE,kCAAkC,CAAC,QAAQ,EAAE;IACrD,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC/C,aAAa,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACjC,UAAU,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC9B,eAAe,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACnC,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC3B,IAAI,EAAE,4BAA4B,CAAC,QAAQ,EAAE;IAC7C,iBAAiB,EAAE,iCAAiC,CAAC,QAAQ,EAAE;IAC/D,YAAY,EAAE,8CAA8C,CAAC,QAAQ,EAAE;IACvE,OAAO,EAAE,6BAA6B,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,OAAO,MAAM,CAAC,CAAC,EAAE;QACf,cAAc,EAAE,iBAAiB;QACjC,eAAe,EAAE,kBAAkB;QACnC,aAAa,EAAE,gBAAgB;QAC/B,UAAU,EAAE,aAAa;QACzB,eAAe,EAAE,mBAAmB;QACpC,OAAO,EAAE,UAAU;QACnB,iBAAiB,EAAE,qBAAqB;QACxC,YAAY,EAAE,eAAe;QAC7B,OAAO,EAAE,UAAU;KACpB,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CACnC,eAAgC;IAEhC,OAAO,IAAI,CAAC,SAAS,CAAC,8BAA8B,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;AAC/E,CAAC"}

package/esm/models/websearchdomainfilter.d.ts

@@ -0,0 +1,21 @@
+import * as z from "zod/v4";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+export type WebSearchDomainFilter = {
+    allowedDomains?: Array<string> | null | undefined;
+    blockedDomains?: Array<string> | null | undefined;
+    excludedDomains?: Array<string> | null | undefined;
+};
+/** @internal */
+export declare const WebSearchDomainFilter$inboundSchema: z.ZodType<WebSearchDomainFilter, unknown>;
+/** @internal */
+export type WebSearchDomainFilter$Outbound = {
+    allowed_domains?: Array<string> | null | undefined;
+    blocked_domains?: Array<string> | null | undefined;
+    excluded_domains?: Array<string> | null | undefined;
+};
+/** @internal */
+export declare const WebSearchDomainFilter$outboundSchema: z.ZodType<WebSearchDomainFilter$Outbound, WebSearchDomainFilter>;
+export declare function webSearchDomainFilterToJSON(webSearchDomainFilter: WebSearchDomainFilter): string;
+export declare function webSearchDomainFilterFromJSON(jsonString: string): SafeParseResult<WebSearchDomainFilter, SDKValidationError>;
+//# sourceMappingURL=websearchdomainfilter.d.ts.map

package/esm/models/websearchdomainfilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websearchdomainfilter.d.ts","sourceRoot":"","sources":["../../src/models/websearchdomainfilter.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,MAAM,MAAM,qBAAqB,GAAG;IAClC,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAClD,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAClD,eAAe,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CACpD,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,mCAAmC,EAAE,CAAC,CAAC,OAAO,CACzD,qBAAqB,EACrB,OAAO,CAWP,CAAC;AACH,gBAAgB;AAChB,MAAM,MAAM,8BAA8B,GAAG;IAC3C,eAAe,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACnD,eAAe,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACnD,gBAAgB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CACrD,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,oCAAoC,EAAE,CAAC,CAAC,OAAO,CAC1D,8BAA8B,EAC9B,qBAAqB,CAWrB,CAAC;AAEH,wBAAgB,2BAA2B,CACzC,qBAAqB,EAAE,qBAAqB,GAC3C,MAAM,CAIR;AACD,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,qBAAqB,EAAE,kBAAkB,CAAC,CAM5D"}

package/esm/models/websearchdomainfilter.js

@@ -0,0 +1,40 @@
+// Modified by Melara for the Melara SDK fork.
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 827204408f55
+ */
+import { en } from "../locales/en.js";
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+/** @internal */
+export const WebSearchDomainFilter$inboundSchema = z.object({
+    allowed_domains: z.nullable(z.array(z.string())).optional(),
+    blocked_domains: z.nullable(z.array(z.string())).optional(),
+    excluded_domains: z.nullable(z.array(z.string())).optional(),
+}).transform((v) => {
+    return remap$(v, {
+        "allowed_domains": "allowedDomains",
+        "blocked_domains": "blockedDomains",
+        "excluded_domains": "excludedDomains",
+    });
+});
+/** @internal */
+export const WebSearchDomainFilter$outboundSchema = z.object({
+    allowedDomains: z.nullable(z.array(z.string())).optional(),
+    blockedDomains: z.nullable(z.array(z.string())).optional(),
+    excludedDomains: z.nullable(z.array(z.string())).optional(),
+}).transform((v) => {
+    return remap$(v, {
+        allowedDomains: "allowed_domains",
+        blockedDomains: "blocked_domains",
+        excludedDomains: "excluded_domains",
+    });
+});
+export function webSearchDomainFilterToJSON(webSearchDomainFilter) {
+    return JSON.stringify(WebSearchDomainFilter$outboundSchema.parse(webSearchDomainFilter));
+}
+export function webSearchDomainFilterFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => WebSearchDomainFilter$inboundSchema.parse(JSON.parse(x)), en.parseModel("WebSearchDomainFilter"));
+}
+//# sourceMappingURL=websearchdomainfilter.js.map

package/esm/models/websearchdomainfilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websearchdomainfilter.js","sourceRoot":"","sources":["../../src/models/websearchdomainfilter.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C;;;GAGG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAU9C,gBAAgB;AAChB,MAAM,CAAC,MAAM,mCAAmC,GAG5C,CAAC,CAAC,MAAM,CAAC;IACX,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3D,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3D,gBAAgB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC7D,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,OAAO,MAAM,CAAC,CAAC,EAAE;QACf,iBAAiB,EAAE,gBAAgB;QACnC,iBAAiB,EAAE,gBAAgB;QACnC,kBAAkB,EAAE,iBAAiB;KACtC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAQH,gBAAgB;AAChB,MAAM,CAAC,MAAM,oCAAoC,GAG7C,CAAC,CAAC,MAAM,CAAC;IACX,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1D,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1D,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC5D,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,OAAO,MAAM,CAAC,CAAC,EAAE;QACf,cAAc,EAAE,iBAAiB;QACjC,cAAc,EAAE,iBAAiB;QACjC,eAAe,EAAE,kBAAkB;KACpC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,MAAM,UAAU,2BAA2B,CACzC,qBAA4C;IAE5C,OAAO,IAAI,CAAC,SAAS,CACnB,oCAAoC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAClE,CAAC;AACJ,CAAC;AACD,MAAM,UAAU,6BAA6B,CAC3C,UAAkB;IAElB,OAAO,SAAS,CACd,UAAU,EACV,CAAC,CAAC,EAAE,EAAE,CAAC,mCAAmC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAC/D,EAAE,CAAC,UAAU,CAAC,uBAAuB,CAAC,CACvC,CAAC;AACJ,CAAC"}

package/esm/models/websearchengine.d.ts

@@ -0,0 +1,19 @@
+import * as z from "zod/v4";
+import { OpenEnum } from "../types/enums.js";
+/**
+ * The search engine to use for web search.
+ */
+export declare const WebSearchEngine: {
+    readonly Native: "native";
+    readonly Exa: "exa";
+    readonly Firecrawl: "firecrawl";
+    readonly Parallel: "parallel";
+    readonly Perplexity: "perplexity";
+};
+/**
+ * The search engine to use for web search.
+ */
+export type WebSearchEngine = OpenEnum<typeof WebSearchEngine>;
+/** @internal */
+export declare const WebSearchEngine$outboundSchema: z.ZodType<string, WebSearchEngine>;
+//# sourceMappingURL=websearchengine.d.ts.map

package/esm/models/websearchengine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websearchengine.d.ts","sourceRoot":"","sources":["../../src/models/websearchengine.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AACX;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,OAAO,eAAe,CAAC,CAAC;AAE/D,gBAAgB;AAChB,eAAO,MAAM,8BAA8B,EAAE,CAAC,CAAC,OAAO,CACpD,MAAM,EACN,eAAe,CAC4B,CAAC"}

package/esm/models/websearchengine.js

@@ -0,0 +1,18 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 49b0152fd59a
+ */
+import * as openEnums from "../types/enums.js";
+/**
+ * The search engine to use for web search.
+ */
+export const WebSearchEngine = {
+    Native: "native",
+    Exa: "exa",
+    Firecrawl: "firecrawl",
+    Parallel: "parallel",
+    Perplexity: "perplexity",
+};
+/** @internal */
+export const WebSearchEngine$outboundSchema = openEnums.outboundSchema(WebSearchEngine);
+//# sourceMappingURL=websearchengine.js.map

package/esm/models/websearchengine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websearchengine.js","sourceRoot":"","sources":["../../src/models/websearchengine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAG/C;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,KAAK;IACV,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,YAAY;CAChB,CAAC;AAMX,gBAAgB;AAChB,MAAM,CAAC,MAAM,8BAA8B,GAGvC,SAAS,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC"}

package/esm/models/websearchengineenum.d.ts

@@ -0,0 +1,22 @@
+import * as z from "zod/v4";
+import { OpenEnum } from "../types/enums.js";
+/**
+ * Which search engine to use. "auto" (default) uses native if the provider supports it, otherwise Exa. "native" forces the provider's built-in search. "exa" forces the Exa search API. "firecrawl" uses Firecrawl (requires BYOK). "parallel" uses the Parallel search API. "perplexity" uses the Perplexity Search API (raw ranked results).
+ */
+export declare const WebSearchEngineEnum: {
+    readonly Native: "native";
+    readonly Exa: "exa";
+    readonly Parallel: "parallel";
+    readonly Firecrawl: "firecrawl";
+    readonly Perplexity: "perplexity";
+    readonly Auto: "auto";
+};
+/**
+ * Which search engine to use. "auto" (default) uses native if the provider supports it, otherwise Exa. "native" forces the provider's built-in search. "exa" forces the Exa search API. "firecrawl" uses Firecrawl (requires BYOK). "parallel" uses the Parallel search API. "perplexity" uses the Perplexity Search API (raw ranked results).
+ */
+export type WebSearchEngineEnum = OpenEnum<typeof WebSearchEngineEnum>;
+/** @internal */
+export declare const WebSearchEngineEnum$inboundSchema: z.ZodType<WebSearchEngineEnum, unknown>;
+/** @internal */
+export declare const WebSearchEngineEnum$outboundSchema: z.ZodType<string, WebSearchEngineEnum>;
+//# sourceMappingURL=websearchengineenum.d.ts.map

package/esm/models/websearchengineenum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websearchengineenum.d.ts","sourceRoot":"","sources":["../../src/models/websearchengineenum.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;CAOtB,CAAC;AACX;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEvE,gBAAgB;AAChB,eAAO,MAAM,iCAAiC,EAAE,CAAC,CAAC,OAAO,CACvD,mBAAmB,EACnB,OAAO,CACuC,CAAC;AACjD,gBAAgB;AAChB,eAAO,MAAM,kCAAkC,EAAE,CAAC,CAAC,OAAO,CACxD,MAAM,EACN,mBAAmB,CAC4B,CAAC"}

package/esm/models/websearchengineenum.js

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 273c8df02654
+ */
+import * as openEnums from "../types/enums.js";
+/**
+ * Which search engine to use. "auto" (default) uses native if the provider supports it, otherwise Exa. "native" forces the provider's built-in search. "exa" forces the Exa search API. "firecrawl" uses Firecrawl (requires BYOK). "parallel" uses the Parallel search API. "perplexity" uses the Perplexity Search API (raw ranked results).
+ */
+export const WebSearchEngineEnum = {
+    Native: "native",
+    Exa: "exa",
+    Parallel: "parallel",
+    Firecrawl: "firecrawl",
+    Perplexity: "perplexity",
+    Auto: "auto",
+};
+/** @internal */
+export const WebSearchEngineEnum$inboundSchema = openEnums.inboundSchema(WebSearchEngineEnum);
+/** @internal */
+export const WebSearchEngineEnum$outboundSchema = openEnums.outboundSchema(WebSearchEngineEnum);
+//# sourceMappingURL=websearchengineenum.js.map

package/esm/models/websearchengineenum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websearchengineenum.js","sourceRoot":"","sources":["../../src/models/websearchengineenum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAG/C;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,KAAK;IACV,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,IAAI,EAAE,MAAM;CACJ,CAAC;AAMX,gBAAgB;AAChB,MAAM,CAAC,MAAM,iCAAiC,GAG1C,SAAS,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC;AACjD,gBAAgB;AAChB,MAAM,CAAC,MAAM,kCAAkC,GAG3C,SAAS,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC"}

package/esm/models/websearchmode.d.ts

@@ -0,0 +1,25 @@
+import * as z from "zod/v4";
+import { OpenEnum } from "../types/enums.js";
+/**
+ * Engine-native search mode. Exa supports instant, fast, auto (default), deep-lite, deep, and deep-reasoning. Parallel supports turbo, fast, basic (default), and advanced. Modes unsupported by the selected engine are ignored.
+ */
+export declare const WebSearchMode: {
+    readonly Instant: "instant";
+    readonly Fast: "fast";
+    readonly Auto: "auto";
+    readonly DeepLite: "deep-lite";
+    readonly Deep: "deep";
+    readonly DeepReasoning: "deep-reasoning";
+    readonly Turbo: "turbo";
+    readonly Basic: "basic";
+    readonly Advanced: "advanced";
+};
+/**
+ * Engine-native search mode. Exa supports instant, fast, auto (default), deep-lite, deep, and deep-reasoning. Parallel supports turbo, fast, basic (default), and advanced. Modes unsupported by the selected engine are ignored.
+ */
+export type WebSearchMode = OpenEnum<typeof WebSearchMode>;
+/** @internal */
+export declare const WebSearchMode$inboundSchema: z.ZodType<WebSearchMode, unknown>;
+/** @internal */
+export declare const WebSearchMode$outboundSchema: z.ZodType<string, WebSearchMode>;
+//# sourceMappingURL=websearchmode.d.ts.map

package/esm/models/websearchmode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websearchmode.d.ts","sourceRoot":"","sources":["../../src/models/websearchmode.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;CAUhB,CAAC;AACX;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,aAAa,CAAC,CAAC;AAE3D,gBAAgB;AAChB,eAAO,MAAM,2BAA2B,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAClC,CAAC;AACzC,gBAAgB;AAChB,eAAO,MAAM,4BAA4B,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,aAAa,CACjC,CAAC"}

package/esm/models/websearchmode.js

@@ -0,0 +1,24 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 8aa8c62cf243
+ */
+import * as openEnums from "../types/enums.js";
+/**
+ * Engine-native search mode. Exa supports instant, fast, auto (default), deep-lite, deep, and deep-reasoning. Parallel supports turbo, fast, basic (default), and advanced. Modes unsupported by the selected engine are ignored.
+ */
+export const WebSearchMode = {
+    Instant: "instant",
+    Fast: "fast",
+    Auto: "auto",
+    DeepLite: "deep-lite",
+    Deep: "deep",
+    DeepReasoning: "deep-reasoning",
+    Turbo: "turbo",
+    Basic: "basic",
+    Advanced: "advanced",
+};
+/** @internal */
+export const WebSearchMode$inboundSchema = openEnums.inboundSchema(WebSearchMode);
+/** @internal */
+export const WebSearchMode$outboundSchema = openEnums.outboundSchema(WebSearchMode);
+//# sourceMappingURL=websearchmode.js.map

package/esm/models/websearchmode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websearchmode.js","sourceRoot":"","sources":["../../src/models/websearchmode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAG/C;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,WAAW;IACrB,IAAI,EAAE,MAAM;IACZ,aAAa,EAAE,gBAAgB;IAC/B,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;CACZ,CAAC;AAMX,gBAAgB;AAChB,MAAM,CAAC,MAAM,2BAA2B,GACtC,SAAS,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;AACzC,gBAAgB;AAChB,MAAM,CAAC,MAAM,4BAA4B,GACvC,SAAS,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC"}

package/esm/models/websearchplugin.d.ts

@@ -0,0 +1,84 @@
+import * as z from "zod/v4";
+import { ClosedEnum } from "../types/enums.js";
+import { WebSearchEngine } from "./websearchengine.js";
+import { WebSearchMode } from "./websearchmode.js";
+import { XSearchOptions, XSearchOptions$Outbound } from "./xsearchoptions.js";
+export declare const WebSearchPluginType: {
+    readonly Approximate: "approximate";
+};
+export type WebSearchPluginType = ClosedEnum<typeof WebSearchPluginType>;
+/**
+ * Approximate user location for location-biased search results. Passed through to native providers that support it (e.g. Anthropic).
+ */
+export type UserLocation = {
+    city?: string | null | undefined;
+    country?: string | null | undefined;
+    region?: string | null | undefined;
+    timezone?: string | null | undefined;
+    type: WebSearchPluginType;
+};
+export type WebSearchPlugin = {
+    /**
+     * Set to false to disable the web-search plugin for this request. Defaults to true.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * The search engine to use for web search.
+     */
+    engine?: WebSearchEngine | undefined;
+    /**
+     * A list of domains to exclude from web search results. Supports wildcards (e.g. "*.substack.com") and path filtering (e.g. "openai.com/blog").
+     */
+    excludeDomains?: Array<string> | undefined;
+    id: "web";
+    /**
+     * A list of domains to restrict web search results to. Supports wildcards (e.g. "*.substack.com") and path filtering (e.g. "openai.com/blog").
+     */
+    includeDomains?: Array<string> | undefined;
+    maxResults?: number | undefined;
+    /**
+     * Maximum number of times the model can invoke web search in a single turn. Passed through to native providers that support it (e.g. Anthropic).
+     */
+    maxUses?: number | undefined;
+    /**
+     * Engine-native search mode. Exa supports instant, fast, auto (default), deep-lite, deep, and deep-reasoning. Parallel supports turbo, fast, basic (default), and advanced. Modes unsupported by the selected engine are ignored.
+     */
+    mode?: WebSearchMode | undefined;
+    searchPrompt?: string | undefined;
+    userLocation?: UserLocation | null | undefined;
+    /**
+     * Enable SpaceXAI X (Twitter) search alongside native web search, with optional filters. Only applies to SpaceXAI endpoints with native search; omit to search the web only. X search is billed separately by SpaceXAI, per post and per user profile fetched.
+     */
+    xSearch?: XSearchOptions | undefined;
+};
+/** @internal */
+export declare const WebSearchPluginType$outboundSchema: z.ZodEnum<typeof WebSearchPluginType>;
+/** @internal */
+export type UserLocation$Outbound = {
+    city?: string | null | undefined;
+    country?: string | null | undefined;
+    region?: string | null | undefined;
+    timezone?: string | null | undefined;
+    type: string;
+};
+/** @internal */
+export declare const UserLocation$outboundSchema: z.ZodType<UserLocation$Outbound, UserLocation>;
+export declare function userLocationToJSON(userLocation: UserLocation): string;
+/** @internal */
+export type WebSearchPlugin$Outbound = {
+    enabled?: boolean | undefined;
+    engine?: string | undefined;
+    exclude_domains?: Array<string> | undefined;
+    id: "web";
+    include_domains?: Array<string> | undefined;
+    max_results?: number | undefined;
+    max_uses?: number | undefined;
+    mode?: string | undefined;
+    search_prompt?: string | undefined;
+    user_location?: UserLocation$Outbound | null | undefined;
+    x_search?: XSearchOptions$Outbound | undefined;
+};
+/** @internal */
+export declare const WebSearchPlugin$outboundSchema: z.ZodType<WebSearchPlugin$Outbound, WebSearchPlugin>;
+export declare function webSearchPluginToJSON(webSearchPlugin: WebSearchPlugin): string;
+//# sourceMappingURL=websearchplugin.d.ts.map

package/esm/models/websearchplugin.d.ts.map

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

package/esm/models/websearchplugin.js

@@ -0,0 +1,54 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: fa32581277e2
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import { WebSearchEngine$outboundSchema, } from "./websearchengine.js";
+import { WebSearchMode$outboundSchema, } from "./websearchmode.js";
+import { XSearchOptions$outboundSchema, } from "./xsearchoptions.js";
+export const WebSearchPluginType = {
+    Approximate: "approximate",
+};
+/** @internal */
+export const WebSearchPluginType$outboundSchema = z.enum(WebSearchPluginType);
+/** @internal */
+export const UserLocation$outboundSchema = z.object({
+    city: z.nullable(z.string()).optional(),
+    country: z.nullable(z.string()).optional(),
+    region: z.nullable(z.string()).optional(),
+    timezone: z.nullable(z.string()).optional(),
+    type: WebSearchPluginType$outboundSchema,
+});
+export function userLocationToJSON(userLocation) {
+    return JSON.stringify(UserLocation$outboundSchema.parse(userLocation));
+}
+/** @internal */
+export const WebSearchPlugin$outboundSchema = z.object({
+    enabled: z.boolean().optional(),
+    engine: WebSearchEngine$outboundSchema.optional(),
+    excludeDomains: z.array(z.string()).optional(),
+    id: z.literal("web"),
+    includeDomains: z.array(z.string()).optional(),
+    maxResults: z.int().optional(),
+    maxUses: z.int().optional(),
+    mode: WebSearchMode$outboundSchema.optional(),
+    searchPrompt: z.string().optional(),
+    userLocation: z.nullable(z.lazy(() => UserLocation$outboundSchema))
+        .optional(),
+    xSearch: XSearchOptions$outboundSchema.optional(),
+}).transform((v) => {
+    return remap$(v, {
+        excludeDomains: "exclude_domains",
+        includeDomains: "include_domains",
+        maxResults: "max_results",
+        maxUses: "max_uses",
+        searchPrompt: "search_prompt",
+        userLocation: "user_location",
+        xSearch: "x_search",
+    });
+});
+export function webSearchPluginToJSON(webSearchPlugin) {
+    return JSON.stringify(WebSearchPlugin$outboundSchema.parse(webSearchPlugin));
+}
+//# sourceMappingURL=websearchplugin.js.map

package/esm/models/websearchplugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websearchplugin.js","sourceRoot":"","sources":["../../src/models/websearchplugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAEL,8BAA8B,GAC/B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,WAAW,EAAE,aAAa;CAClB,CAAC;AAiDX,gBAAgB;AAChB,MAAM,CAAC,MAAM,kCAAkC,GAE3C,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;AAWhC,gBAAgB;AAChB,MAAM,CAAC,MAAM,2BAA2B,GAGpC,CAAC,CAAC,MAAM,CAAC;IACX,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3C,IAAI,EAAE,kCAAkC;CACzC,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAC,YAA0B;IAC3D,OAAO,IAAI,CAAC,SAAS,CAAC,2BAA2B,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;AACzE,CAAC;AAiBD,gBAAgB;AAChB,MAAM,CAAC,MAAM,8BAA8B,GAGvC,CAAC,CAAC,MAAM,CAAC;IACX,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,MAAM,EAAE,8BAA8B,CAAC,QAAQ,EAAE;IACjD,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9C,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACpB,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9C,UAAU,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC3B,IAAI,EAAE,4BAA4B,CAAC,QAAQ,EAAE;IAC7C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,2BAA2B,CAAC,CAAC;SAChE,QAAQ,EAAE;IACb,OAAO,EAAE,6BAA6B,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,OAAO,MAAM,CAAC,CAAC,EAAE;QACf,cAAc,EAAE,iBAAiB;QACjC,cAAc,EAAE,iBAAiB;QACjC,UAAU,EAAE,aAAa;QACzB,OAAO,EAAE,UAAU;QACnB,YAAY,EAAE,eAAe;QAC7B,YAAY,EAAE,eAAe;QAC7B,OAAO,EAAE,UAAU;KACpB,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CACnC,eAAgC;IAEhC,OAAO,IAAI,CAAC,SAAS,CAAC,8BAA8B,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;AAC/E,CAAC"}

package/esm/models/websearchservertool.d.ts

@@ -0,0 +1,72 @@
+import * as z from "zod/v4";
+import { ClosedEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import { SearchContextSizeEnum } from "./searchcontextsizeenum.js";
+import { WebSearchDomainFilter, WebSearchDomainFilter$Outbound } from "./websearchdomainfilter.js";
+import { WebSearchEngineEnum } from "./websearchengineenum.js";
+import { WebSearchMode } from "./websearchmode.js";
+import { WebSearchUserLocation, WebSearchUserLocation$Outbound } from "./websearchuserlocation.js";
+import { XSearchOptions, XSearchOptions$Outbound } from "./xsearchoptions.js";
+export declare const WebSearchServerToolType: {
+    readonly WebSearch20250826: "web_search_2025_08_26";
+};
+export type WebSearchServerToolType = ClosedEnum<typeof WebSearchServerToolType>;
+/**
+ * Web search tool configuration (2025-08-26 version)
+ */
+export type WebSearchServerTool = {
+    /**
+     * Which search engine to use. "auto" (default) uses native if the provider supports it, otherwise Exa. "native" forces the provider's built-in search. "exa" forces the Exa search API. "firecrawl" uses Firecrawl (requires BYOK). "parallel" uses the Parallel search API. "perplexity" uses the Perplexity Search API (raw ranked results).
+     */
+    engine?: WebSearchEngineEnum | undefined;
+    filters?: WebSearchDomainFilter | null | undefined;
+    /**
+     * Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, Parallel, and Perplexity engines; ignored with native provider search. Perplexity supports a maximum of 20; values above 20 are clamped.
+     */
+    maxResults?: number | undefined;
+    /**
+     * Maximum number of web searches the model may perform in a single request. Once reached, further search calls return an error result instead of executing. Applies to the Exa, Firecrawl, Parallel, and Perplexity engines. With native provider search, forwarded only to Anthropic (as `max_uses`); other native search providers have no equivalent parameter and ignore it.
+     */
+    maxUses?: number | undefined;
+    /**
+     * Engine-native search mode. Exa supports instant, fast, auto (default), deep-lite, deep, and deep-reasoning. Parallel supports turbo, fast, basic (default), and advanced. Modes unsupported by the selected engine are ignored.
+     */
+    mode?: WebSearchMode | undefined;
+    /**
+     * Size of the search context for web search tools
+     */
+    searchContextSize?: SearchContextSizeEnum | undefined;
+    type: WebSearchServerToolType;
+    /**
+     * User location information for web search
+     */
+    userLocation?: WebSearchUserLocation | null | undefined;
+    /**
+     * Enable SpaceXAI X (Twitter) search alongside native web search, with optional filters. Only applies to SpaceXAI endpoints with native search; omit to search the web only. X search is billed separately by SpaceXAI, per post and per user profile fetched.
+     */
+    xSearch?: XSearchOptions | undefined;
+};
+/** @internal */
+export declare const WebSearchServerToolType$inboundSchema: z.ZodEnum<typeof WebSearchServerToolType>;
+/** @internal */
+export declare const WebSearchServerToolType$outboundSchema: z.ZodEnum<typeof WebSearchServerToolType>;
+/** @internal */
+export declare const WebSearchServerTool$inboundSchema: z.ZodType<WebSearchServerTool, unknown>;
+/** @internal */
+export type WebSearchServerTool$Outbound = {
+    engine?: string | undefined;
+    filters?: WebSearchDomainFilter$Outbound | null | undefined;
+    max_results?: number | undefined;
+    max_uses?: number | undefined;
+    mode?: string | undefined;
+    search_context_size?: string | undefined;
+    type: string;
+    user_location?: WebSearchUserLocation$Outbound | null | undefined;
+    x_search?: XSearchOptions$Outbound | undefined;
+};
+/** @internal */
+export declare const WebSearchServerTool$outboundSchema: z.ZodType<WebSearchServerTool$Outbound, WebSearchServerTool>;
+export declare function webSearchServerToolToJSON(webSearchServerTool: WebSearchServerTool): string;
+export declare function webSearchServerToolFromJSON(jsonString: string): SafeParseResult<WebSearchServerTool, SDKValidationError>;
+//# sourceMappingURL=websearchservertool.d.ts.map

package/esm/models/websearchservertool.d.ts.map

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