@tabstack/sdk 2.0.0 → 2.2.0

package/resources/extract.d.ts

@@ -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.ts.map

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

package/resources/extract.js

@@ -10,7 +10,31 @@ class Extract extends resource_1.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',
      * });
      * ```

package/resources/extract.js.map

@@ -1 +1 @@
-{"version":3,"file":"extract.js","sourceRoot":"","sources":["../src/resources/extract.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;;;;;;;;OAUG;IACH,IAAI,CAAC,IAAuB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,IAA2B,EAAE,OAAwB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;CACF;AA9BD,0BA8BC"}
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../src/resources/extract.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,IAAI,CAAC,IAAuB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,IAA2B,EAAE,OAAwB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;CACF;AAtDD,0BAsDC"}

package/resources/extract.mjs

@@ -7,7 +7,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',
      * });
      * ```

package/resources/extract.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"extract.mjs","sourceRoot":"","sources":["../src/resources/extract.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;OAUG;IACH,IAAI,CAAC,IAAuB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,IAA2B,EAAE,OAAwB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;CACF"}
+{"version":3,"file":"extract.mjs","sourceRoot":"","sources":["../src/resources/extract.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,IAAI,CAAC,IAAuB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,IAA2B,EAAE,OAAwB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;CACF"}

package/resources/generate.d.mts

@@ -11,7 +11,25 @@ export declare 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',
      * });
      * ```
@@ -34,11 +52,27 @@ export interface GenerateJsonParams {
      * URL to fetch content from
      */
     url: string;
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    geo_target?: GenerateJsonParams.GeoTarget;
     /**
      * Bypass cache and force fresh data retrieval
      */
     nocache?: boolean;
 }
+export declare namespace GenerateJsonParams {
+    /**
+     * 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 Generate {
     export { type GenerateJsonResponse as GenerateJsonResponse, type GenerateJsonParams as GenerateJsonParams };
 }

package/resources/generate.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.mts","sourceRoot":"","sources":["../src/resources/generate.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;CAG3F;AAED,MAAM,MAAM,oBAAoB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EAAE,KAAK,oBAAoB,IAAI,oBAAoB,EAAE,KAAK,kBAAkB,IAAI,kBAAkB,EAAE,CAAC;CAC7G"}
+{"version":3,"file":"generate.d.mts","sourceRoot":"","sources":["../src/resources/generate.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;CAG3F;AAED,MAAM,MAAM,oBAAoB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC;IAE1C;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,yBAAiB,kBAAkB,CAAC;IAClC;;OAEG;IACH,UAAiB,SAAS;QACxB;;;WAGG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CACF;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EAAE,KAAK,oBAAoB,IAAI,oBAAoB,EAAE,KAAK,kBAAkB,IAAI,kBAAkB,EAAE,CAAC;CAC7G"}

package/resources/generate.d.ts

@@ -11,7 +11,25 @@ export declare 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',
      * });
      * ```
@@ -34,11 +52,27 @@ export interface GenerateJsonParams {
      * URL to fetch content from
      */
     url: string;
+    /**
+     * Optional geotargeting parameters for proxy requests
+     */
+    geo_target?: GenerateJsonParams.GeoTarget;
     /**
      * Bypass cache and force fresh data retrieval
      */
     nocache?: boolean;
 }
