@tabstack/sdk 2.0.0 → 2.2.0

package/resources/agent.d.mts

@@ -4,14 +4,19 @@ import { Stream } from "../core/streaming.mjs";
 import { RequestOptions } from "../internal/request-options.mjs";
 export declare class Agent extends APIResource {
     /**
-     * Execute AI-powered browser automation tasks using natural language. This
-     * endpoint **always streams** responses using Server-Sent Events (SSE).
+     * Execute AI-powered browser automation tasks using natural language with optional
+     * geotargeting. This endpoint **always streams** responses using Server-Sent
+     * Events (SSE).
      *
      * **Streaming Response:**
      *
      * - All responses are streamed using Server-Sent Events (`text/event-stream`)
      * - Real-time progress updates and results as they're generated
      *
+     * **Geotargeting:**
+     *
+     * - Optionally specify a country code for geotargeted browsing
+     *
      * **Use Cases:**
      *
      * - Web scraping and data extraction
@@ -31,6 +36,37 @@ export declare class Agent extends APIResource {
      * ```
      */
     automate(body: AgentAutomateParams, options?: RequestOptions): APIPromise<Stream<AutomateEvent>>;
+    /**
+     * Execute AI-powered research queries that search the web, analyze sources, and
+     * synthesize comprehensive answers. This endpoint **always streams** responses
+     * using Server-Sent Events (SSE).
+     *
+     * **Streaming Response:**
+     *
+     * - All responses are streamed using Server-Sent Events (`text/event-stream`)
+     * - Real-time progress updates as research progresses through phases
+     *
+     * **Research Modes:**
+     *
+     * - `fast` - Quick answers with minimal web searches
+     * - `balanced` - Standard research with multiple iterations (default)
+     *
+     * **Use Cases:**
+     *
+     * - Answering complex questions with cited sources
+     * - Synthesizing information from multiple web sources
+     * - Research reports on specific topics
+     * - Fact-checking and verification tasks
+     *
+     * @example
+     * ```ts
+     * const researchEvent = await client.agent.research({
+     *   query:
+     *     'What are the latest developments in quantum computing?',
+     * });
+     * ```
+     */
+    research(body: AgentResearchParams, options?: RequestOptions): APIPromise<Stream<ResearchEvent>>;
 }
 export interface AutomateEvent {
     /**
@@ -42,6 +78,16 @@ export interface AutomateEvent {
      */
     event?: string;
 }
