cloudflare 6.1.0 → 6.2.0

package/resources/ai-security/ai-security.mjs

@@ -0,0 +1,42 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../resource.mjs";
+import * as CustomTopicsAPI from "./custom-topics.mjs";
+import { CustomTopics, } from "./custom-topics.mjs";
+export class AISecurity extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.customTopics = new CustomTopicsAPI.CustomTopics(this._client);
+    }
+    /**
+     * Enable or disable AI Security for Apps for a zone.
+     *
+     * Changes can take up to a minute to propagate to the zone.
+     *
+     * @example
+     * ```ts
+     * const aiSecurity = await client.aiSecurity.update({
+     *   zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
+     * });
+     * ```
+     */
+    update(params, options) {
+        const { zone_id, ...body } = params;
+        return this._client.put(`/zones/${zone_id}/ai-security/settings`, { body, ...options })._thenUnwrap((obj) => obj.result);
+    }
+    /**
+     * Get whether AI Security for Apps is enabled or disabled for a zone.
+     *
+     * @example
+     * ```ts
+     * const aiSecurity = await client.aiSecurity.get({
+     *   zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
+     * });
+     * ```
+     */
+    get(params, options) {
+        const { zone_id } = params;
+        return this._client.get(`/zones/${zone_id}/ai-security/settings`, options)._thenUnwrap((obj) => obj.result);
+    }
+}
+AISecurity.CustomTopics = CustomTopics;
+//# sourceMappingURL=ai-security.mjs.map

package/resources/ai-security/ai-security.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-security.mjs","sourceRoot":"","sources":["../../src/resources/ai-security/ai-security.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,KAAK,eAAe;OACpB,EAKL,YAAY,GACb;AAED,MAAM,OAAO,UAAW,SAAQ,WAAW;IAA3C;;QACE,iBAAY,GAAiC,IAAI,eAAe,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA4C9F,CAAC;IA1CC;;;;;;;;;;;OAWG;IACH,MAAM,CACJ,MAA8B,EAC9B,OAA6B;QAE7B,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACpC,OACE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,OAAO,uBAAuB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAGhF,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;;;;OASG;IACH,GAAG,CAAC,MAA2B,EAAE,OAA6B;QAC5D,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC3B,OACE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,OAAO,uBAAuB,EAAE,OAAO,CAGnE,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;CACF;AAyCD,UAAU,CAAC,YAAY,GAAG,YAAY,CAAC"}

package/resources/ai-security/custom-topics.d.ts

@@ -0,0 +1,105 @@
+import { APIResource } from "../../resource.js";
+import * as Core from "../../core.js";
+export declare class CustomTopics extends APIResource {
+    /**
+     * Set the AI Security for Apps custom topic categories for a zone.
+     *
+     * A maximum of 20 custom topics can be configured per zone. Each topic label must
+     * be 2–20 characters using only lowercase letters (a–z), digits (0–9), and
+     * hyphens. Each topic description must be 2–50 printable ASCII characters.
+     *
+     * Changes can take up to a minute to propagate to the zone.
+     *
+     * @example
+     * ```ts
+     * const customTopic =
+     *   await client.aiSecurity.customTopics.update({
+     *     zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
+     *   });
+     * ```
+     */
+    update(params: CustomTopicUpdateParams, options?: Core.RequestOptions): Core.APIPromise<CustomTopicUpdateResponse>;
+    /**
+     * Get the AI Security for Apps custom topic categories for a zone.
+     *
+     * @example
+     * ```ts
+     * const customTopic =
+     *   await client.aiSecurity.customTopics.get({
+     *     zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
+     *   });
+     * ```
+     */
+    get(params: CustomTopicGetParams, options?: Core.RequestOptions): Core.APIPromise<CustomTopicGetResponse>;
+}
+export interface CustomTopicUpdateResponse {
+    /**
+     * Custom topic categories for AI Security for Apps content detection.
+     */
+    topics?: Array<CustomTopicUpdateResponse.Topic>;
+}
+export declare namespace CustomTopicUpdateResponse {
+    interface Topic {
+        /**
+         * Unique label identifier. Must contain only lowercase letters (a–z), digits
+         * (0–9), and hyphens.
+         */
+        label: string;
+        /**
+         * Description of the topic category. Must contain only printable ASCII characters.
+         */
+        topic: string;
+    }
+}
+export interface CustomTopicGetResponse {
+    /**
+     * Custom topic categories for AI Security for Apps content detection.
+     */
+    topics?: Array<CustomTopicGetResponse.Topic>;
+}
+export declare namespace CustomTopicGetResponse {
+    interface Topic {
+        /**
+         * Unique label identifier. Must contain only lowercase letters (a–z), digits
+         * (0–9), and hyphens.
+         */
+        label: string;
+        /**
+         * Description of the topic category. Must contain only printable ASCII characters.
+         */
+        topic: string;
+    }
+}
+export interface CustomTopicUpdateParams {
+    /**
+     * Path param: Defines the zone.
+     */
+    zone_id: string;
+    /**
+     * Body param: Custom topic categories for AI Security for Apps content detection.
+     */
+    topics?: Array<CustomTopicUpdateParams.Topic>;
+}
+export declare namespace CustomTopicUpdateParams {
+    interface Topic {
+        /**
+         * Unique label identifier. Must contain only lowercase letters (a–z), digits
+         * (0–9), and hyphens.
+         */
+        label: string;
+        /**
+         * Description of the topic category. Must contain only printable ASCII characters.
+         */
+        topic: string;
+    }
+}
+export interface CustomTopicGetParams {
+    /**
+     * Defines the zone.
+     */
+    zone_id: string;
+}
+export declare namespace CustomTopics {
+    export { type CustomTopicUpdateResponse as CustomTopicUpdateResponse, type CustomTopicGetResponse as CustomTopicGetResponse, type CustomTopicUpdateParams as CustomTopicUpdateParams, type CustomTopicGetParams as CustomTopicGetParams, };
+}
+//# sourceMappingURL=custom-topics.d.ts.map

