@tabstack/sdk 2.0.0 → 2.2.0

package/src/resources/agent.ts

@@ -8,14 +8,19 @@ import { RequestOptions } from '../internal/request-options';
 
 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
@@ -42,6 +47,45 @@ export class Agent extends APIResource {
       stream: true,
     }) as 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>> {
+    return this._client.post('/research', {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: 'text/event-stream' }, options?.headers]),
+      stream: true,
+    }) as APIPromise<Stream<ResearchEvent>>;
+  }
 }
 
 export interface AutomateEvent {
@@ -56,6 +100,18 @@ 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
@@ -67,6 +123,11 @@ export interface AgentAutomateParams {
    */
   data?: unknown;
 
+  /**
+   * Optional geotargeting parameters for proxy requests
+   */
+  geo_target?: AgentAutomateParams.GeoTarget;
+
   /**
    * Safety constraints for execution
    */
@@ -88,6 +149,46 @@ export interface AgentAutomateParams {
   url?: string;
 }
 
+export namespace AgentAutomateParams {
+  /**
+   * Optional geotargeting parameters for proxy requests
+   */
+  export 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,
+  };
 }

package/src/resources/extract.ts

@@ -11,7 +11,31 @@ export 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',
    * });
    * ```
@@ -65,6 +89,16 @@ export namespace ExtractMarkdownResponse {
      */
     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
      */
@@ -75,6 +109,31 @@ export namespace ExtractMarkdownResponse {
      */
     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
      */
@@ -85,6 +144,12 @@ export namespace ExtractMarkdownResponse {
      */
     site_name?: string;
 
+    /**
+     * PDF-specific metadata fields (populated for PDF documents) PDF subject or
+     * summary
+     */
+    subject?: string;
+
     /**
      * Page title from Open Graph or HTML
      */
@@ -113,18 +178,41 @@ export interface ExtractJsonParams {
    */
   url: string;
 
+  /**
+   * Optional geotargeting parameters for proxy requests
+   */
+  geo_target?: ExtractJsonParams.GeoTarget;
+
   /**
    * Bypass cache and force fresh data retrieval
    */
   nocache?: boolean;
 }
 
+export namespace ExtractJsonParams {
+  /**
+   * Optional geotargeting parameters for proxy requests
+   */
+  export 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
@@ -137,6 +225,19 @@ export interface ExtractMarkdownParams {
   nocache?: boolean;
 }
 
+export namespace ExtractMarkdownParams {
+  /**
+   * Optional geotargeting parameters for proxy requests
+   */
+  export 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,

package/src/resources/generate.ts

@@ -14,7 +14,25 @@ export class Generate extends APIResource {
    * const response = await client.generate.json({
    *   instructions:
    *     "For each story, categorize it (tech/business/science/other) and write a one-sentence summary explaining what it's about in simple terms.",
-   *   json_schema: {},
+   *   json_schema: {
+   *     properties: {
+   *       summaries: {
+   *         items: {
+   *           properties: {
+   *             category: {
+   *               description: 'Story category (tech/business/science/etc)',
+   *               type: 'string',
+   *             },
+   *             summary: { description: 'One-sentence summary of the story', type: 'string' },
+   *             title: { description: 'Story title', type: 'string' },
+   *           },
+   *           type: 'object',
+   *         },
+   *         type: 'array',
+   *       },
+   *     },
+   *     type: 'object',
+   *   },
    *   url: 'https://news.ycombinator.com',
    * });
    * ```
@@ -42,12 +60,30 @@ export interface GenerateJsonParams {
    */
   url: string;
 
+  /**
+   * Optional geotargeting parameters for proxy requests
+   */
+  geo_target?: GenerateJsonParams.GeoTarget;
+
   /**
    * Bypass cache and force fresh data retrieval
    */
   nocache?: boolean;
 }
 
+export namespace GenerateJsonParams {
+  /**
+   * Optional geotargeting parameters for proxy requests
+   */
+  export 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 Generate {
   export { type GenerateJsonResponse as GenerateJsonResponse, type GenerateJsonParams as GenerateJsonParams };
 }

package/src/resources/index.ts

@@ -1,6 +1,12 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Agent, type AutomateEvent, type AgentAutomateParams } from './agent';
+export {
+  Agent,
+  type AutomateEvent,
+  type ResearchEvent,
+  type AgentAutomateParams,
+  type AgentResearchParams,
+} from './agent';
 export {
   Extract,
   type ExtractJsonResponse,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '2.0.0'; // x-release-please-version
+export const VERSION = '2.2.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "2.0.0";
+export declare const VERSION = "2.2.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "2.0.0";
+export declare const VERSION = "2.2.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '2.0.0'; // x-release-please-version
+exports.VERSION = '2.2.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '2.0.0'; // x-release-please-version
+export const VERSION = '2.2.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map