+export interface ResearchEvent {
+    /**
+     * Event payload data
+     */
+    data?: unknown;
+    /**
+     * The event type: phase, progress, complete, or error
+     */
+    event?: 'phase' | 'progress' | 'complete' | 'error';
+}
 export interface AgentAutomateParams {
     /**
      * The task description in natural language
@@ -51,6 +97,10 @@ export interface AgentAutomateParams {
      * JSON data to provide context for form filling or complex tasks
      */
     data?: unknown;
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    geo_target?: AgentAutomateParams.GeoTarget;
     /**
      * Safety constraints for execution
      */
@@ -68,7 +118,37 @@ export interface AgentAutomateParams {
      */
     url?: string;
 }
+export declare namespace AgentAutomateParams {
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    interface GeoTarget {
+        /**
+         * Country code using ISO 3166-1 alpha-2 standard (2 letters, e.g., "US", "GB",
+         * "JP"). See: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
+         */
+        country?: string;
+    }
+}
+export interface AgentResearchParams {
+    /**
+     * The research query or question to answer
+     */
+    query: string;
+    /**
+     * Timeout in seconds for fetching web pages
+     */
+    fetch_timeout?: number;
+    /**
+     * Research mode: fast (quick answers), balanced (standard research, default)
+     */
+    mode?: 'fast' | 'balanced';
+    /**
+     * Skip cache and force fresh research
+     */
+    nocache?: boolean;
+}
 export declare namespace Agent {
-    export { type AutomateEvent as AutomateEvent, type AgentAutomateParams as AgentAutomateParams };
+    export { type AutomateEvent as AutomateEvent, type ResearchEvent as ResearchEvent, type AgentAutomateParams as AgentAutomateParams, type AgentResearchParams as AgentResearchParams, };
 }
 //# sourceMappingURL=agent.d.mts.map

package/resources/agent.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.mts","sourceRoot":"","sources":["../src/resources/agent.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,MAAM,EAAE;OAEV,EAAE,cAAc,EAAE;AAEzB,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,QAAQ,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;CAQjG;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EAAE,KAAK,aAAa,IAAI,aAAa,EAAE,KAAK,mBAAmB,IAAI,mBAAmB,EAAE,CAAC;CACjG"}
+{"version":3,"file":"agent.d.mts","sourceRoot":"","sources":["../src/resources/agent.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,MAAM,EAAE;OAEV,EAAE,cAAc,EAAE;AAEzB,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,QAAQ,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAShG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,QAAQ,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;CAQjG;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;CACrD;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,UAAU,CAAC,EAAE,mBAAmB,CAAC,SAAS,CAAC;IAE3C;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,yBAAiB,mBAAmB,CAAC;IACnC;;OAEG;IACH,UAAiB,SAAS;QACxB;;;WAGG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}

package/resources/agent.d.ts

@@ -4,14 +4,19 @@ import { Stream } from "../core/streaming.js";
 import { RequestOptions } from "../internal/request-options.js";
 export declare class Agent extends APIResource {
     /**
-     * Execute AI-powered browser automation tasks using natural language. This
-     * endpoint **always streams** responses using Server-Sent Events (SSE).
+     * Execute AI-powered browser automation tasks using natural language with optional
+     * geotargeting. This endpoint **always streams** responses using Server-Sent
+     * Events (SSE).
      *
      * **Streaming Response:**
      *
      * - All responses are streamed using Server-Sent Events (`text/event-stream`)
      * - Real-time progress updates and results as they're generated
      *
+     * **Geotargeting:**
+     *
+     * - Optionally specify a country code for geotargeted browsing
+     *
      * **Use Cases:**
      *
      * - Web scraping and data extraction
@@ -31,6 +36,37 @@ export declare class Agent extends APIResource {
      * ```
      */
     automate(body: AgentAutomateParams, options?: RequestOptions): APIPromise<Stream<AutomateEvent>>;
+    /**
+     * Execute AI-powered research queries that search the web, analyze sources, and
+     * synthesize comprehensive answers. This endpoint **always streams** responses
+     * using Server-Sent Events (SSE).
+     *
+     * **Streaming Response:**
+     *
+     * - All responses are streamed using Server-Sent Events (`text/event-stream`)
+     * - Real-time progress updates as research progresses through phases
+     *
+     * **Research Modes:**
+     *
+     * - `fast` - Quick answers with minimal web searches
+     * - `balanced` - Standard research with multiple iterations (default)
+     *
+     * **Use Cases:**
+     *
+     * - Answering complex questions with cited sources
+     * - Synthesizing information from multiple web sources
+     * - Research reports on specific topics
+     * - Fact-checking and verification tasks
+     *
+     * @example
+     * ```ts
+     * const researchEvent = await client.agent.research({
+     *   query:
+     *     'What are the latest developments in quantum computing?',
+     * });
+     * ```
+     */
+    research(body: AgentResearchParams, options?: RequestOptions): APIPromise<Stream<ResearchEvent>>;
 }
 export interface AutomateEvent {
     /**
@@ -42,6 +78,16 @@ export interface AutomateEvent {
      */
     event?: string;
 }
+export interface ResearchEvent {
+    /**
+     * Event payload data
+     */
+    data?: unknown;
+    /**
+     * The event type: phase, progress, complete, or error
+     */
+    event?: 'phase' | 'progress' | 'complete' | 'error';
+}
 export interface AgentAutomateParams {
     /**
      * The task description in natural language
@@ -51,6 +97,10 @@ export interface AgentAutomateParams {
      * JSON data to provide context for form filling or complex tasks
      */
     data?: unknown;
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    geo_target?: AgentAutomateParams.GeoTarget;
     /**
      * Safety constraints for execution
      */
@@ -68,7 +118,37 @@ export interface AgentAutomateParams {
      */
     url?: string;
 }
+export declare namespace AgentAutomateParams {
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    interface GeoTarget {
+        /**
+         * Country code using ISO 3166-1 alpha-2 standard (2 letters, e.g., "US", "GB",
+         * "JP"). See: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
+         */
+        country?: string;
+    }
+}
+export interface AgentResearchParams {
+    /**
+     * The research query or question to answer
+     */
+    query: string;
+    /**
+     * Timeout in seconds for fetching web pages
+     */
+    fetch_timeout?: number;
+    /**
+     * Research mode: fast (quick answers), balanced (standard research, default)
+     */
+    mode?: 'fast' | 'balanced';
+    /**
+     * Skip cache and force fresh research
+     */
+    nocache?: boolean;
+}
 export declare namespace Agent {
-    export { type AutomateEvent as AutomateEvent, type AgentAutomateParams as AgentAutomateParams };
+    export { type AutomateEvent as AutomateEvent, type ResearchEvent as ResearchEvent, type AgentAutomateParams as AgentAutomateParams, type AgentResearchParams as AgentResearchParams, };
 }
 //# sourceMappingURL=agent.d.ts.map

package/resources/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/resources/agent.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,MAAM,EAAE;OAEV,EAAE,cAAc,EAAE;AAEzB,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,QAAQ,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;CAQjG;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EAAE,KAAK,aAAa,IAAI,aAAa,EAAE,KAAK,mBAAmB,IAAI,mBAAmB,EAAE,CAAC;CACjG"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/resources/agent.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,MAAM,EAAE;OAEV,EAAE,cAAc,EAAE;AAEzB,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,QAAQ,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAShG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,QAAQ,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;CAQjG;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;CACrD;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,UAAU,CAAC,EAAE,mBAAmB,CAAC,SAAS,CAAC;IAE3C;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,yBAAiB,mBAAmB,CAAC;IACnC;;OAEG;IACH,UAAiB,SAAS;QACxB;;;WAGG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}

package/resources/agent.js

@@ -6,14 +6,19 @@ const resource_1 = require("../core/resource.js");
 const headers_1 = require("../internal/headers.js");
 class Agent extends resource_1.APIResource {
     /**
-     * Execute AI-powered browser automation tasks using natural language. This
-     * endpoint **always streams** responses using Server-Sent Events (SSE).
+     * Execute AI-powered browser automation tasks using natural language with optional
+     * geotargeting. This endpoint **always streams** responses using Server-Sent
+     * Events (SSE).
      *
      * **Streaming Response:**
      *
      * - All responses are streamed using Server-Sent Events (`text/event-stream`)
      * - Real-time progress updates and results as they're generated
      *
+     * **Geotargeting:**
+     *
+     * - Optionally specify a country code for geotargeted browsing
+     *
      * **Use Cases:**
      *
      * - Web scraping and data extraction
@@ -40,6 +45,44 @@ class Agent extends resource_1.APIResource {
             stream: true,
         });
     }
+    /**
+     * Execute AI-powered research queries that search the web, analyze sources, and
+     * synthesize comprehensive answers. This endpoint **always streams** responses
+     * using Server-Sent Events (SSE).
+     *
+     * **Streaming Response:**
+     *
+     * - All responses are streamed using Server-Sent Events (`text/event-stream`)
+     * - Real-time progress updates as research progresses through phases
+     *
+     * **Research Modes:**
+     *
+     * - `fast` - Quick answers with minimal web searches
+     * - `balanced` - Standard research with multiple iterations (default)
+     *
+     * **Use Cases:**
+     *
+     * - Answering complex questions with cited sources
+     * - Synthesizing information from multiple web sources
+     * - Research reports on specific topics
+     * - Fact-checking and verification tasks
+     *
+     * @example
+     * ```ts
+     * const researchEvent = await client.agent.research({
+     *   query:
+     *     'What are the latest developments in quantum computing?',
+     * });
+     * ```
+     */
+    research(body, options) {
+        return this._client.post('/research', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: 'text/event-stream' }, options?.headers]),
+            stream: true,
+        });
+    }
 }
 exports.Agent = Agent;
 //# sourceMappingURL=agent.js.map