package/resources/ai-security/custom-topics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-topics.d.ts","sourceRoot":"","sources":["../../src/resources/ai-security/custom-topics.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AAEnC,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CACJ,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAC5B,IAAI,CAAC,UAAU,CAAC,yBAAyB,CAAC;IAU7C;;;;;;;;;;OAUG;IACH,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC;CAQ1G;AAED,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC;CACjD;AAED,yBAAiB,yBAAyB,CAAC;IACzC,UAAiB,KAAK;QACpB;;;WAGG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;KACf;CACF;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;CAC9C;AAED,yBAAiB,sBAAsB,CAAC;IACtC,UAAiB,KAAK;QACpB;;;WAGG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;KACf;CACF;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;CAC/C;AAED,yBAAiB,uBAAuB,CAAC;IACvC,UAAiB,KAAK;QACpB;;;WAGG;QACH,KAAK,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;KACf;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EACL,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH"}

package/resources/ai-security/custom-topics.js

@@ -0,0 +1,48 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomTopics = void 0;
+const resource_1 = require("../../resource.js");
+class CustomTopics extends resource_1.APIResource {
+    /**
+     * Set the AI Security for Apps custom topic categories for a zone.
+     *
+     * A maximum of 20 custom topics can be configured per zone. Each topic label must
+     * be 2–20 characters using only lowercase letters (a–z), digits (0–9), and
+     * hyphens. Each topic description must be 2–50 printable ASCII characters.
+     *
+     * Changes can take up to a minute to propagate to the zone.
+     *
+     * @example
+     * ```ts
+     * const customTopic =
+     *   await client.aiSecurity.customTopics.update({
+     *     zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
+     *   });
+     * ```
+     */
+    update(params, options) {
+        const { zone_id, ...body } = params;
+        return this._client.put(`/zones/${zone_id}/ai-security/custom-topics`, {
+            body,
+            ...options,
+        })._thenUnwrap((obj) => obj.result);
+    }
+    /**
+     * Get the AI Security for Apps custom topic categories for a zone.
+     *
+     * @example
+     * ```ts
+     * const customTopic =
+     *   await client.aiSecurity.customTopics.get({
+     *     zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
+     *   });
+     * ```
+     */
+    get(params, options) {
+        const { zone_id } = params;
+        return this._client.get(`/zones/${zone_id}/ai-security/custom-topics`, options)._thenUnwrap((obj) => obj.result);
+    }
+}
+exports.CustomTopics = CustomTopics;
+//# sourceMappingURL=custom-topics.js.map

package/resources/ai-security/custom-topics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-topics.js","sourceRoot":"","sources":["../../src/resources/ai-security/custom-topics.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,gDAA6C;AAG7C,MAAa,YAAa,SAAQ,sBAAW;IAC3C;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CACJ,MAA+B,EAC/B,OAA6B;QAE7B,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACpC,OACE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,OAAO,4BAA4B,EAAE;YAC9D,IAAI;YACJ,GAAG,OAAO;SACX,CACF,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;;;;;OAUG;IACH,GAAG,CAAC,MAA4B,EAAE,OAA6B;QAC7D,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC3B,OACE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,OAAO,4BAA4B,EAAE,OAAO,CAGxE,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;CACF;AAlDD,oCAkDC"}