+export declare namespace GenerateJsonParams {
+    /**
+     * 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 Generate {
     export { type GenerateJsonResponse as GenerateJsonResponse, type GenerateJsonParams as GenerateJsonParams };
 }

package/resources/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/resources/generate.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;CAG3F;AAED,MAAM,MAAM,oBAAoB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EAAE,KAAK,oBAAoB,IAAI,oBAAoB,EAAE,KAAK,kBAAkB,IAAI,kBAAkB,EAAE,CAAC;CAC7G"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/resources/generate.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;CAG3F;AAED,MAAM,MAAM,oBAAoB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC;IAE1C;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,yBAAiB,kBAAkB,CAAC;IAClC;;OAEG;IACH,UAAiB,SAAS;QACxB;;;WAGG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CACF;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EAAE,KAAK,oBAAoB,IAAI,oBAAoB,EAAE,KAAK,kBAAkB,IAAI,kBAAkB,EAAE,CAAC;CAC7G"}

package/resources/generate.js

@@ -13,7 +13,25 @@ class Generate extends resource_1.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',
      * });
      * ```

package/resources/generate.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/resources/generate.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,IAAwB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;CACF;AAlBD,4BAkBC"}
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/resources/generate.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,IAAI,CAAC,IAAwB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;CACF;AApCD,4BAoCC"}

package/resources/generate.mjs

@@ -10,7 +10,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',
      * });
      * ```

package/resources/generate.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"generate.mjs","sourceRoot":"","sources":["../src/resources/generate.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,IAAwB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;CACF"}
+{"version":3,"file":"generate.mjs","sourceRoot":"","sources":["../src/resources/generate.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,IAAI,CAAC,IAAwB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;CACF"}

package/resources/index.d.mts

@@ -1,4 +1,4 @@
-export { Agent, type AutomateEvent, type AgentAutomateParams } from "./agent.mjs";
+export { Agent, type AutomateEvent, type ResearchEvent, type AgentAutomateParams, type AgentResearchParams, } from "./agent.mjs";
 export { Extract, type ExtractJsonResponse, type ExtractMarkdownResponse, type ExtractJsonParams, type ExtractMarkdownParams, } from "./extract.mjs";
 export { Generate, type GenerateJsonResponse, type GenerateJsonParams } from "./generate.mjs";
 //# sourceMappingURL=index.d.mts.map

package/resources/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EAAE,KAAK,EAAE,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE;OACvD,EACL,OAAO,EACP,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B;OACM,EAAE,QAAQ,EAAE,KAAK,oBAAoB,EAAE,KAAK,kBAAkB,EAAE"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EACL,KAAK,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB;OACM,EACL,OAAO,EACP,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B;OACM,EAAE,QAAQ,EAAE,KAAK,oBAAoB,EAAE,KAAK,kBAAkB,EAAE"}

package/resources/index.d.ts

@@ -1,4 +1,4 @@
-export { Agent, type AutomateEvent, type AgentAutomateParams } from "./agent.js";
+export { Agent, type AutomateEvent, type ResearchEvent, type AgentAutomateParams, type AgentResearchParams, } from "./agent.js";
 export { Extract, type ExtractJsonResponse, type ExtractMarkdownResponse, type ExtractJsonParams, type ExtractMarkdownParams, } from "./extract.js";
 export { Generate, type GenerateJsonResponse, type GenerateJsonParams } from "./generate.js";
 //# sourceMappingURL=index.d.ts.map

package/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EAAE,KAAK,EAAE,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE;OACvD,EACL,OAAO,EACP,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B;OACM,EAAE,QAAQ,EAAE,KAAK,oBAAoB,EAAE,KAAK,kBAAkB,EAAE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EACL,KAAK,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB;OACM,EACL,OAAO,EACP,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B;OACM,EAAE,QAAQ,EAAE,KAAK,oBAAoB,EAAE,KAAK,kBAAkB,EAAE"}

package/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,oCAA8E;AAArE,8FAAA,KAAK,OAAA;AACd,wCAMmB;AALjB,kGAAA,OAAO,OAAA;AAMT,0CAA0F;AAAjF,oGAAA,QAAQ,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,oCAMiB;AALf,8FAAA,KAAK,OAAA;AAMP,wCAMmB;AALjB,kGAAA,OAAO,OAAA;AAMT,0CAA0F;AAAjF,oGAAA,QAAQ,OAAA"}

package/resources/index.mjs

@@ -1,5 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-export { Agent } from "./agent.mjs";
+export { Agent, } from "./agent.mjs";
 export { Extract, } from "./extract.mjs";
 export { Generate } from "./generate.mjs";
 //# sourceMappingURL=index.mjs.map

package/resources/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,KAAK,EAAgD;OACvD,EACL,OAAO,GAKR;OACM,EAAE,QAAQ,EAAsD"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,KAAK,GAKN;OACM,EACL,OAAO,GAKR;OACM,EAAE,QAAQ,EAAsD"}

package/src/client.ts

@@ -16,7 +16,13 @@ import * as Errors from './core/error';
 import * as Uploads from './core/uploads';
 import * as API from './resources/index';
 import { APIPromise } from './core/api-promise';
-import { Agent, AgentAutomateParams, AutomateEvent } from './resources/agent';
+import {
+  Agent,
+  AgentAutomateParams,
+  AgentResearchParams,
+  AutomateEvent,
+  ResearchEvent,
+} from './resources/agent';
 import {
   Extract,
   ExtractJsonParams,
@@ -456,7 +462,7 @@ export class Tabstack {
       loggerFor(this).info(`${responseInfo} - ${retryMessage}`);
 
       const errText = await response.text().catch((err: any) => castToError(err).message);
-      const errJSON = safeJSON(errText);
+      const errJSON = safeJSON(errText) as any;
       const errMessage = errJSON ? undefined : errText;
 
       loggerFor(this).debug(
@@ -497,9 +503,10 @@ export class Tabstack {
     controller: AbortController,
   ): Promise<Response> {
     const { signal, method, ...options } = init || {};
-    if (signal) signal.addEventListener('abort', () => controller.abort());
+    const abort = this._makeAbort(controller);
+    if (signal) signal.addEventListener('abort', abort, { once: true });
 
-    const timeout = setTimeout(() => controller.abort(), ms);
+    const timeout = setTimeout(abort, ms);
 
     const isReadableBody =
       ((globalThis as any).ReadableStream && options.body instanceof (globalThis as any).ReadableStream) ||
@@ -666,6 +673,12 @@ export class Tabstack {
     return headers.values;
   }
 
+  private _makeAbort(controller: AbortController) {
+    // note: we can't just inline this method inside `fetchWithTimeout()` because then the closure
+    //       would capture all request options, and cause a memory leak.
+    return () => controller.abort();
+  }
+
   private buildBody({ options: { body, headers: rawHeaders } }: { options: FinalRequestOptions }): {
     bodyHeaders: HeadersLike;
     body: BodyInit | undefined;
@@ -737,7 +750,9 @@ export declare namespace Tabstack {
   export {
     Agent as Agent,
     type AutomateEvent as AutomateEvent,
+    type ResearchEvent as ResearchEvent,
     type AgentAutomateParams as AgentAutomateParams,
+    type AgentResearchParams as AgentResearchParams,
   };
 
   export {

package/src/core/streaming.ts

@@ -46,7 +46,7 @@ export class Stream<Item> implements AsyncIterable<Item> {
       try {
         for await (const sse of _iterSSEMessages(response, controller)) {
           try {
-            yield JSON.parse(sse.data);
+            yield JSON.parse(sse.data) as Item;
           } catch (e) {
             logger.error(`Could not parse message into JSON:`, sse.data);
             logger.error(`From chunk:`, sse.raw);
@@ -102,7 +102,7 @@ export class Stream<Item> implements AsyncIterable<Item> {
       try {
         for await (const line of iterLines()) {
           if (done) continue;
-          if (line) yield JSON.parse(line);
+          if (line) yield JSON.parse(line) as Item;
         }
         done = true;
       } catch (e) {

package/src/internal/parse.ts

@@ -43,6 +43,12 @@ export async function defaultParseResponse<T>(client: Tabstack, props: APIRespon
     const mediaType = contentType?.split(';')[0]?.trim();
     const isJSON = mediaType?.includes('application/json') || mediaType?.endsWith('+json');
     if (isJSON) {
+      const contentLength = response.headers.get('content-length');
+      if (contentLength === '0') {
+        // if there is no content we can't do anything
+        return undefined as T;
+      }
+
       const json = await response.json();
       return json as T;
     }