package/resources/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/resources/agent.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,oDAAmD;AAGnD,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,QAAQ,CAAC,IAAyB,EAAE,OAAwB;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE;YACpC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1E,MAAM,EAAE,IAAI;SACb,CAAsC,CAAC;IAC1C,CAAC;CACF;AApCD,sBAoCC"}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/resources/agent.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,oDAAmD;AAGnD,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,QAAQ,CAAC,IAAyB,EAAE,OAAwB;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE;YACpC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1E,MAAM,EAAE,IAAI;SACb,CAAsC,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,QAAQ,CAAC,IAAyB,EAAE,OAAwB;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE;YACpC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1E,MAAM,EAAE,IAAI;SACb,CAAsC,CAAC;IAC1C,CAAC;CACF;AAhFD,sBAgFC"}

package/resources/agent.mjs

@@ -3,14 +3,19 @@ import { APIResource } from "../core/resource.mjs";
 import { buildHeaders } from "../internal/headers.mjs";
 export class Agent extends APIResource {
     /**
-     * Execute AI-powered browser automation tasks using natural language. This
-     * endpoint **always streams** responses using Server-Sent Events (SSE).
+     * Execute AI-powered browser automation tasks using natural language with optional
+     * geotargeting. This endpoint **always streams** responses using Server-Sent
+     * Events (SSE).
      *
      * **Streaming Response:**
      *
      * - All responses are streamed using Server-Sent Events (`text/event-stream`)
      * - Real-time progress updates and results as they're generated
      *
+     * **Geotargeting:**
+     *
+     * - Optionally specify a country code for geotargeted browsing
+     *
      * **Use Cases:**
      *
      * - Web scraping and data extraction
@@ -37,5 +42,43 @@ export class Agent extends APIResource {
             stream: true,
         });
     }
+    /**
+     * Execute AI-powered research queries that search the web, analyze sources, and
+     * synthesize comprehensive answers. This endpoint **always streams** responses
+     * using Server-Sent Events (SSE).
+     *
+     * **Streaming Response:**
+     *
+     * - All responses are streamed using Server-Sent Events (`text/event-stream`)
+     * - Real-time progress updates as research progresses through phases
+     *
+     * **Research Modes:**
+     *
+     * - `fast` - Quick answers with minimal web searches
+     * - `balanced` - Standard research with multiple iterations (default)
+     *
+     * **Use Cases:**
+     *
+     * - Answering complex questions with cited sources
+     * - Synthesizing information from multiple web sources
+     * - Research reports on specific topics
+     * - Fact-checking and verification tasks
+     *
+     * @example
+     * ```ts
+     * const researchEvent = await client.agent.research({
+     *   query:
+     *     'What are the latest developments in quantum computing?',
+     * });
+     * ```
+     */
+    research(body, options) {
+        return this._client.post('/research', {
+            body,
+            ...options,
+            headers: buildHeaders([{ Accept: 'text/event-stream' }, options?.headers]),
+            stream: true,
+        });
+    }
 }
 //# sourceMappingURL=agent.mjs.map