package/resources/ai-security/custom-topics.mjs

@@ -0,0 +1,44 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../resource.mjs";
+export class CustomTopics extends APIResource {
+    /**
+     * Set the AI Security for Apps custom topic categories for a zone.
+     *
+     * A maximum of 20 custom topics can be configured per zone. Each topic label must
+     * be 2–20 characters using only lowercase letters (a–z), digits (0–9), and
+     * hyphens. Each topic description must be 2–50 printable ASCII characters.
+     *
+     * Changes can take up to a minute to propagate to the zone.
+     *
+     * @example
+     * ```ts
+     * const customTopic =
+     *   await client.aiSecurity.customTopics.update({
+     *     zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
+     *   });
+     * ```
+     */
+    update(params, options) {
+        const { zone_id, ...body } = params;
+        return this._client.put(`/zones/${zone_id}/ai-security/custom-topics`, {
+            body,
+            ...options,
+        })._thenUnwrap((obj) => obj.result);
+    }
+    /**
+     * Get the AI Security for Apps custom topic categories for a zone.
+     *
+     * @example
+     * ```ts
+     * const customTopic =
+     *   await client.aiSecurity.customTopics.get({
+     *     zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
+     *   });
+     * ```
+     */
+    get(params, options) {
+        const { zone_id } = params;
+        return this._client.get(`/zones/${zone_id}/ai-security/custom-topics`, options)._thenUnwrap((obj) => obj.result);
+    }
+}
+//# sourceMappingURL=custom-topics.mjs.map

package/resources/ai-security/custom-topics.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-topics.mjs","sourceRoot":"","sources":["../../src/resources/ai-security/custom-topics.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAGtB,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CACJ,MAA+B,EAC/B,OAA6B;QAE7B,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACpC,OACE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,OAAO,4BAA4B,EAAE;YAC9D,IAAI;YACJ,GAAG,OAAO;SACX,CACF,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;;;;;OAUG;IACH,GAAG,CAAC,MAA4B,EAAE,OAA6B;QAC7D,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC3B,OACE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,OAAO,4BAA4B,EAAE,OAAO,CAGxE,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;CACF"}

package/resources/ai-security/index.d.ts

@@ -0,0 +1,3 @@
+export { AISecurity } from "./ai-security.js";
+export { CustomTopics, type CustomTopicUpdateResponse, type CustomTopicGetResponse, type CustomTopicUpdateParams, type CustomTopicGetParams, } from "./custom-topics.js";
+//# sourceMappingURL=index.d.ts.map

package/resources/ai-security/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/ai-security/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EACL,YAAY,EACZ,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC"}

package/resources/ai-security/index.js

@@ -0,0 +1,9 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomTopics = exports.AISecurity = void 0;
+var ai_security_1 = require("./ai-security.js");
+Object.defineProperty(exports, "AISecurity", { enumerable: true, get: function () { return ai_security_1.AISecurity; } });
+var custom_topics_1 = require("./custom-topics.js");
+Object.defineProperty(exports, "CustomTopics", { enumerable: true, get: function () { return custom_topics_1.CustomTopics; } });
+//# sourceMappingURL=index.js.map

package/resources/ai-security/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/ai-security/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,gDAA2C;AAAlC,yGAAA,UAAU,OAAA;AACnB,oDAMyB;AALvB,6GAAA,YAAY,OAAA"}

package/resources/ai-security/index.mjs

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { AISecurity } from "./ai-security.mjs";
+export { CustomTopics, } from "./custom-topics.mjs";
+//# sourceMappingURL=index.mjs.map

package/resources/ai-security/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/ai-security/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,UAAU,EAAE;OACd,EACL,YAAY,GAKb"}

package/resources/ai-security.d.ts

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

package/resources/ai-security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-security.d.ts","sourceRoot":"","sources":["../src/resources/ai-security.ts"],"names":[],"mappings":"AAEA,cAAc,qBAAqB,CAAC"}

package/resources/ai-security.js

@@ -0,0 +1,19 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ai-security/index.js"), exports);
+//# sourceMappingURL=ai-security.js.map

package/resources/ai-security.js.map

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

package/resources/ai-security.mjs

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

package/resources/ai-security.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-security.mjs","sourceRoot":"","sources":["../src/resources/ai-security.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/resources/aisearch/instances/instances.d.ts

@@ -307,9 +307,15 @@ export declare namespace InstanceCreateResponse {
                 /**
                  * List of path-to-selector mappings for extracting specific content from crawled
                  * pages. Each entry pairs a URL glob pattern with a CSS selector. The first
-                 * matching path wins. Only the matched HTML fragment is stored and indexed.
+                 * matching path wins. Only the matched HTML fragment is stored and indexed. Omit
+                 * the field to disable content selection — empty arrays are rejected.
                  */
                 content_selector?: Array<ParseOptions.ContentSelector>;
+                /**
+                 * Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230
+                 * token characters (no spaces, colons, or control characters); values must be
+                 * HTAB + printable ASCII (no CR/LF).
+                 */
                 include_headers?: {
                     [key: string]: string;
                 };
@@ -329,8 +335,9 @@ export declare namespace InstanceCreateResponse {
                      */
                     path: string;
                     /**
-                     * CSS selector to extract content from pages matching the path pattern. Supports
-                     * standard CSS selectors including class, ID, element, and attribute selectors.
+                     * CSS selector to extract content from pages matching the path pattern. Must not
+                     * contain disallowed characters (;, `, $, {, }, \). Must target a single element;
+                     * if multiple elements match, the selector is ignored and the full page is used.
                      */
                     selector: string;
                 }
@@ -537,9 +544,15 @@ export declare namespace InstanceUpdateResponse {
                 /**
                  * List of path-to-selector mappings for extracting specific content from crawled
                  * pages. Each entry pairs a URL glob pattern with a CSS selector. The first
-                 * matching path wins. Only the matched HTML fragment is stored and indexed.
+                 * matching path wins. Only the matched HTML fragment is stored and indexed. Omit
+                 * the field to disable content selection — empty arrays are rejected.
                  */
                 content_selector?: Array<ParseOptions.ContentSelector>;
+                /**
+                 * Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230
+                 * token characters (no spaces, colons, or control characters); values must be
+                 * HTAB + printable ASCII (no CR/LF).
+                 */
                 include_headers?: {
                     [key: string]: string;
                 };
@@ -559,8 +572,9 @@ export declare namespace InstanceUpdateResponse {
                      */
                     path: string;
                     /**
-                     * CSS selector to extract content from pages matching the path pattern. Supports
-                     * standard CSS selectors including class, ID, element, and attribute selectors.
+                     * CSS selector to extract content from pages matching the path pattern. Must not
+                     * contain disallowed characters (;, `, $, {, }, \). Must target a single element;
+                     * if multiple elements match, the selector is ignored and the full page is used.
                      */
                     selector: string;
                 }
@@ -767,9 +781,15 @@ export declare namespace InstanceListResponse {
                 /**
                  * List of path-to-selector mappings for extracting specific content from crawled
                  * pages. Each entry pairs a URL glob pattern with a CSS selector. The first
-                 * matching path wins. Only the matched HTML fragment is stored and indexed.
+                 * matching path wins. Only the matched HTML fragment is stored and indexed. Omit
+                 * the field to disable content selection — empty arrays are rejected.
                  */
                 content_selector?: Array<ParseOptions.ContentSelector>;
+                /**
+                 * Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230
+                 * token characters (no spaces, colons, or control characters); values must be
+                 * HTAB + printable ASCII (no CR/LF).
+                 */
                 include_headers?: {
                     [key: string]: string;
                 };
@@ -789,8 +809,9 @@ export declare namespace InstanceListResponse {
                      */
                     path: string;
                     /**
-                     * CSS selector to extract content from pages matching the path pattern. Supports
-                     * standard CSS selectors including class, ID, element, and attribute selectors.
+                     * CSS selector to extract content from pages matching the path pattern. Must not
+                     * contain disallowed characters (;, `, $, {, }, \). Must target a single element;
+                     * if multiple elements match, the selector is ignored and the full page is used.
                      */
                     selector: string;
                 }
@@ -997,9 +1018,15 @@ export declare namespace InstanceDeleteResponse {
                 /**
                  * List of path-to-selector mappings for extracting specific content from crawled
                  * pages. Each entry pairs a URL glob pattern with a CSS selector. The first
-                 * matching path wins. Only the matched HTML fragment is stored and indexed.
+                 * matching path wins. Only the matched HTML fragment is stored and indexed. Omit
+                 * the field to disable content selection — empty arrays are rejected.
                  */
                 content_selector?: Array<ParseOptions.ContentSelector>;
+                /**
+                 * Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230
+                 * token characters (no spaces, colons, or control characters); values must be
+                 * HTAB + printable ASCII (no CR/LF).
+                 */
                 include_headers?: {
                     [key: string]: string;
                 };
@@ -1019,8 +1046,9 @@ export declare namespace InstanceDeleteResponse {
                      */
                     path: string;
                     /**
-                     * CSS selector to extract content from pages matching the path pattern. Supports
-                     * standard CSS selectors including class, ID, element, and attribute selectors.
+                     * CSS selector to extract content from pages matching the path pattern. Must not
+                     * contain disallowed characters (;, `, $, {, }, \). Must target a single element;
+                     * if multiple elements match, the selector is ignored and the full page is used.
                      */
                     selector: string;
                 }
@@ -1273,9 +1301,15 @@ export declare namespace InstanceReadResponse {
                 /**
                  * List of path-to-selector mappings for extracting specific content from crawled
                  * pages. Each entry pairs a URL glob pattern with a CSS selector. The first
-                 * matching path wins. Only the matched HTML fragment is stored and indexed.
+                 * matching path wins. Only the matched HTML fragment is stored and indexed. Omit
+                 * the field to disable content selection — empty arrays are rejected.
                  */
                 content_selector?: Array<ParseOptions.ContentSelector>;
+                /**
+                 * Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230
+                 * token characters (no spaces, colons, or control characters); values must be
+                 * HTAB + printable ASCII (no CR/LF).
+                 */
                 include_headers?: {
                     [key: string]: string;
                 };
@@ -1295,8 +1329,9 @@ export declare namespace InstanceReadResponse {
                      */
                     path: string;
                     /**
-                     * CSS selector to extract content from pages matching the path pattern. Supports
-                     * standard CSS selectors including class, ID, element, and attribute selectors.
+                     * CSS selector to extract content from pages matching the path pattern. Must not
+                     * contain disallowed characters (;, `, $, {, }, \). Must target a single element;
+                     * if multiple elements match, the selector is ignored and the full page is used.
                      */
                     selector: string;
                 }
@@ -1653,9 +1688,15 @@ export declare namespace InstanceCreateParams {
                 /**
                  * List of path-to-selector mappings for extracting specific content from crawled
                  * pages. Each entry pairs a URL glob pattern with a CSS selector. The first
-                 * matching path wins. Only the matched HTML fragment is stored and indexed.
+                 * matching path wins. Only the matched HTML fragment is stored and indexed. Omit
+                 * the field to disable content selection — empty arrays are rejected.
                  */
                 content_selector?: Array<ParseOptions.ContentSelector>;
+                /**
+                 * Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230
+                 * token characters (no spaces, colons, or control characters); values must be
+                 * HTAB + printable ASCII (no CR/LF).
+                 */
                 include_headers?: {
                     [key: string]: string;
                 };
@@ -1675,8 +1716,9 @@ export declare namespace InstanceCreateParams {
                      */
                     path: string;
                     /**
-                     * CSS selector to extract content from pages matching the path pattern. Supports
-                     * standard CSS selectors including class, ID, element, and attribute selectors.
+                     * CSS selector to extract content from pages matching the path pattern. Must not
+                     * contain disallowed characters (;, `, $, {, }, \). Must target a single element;
+                     * if multiple elements match, the selector is ignored and the full page is used.
                      */
                     selector: string;
                 }
@@ -1958,9 +2000,15 @@ export declare namespace InstanceUpdateParams {
                 /**
                  * List of path-to-selector mappings for extracting specific content from crawled
                  * pages. Each entry pairs a URL glob pattern with a CSS selector. The first
-                 * matching path wins. Only the matched HTML fragment is stored and indexed.
+                 * matching path wins. Only the matched HTML fragment is stored and indexed. Omit
+                 * the field to disable content selection — empty arrays are rejected.
                  */
                 content_selector?: Array<ParseOptions.ContentSelector>;
+                /**
+                 * Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230
+                 * token characters (no spaces, colons, or control characters); values must be
+                 * HTAB + printable ASCII (no CR/LF).
+                 */
                 include_headers?: {
                     [key: string]: string;
                 };
@@ -1980,8 +2028,9 @@ export declare namespace InstanceUpdateParams {
                      */
                     path: string;
                     /**
-                     * CSS selector to extract content from pages matching the path pattern. Supports
-                     * standard CSS selectors including class, ID, element, and attribute selectors.
+                     * CSS selector to extract content from pages matching the path pattern. Must not
+                     * contain disallowed characters (;, `, $, {, }, \). Must target a single element;
+                     * if multiple elements match, the selector is ignored and the full page is used.
                      */
                     selector: string;
                 }