package/resources/agent.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"agent.mjs","sourceRoot":"","sources":["../src/resources/agent.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,YAAY,EAAE;AAGvB,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,QAAQ,CAAC,IAAyB,EAAE,OAAwB;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE;YACpC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1E,MAAM,EAAE,IAAI;SACb,CAAsC,CAAC;IAC1C,CAAC;CACF"}
+{"version":3,"file":"agent.mjs","sourceRoot":"","sources":["../src/resources/agent.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,YAAY,EAAE;AAGvB,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,QAAQ,CAAC,IAAyB,EAAE,OAAwB;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE;YACpC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1E,MAAM,EAAE,IAAI;SACb,CAAsC,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,QAAQ,CAAC,IAAyB,EAAE,OAAwB;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE;YACpC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1E,MAAM,EAAE,IAAI;SACb,CAAsC,CAAC;IAC1C,CAAC;CACF"}

package/resources/extract.d.mts

@@ -8,7 +8,31 @@ export declare class Extract extends APIResource {
      * @example
      * ```ts
      * const response = await client.extract.json({
-     *   json_schema: {},
+     *   json_schema: {
+     *     properties: {
+     *       stories: {
+     *         items: {
+     *           properties: {
+     *             author: {
+     *               description: 'Author username',
+     *               type: 'string',
+     *             },
+     *             points: {
+     *               description: 'Story points',
+     *               type: 'number',
+     *             },
+     *             title: {
+     *               description: 'Story title',
+     *               type: 'string',
+     *             },
+     *           },
+     *           type: 'object',
+     *         },
+     *         type: 'array',
+     *       },
+     *     },
+     *     type: 'object',
+     *   },
      *   url: 'https://news.ycombinator.com',
      * });
      * ```
@@ -53,6 +77,14 @@ export declare namespace ExtractMarkdownResponse {
          * Author information from HTML metadata
          */
         author?: string;
+        /**
+         * Document creation date (ISO 8601)
+         */
+        created_at?: string;
+        /**
+         * Creator application (e.g., "Microsoft Word")
+         */
+        creator?: string;
         /**
          * Page description from Open Graph or HTML
          */
@@ -61,6 +93,26 @@ export declare namespace ExtractMarkdownResponse {
          * Featured image URL from Open Graph
          */
         image?: string;
+        /**
+         * PDF keywords as array
+         */
+        keywords?: Array<string>;
+        /**
+         * Document modification date (ISO 8601)
+         */
+        modified_at?: string;
+        /**
+         * Number of pages (PDF documents)
+         */
+        page_count?: number;
+        /**
+         * PDF version (e.g., "1.5")
+         */
+        pdf_version?: string;
+        /**
+         * PDF producer software (e.g., "Adobe PDF Library")
+         */
+        producer?: string;
         /**
          * Publisher information from Open Graph
          */
@@ -69,6 +121,11 @@ export declare namespace ExtractMarkdownResponse {
          * Site name from Open Graph
          */
         site_name?: string;
+        /**
+         * PDF-specific metadata fields (populated for PDF documents) PDF subject or
+         * summary
+         */
+        subject?: string;
         /**
          * Page title from Open Graph or HTML
          */
@@ -92,16 +149,36 @@ export interface ExtractJsonParams {
      * URL to fetch and extract data from
      */
     url: string;
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    geo_target?: ExtractJsonParams.GeoTarget;
     /**
      * Bypass cache and force fresh data retrieval
      */
     nocache?: boolean;
 }
+export declare namespace ExtractJsonParams {
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    interface GeoTarget {
+        /**
+         * Country code using ISO 3166-1 alpha-2 standard (2 letters, e.g., "US", "GB",
+         * "JP"). See: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
+         */
+        country?: string;
+    }
+}
 export interface ExtractMarkdownParams {
     /**
      * URL to fetch and convert to markdown
      */
     url: string;
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    geo_target?: ExtractMarkdownParams.GeoTarget;
     /**
      * Include extracted metadata (Open Graph and HTML metadata) as a separate field in
      * the response
@@ -112,6 +189,18 @@ export interface ExtractMarkdownParams {
      */
     nocache?: boolean;
 }
+export declare namespace ExtractMarkdownParams {
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    interface GeoTarget {
+        /**
+         * Country code using ISO 3166-1 alpha-2 standard (2 letters, e.g., "US", "GB",
+         * "JP"). See: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
+         */
+        country?: string;
+    }
+}
 export declare namespace Extract {
     export { type ExtractJsonResponse as ExtractJsonResponse, type ExtractMarkdownResponse as ExtractMarkdownResponse, type ExtractJsonParams as ExtractJsonParams, type ExtractMarkdownParams as ExtractMarkdownParams, };
 }

package/resources/extract.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"extract.d.mts","sourceRoot":"","sources":["../src/resources/extract.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;OAUG;IACH,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;IAIxF;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,IAAI,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,uBAAuB,CAAC;CAGrG;AAED,MAAM,MAAM,mBAAmB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE7D,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,QAAQ,CAAC,EAAE,uBAAuB,CAAC,QAAQ,CAAC;CAC7C;AAED,yBAAiB,uBAAuB,CAAC;IACvC;;OAEG;IACH,UAAiB,QAAQ;QACvB;;WAEG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;KACd;CACF;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,qBAAqB,IAAI,qBAAqB,GACpD,CAAC;CACH"}
+{"version":3,"file":"extract.d.mts","sourceRoot":"","sources":["../src/resources/extract.ts"],"names":[],"mappings":"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"}