parallel-web 0.4.1 → 1.0.0

package/resources/monitor.js

@@ -0,0 +1,140 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MonitorResource = void 0;
+const resource_1 = require("../core/resource.js");
+const headers_1 = require("../internal/headers.js");
+const path_1 = require("../internal/utils/path.js");
+/**
+ * The Monitor API watches the web for material changes on a fixed frequency. Each monitor runs once on creation and then on its configured schedule, emitting events when meaningful changes are detected.
+ * - `event_stream` monitors track a search query and emit an event for each new material change.
+ * - `snapshot` monitors track a specific task run's output and emit an event when the output changes.
+ *
+ * Results can be polled via the events endpoint or delivered via webhooks.
+ */
+class MonitorResource extends resource_1.APIResource {
+    /**
+     * Create a monitor.
+     *
+     * Monitors run on a fixed frequency to detect material changes in web content. Set
+     * `type=event_stream` to monitor a search query, or `type=snapshot` to monitor a
+     * specific task run's output. The monitor runs once immediately at creation, then
+     * continues on the configured schedule.
+     *
+     * @example
+     * ```ts
+     * const monitor = await client.monitor.create({
+     *   frequency: '1h',
+     *   settings: { query: 'Extract recent news about AI' },
+     *   type: 'event_stream',
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/v1/monitors', { body, ...options });
+    }
+    /**
+     * Retrieve a monitor.
+     *
+     * Retrieves a specific monitor by `monitor_id`. Returns the monitor configuration
+     * including status, frequency, query, and webhook settings.
+     *
+     * @example
+     * ```ts
+     * const monitor = await client.monitor.retrieve('monitor_id');
+     * ```
+     */
+    retrieve(monitorID, options) {
+        return this._client.get((0, path_1.path) `/v1/monitors/${monitorID}`, options);
+    }
+    /**
+     * Update a monitor.
+     *
+     * Only fields explicitly included in the request body are changed. Pass `null` for
+     * `webhook` or `metadata` to clear those fields. Pass `type` and `settings` to
+     * update type-specific settings on an `event_stream` monitor. At least one field
+     * must be provided. Cancelled monitors cannot be updated.
+     *
+     * @example
+     * ```ts
+     * const monitor = await client.monitor.update('monitor_id');
+     * ```
+     */
+    update(monitorID, body, options) {
+        return this._client.post((0, path_1.path) `/v1/monitors/${monitorID}/update`, { body, ...options });
+    }
+    /**
+     * List monitors ordered by creation time, newest first.
+     *
+     * Monitors are sorted by `created_at` descending. `limit` defaults to 100. Use
+     * `next_cursor` from the response and pass it as `cursor` to fetch the next page.
+     * Pagination ends when `next_cursor` is absent.
+     *
+     * By default only `active` monitors are returned. Pass `status=cancelled` or both
+     * values to include cancelled monitors.
+     *
+     * The legacy Monitor API (`/v1alpha/monitors` endpoints) is documented under the
+     * `Monitor (Alpha)` tag.
+     *
+     * @example
+     * ```ts
+     * const paginatedMonitorResponse =
+     *   await client.monitor.list();
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.get('/v1/monitors', { query, ...options });
+    }
+    /**
+     * Cancel a monitor.
+     *
+     * Permanently stops the monitor from running. Cancellation is irreversible —
+     * create a new monitor to resume monitoring. Cancelling an already-cancelled
+     * monitor is a no-op.
+     *
+     * @example
+     * ```ts
+     * const monitor = await client.monitor.cancel('monitor_id');
+     * ```
+     */
+    cancel(monitorID, options) {
+        return this._client.post((0, path_1.path) `/v1/monitors/${monitorID}/cancel`, options);
+    }
+    /**
+     * List events for a monitor, newest first.
+     *
+     * Pass `event_group_id` to narrow results to a single execution. Otherwise returns
+     * all executions newest-first; use `next_cursor` to paginate. Set
+     * `include_completions=true` to also include no-change executions.
+     *
+     * @example
+     * ```ts
+     * const paginatedMonitorEvents = await client.monitor.events(
+     *   'monitor_id',
+     * );
+     * ```
+     */
+    events(monitorID, query = {}, options) {
+        return this._client.get((0, path_1.path) `/v1/monitors/${monitorID}/events`, { query, ...options });
+    }
+    /**
+     * Trigger an immediate monitor run.
+     *
+     * Enqueues a one-off execution of the monitor outside its normal schedule. The
+     * monitor's regular schedule is not affected. An event is only emitted if the
+     * execution detects a material change. Cancelled monitors cannot be triggered.
+     *
+     * @example
+     * ```ts
+     * await client.monitor.trigger('monitor_id');
+     * ```
+     */
+    trigger(monitorID, options) {
+        return this._client.post((0, path_1.path) `/v1/monitors/${monitorID}/trigger`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.MonitorResource = MonitorResource;
+//# sourceMappingURL=monitor.js.map

package/resources/monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.js","sourceRoot":"","sources":["../src/resources/monitor.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,oDAAmD;AAEnD,oDAA8C;AAE9C;;;;;;GAMG;AACH,MAAa,eAAgB,SAAQ,sBAAW;IAC9C;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,gBAAgB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,SAAiB,EAAE,IAAyB,EAAE,OAAwB;QAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,gBAAgB,SAAS,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,IAAI,CACF,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,SAAiB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,gBAAgB,SAAS,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CACJ,SAAiB,EACjB,QAAgD,EAAE,EAClD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,gBAAgB,SAAS,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,SAAiB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,gBAAgB,SAAS,UAAU,EAAE;YAChE,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AAxID,0CAwIC"}

package/resources/monitor.mjs

@@ -0,0 +1,136 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { buildHeaders } from "../internal/headers.mjs";
+import { path } from "../internal/utils/path.mjs";
+/**
+ * The Monitor API watches the web for material changes on a fixed frequency. Each monitor runs once on creation and then on its configured schedule, emitting events when meaningful changes are detected.
+ * - `event_stream` monitors track a search query and emit an event for each new material change.
+ * - `snapshot` monitors track a specific task run's output and emit an event when the output changes.
+ *
+ * Results can be polled via the events endpoint or delivered via webhooks.
+ */
+export class MonitorResource extends APIResource {
+    /**
+     * Create a monitor.
+     *
+     * Monitors run on a fixed frequency to detect material changes in web content. Set
+     * `type=event_stream` to monitor a search query, or `type=snapshot` to monitor a
+     * specific task run's output. The monitor runs once immediately at creation, then
+     * continues on the configured schedule.
+     *
+     * @example
+     * ```ts
+     * const monitor = await client.monitor.create({
+     *   frequency: '1h',
+     *   settings: { query: 'Extract recent news about AI' },
+     *   type: 'event_stream',
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/v1/monitors', { body, ...options });
+    }
+    /**
+     * Retrieve a monitor.
+     *
+     * Retrieves a specific monitor by `monitor_id`. Returns the monitor configuration
+     * including status, frequency, query, and webhook settings.
+     *
+     * @example
+     * ```ts
+     * const monitor = await client.monitor.retrieve('monitor_id');
+     * ```
+     */
+    retrieve(monitorID, options) {
+        return this._client.get(path `/v1/monitors/${monitorID}`, options);
+    }
+    /**
+     * Update a monitor.
+     *
+     * Only fields explicitly included in the request body are changed. Pass `null` for
+     * `webhook` or `metadata` to clear those fields. Pass `type` and `settings` to
+     * update type-specific settings on an `event_stream` monitor. At least one field
+     * must be provided. Cancelled monitors cannot be updated.
+     *
+     * @example
+     * ```ts
+     * const monitor = await client.monitor.update('monitor_id');
+     * ```
+     */
+    update(monitorID, body, options) {
+        return this._client.post(path `/v1/monitors/${monitorID}/update`, { body, ...options });
+    }
+    /**
+     * List monitors ordered by creation time, newest first.
+     *
+     * Monitors are sorted by `created_at` descending. `limit` defaults to 100. Use
+     * `next_cursor` from the response and pass it as `cursor` to fetch the next page.
+     * Pagination ends when `next_cursor` is absent.
+     *
+     * By default only `active` monitors are returned. Pass `status=cancelled` or both
+     * values to include cancelled monitors.
+     *
+     * The legacy Monitor API (`/v1alpha/monitors` endpoints) is documented under the
+     * `Monitor (Alpha)` tag.
+     *
+     * @example
+     * ```ts
+     * const paginatedMonitorResponse =
+     *   await client.monitor.list();
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.get('/v1/monitors', { query, ...options });
+    }
+    /**
+     * Cancel a monitor.
+     *
+     * Permanently stops the monitor from running. Cancellation is irreversible —
+     * create a new monitor to resume monitoring. Cancelling an already-cancelled
+     * monitor is a no-op.
+     *
+     * @example
+     * ```ts
+     * const monitor = await client.monitor.cancel('monitor_id');
+     * ```
+     */
+    cancel(monitorID, options) {
+        return this._client.post(path `/v1/monitors/${monitorID}/cancel`, options);
+    }
+    /**
+     * List events for a monitor, newest first.
+     *
+     * Pass `event_group_id` to narrow results to a single execution. Otherwise returns
+     * all executions newest-first; use `next_cursor` to paginate. Set
+     * `include_completions=true` to also include no-change executions.
+     *
+     * @example
+     * ```ts
+     * const paginatedMonitorEvents = await client.monitor.events(
+     *   'monitor_id',
+     * );
+     * ```
+     */
+    events(monitorID, query = {}, options) {
+        return this._client.get(path `/v1/monitors/${monitorID}/events`, { query, ...options });
+    }
+    /**
+     * Trigger an immediate monitor run.
+     *
+     * Enqueues a one-off execution of the monitor outside its normal schedule. The
+     * monitor's regular schedule is not affected. An event is only emitted if the
+     * execution detects a material change. Cancelled monitors cannot be triggered.
+     *
+     * @example
+     * ```ts
+     * await client.monitor.trigger('monitor_id');
+     * ```
+     */
+    trigger(monitorID, options) {
+        return this._client.post(path `/v1/monitors/${monitorID}/trigger`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+//# sourceMappingURL=monitor.mjs.map

package/resources/monitor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.mjs","sourceRoot":"","sources":["../src/resources/monitor.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAI/C,OAAO,EAAE,YAAY,EAAE,gCAA4B;AAEnD,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C;;;;;;GAMG;AACH,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,gBAAgB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,SAAiB,EAAE,IAAyB,EAAE,OAAwB;QAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,gBAAgB,SAAS,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,IAAI,CACF,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,SAAiB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,gBAAgB,SAAS,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CACJ,SAAiB,EACjB,QAAgD,EAAE,EAClD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,gBAAgB,SAAS,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,SAAiB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,gBAAgB,SAAS,UAAU,EAAE;YAChE,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF"}

package/resources/{beta/task-group.d.mts → task-group.d.mts}

@@ -1,16 +1,15 @@
-import { APIResource } from "../../core/resource.mjs";
-import * as TaskGroupAPI from "./task-group.mjs";
-import * as TaskRunAPI from "../task-run.mjs";
-import * as BetaTaskRunAPI from "./task-run.mjs";
-import { APIPromise } from "../../core/api-promise.mjs";
-import { Stream } from "../../core/streaming.mjs";
-import { RequestOptions } from "../../internal/request-options.mjs";
+import { APIResource } from "../core/resource.mjs";
+import * as TaskRunAPI from "./task-run.mjs";
+import * as FindAllAPI from "./beta/findall.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { Stream } from "../core/streaming.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
 /**
  * The Task API executes web research and extraction tasks. Clients submit a natural-language objective with an optional input schema; the service plans retrieval, fetches relevant URLs, and returns outputs that conform to a provided or inferred JSON schema. Supports deep research style queries and can return rich structured JSON outputs. Processors trade-off between cost, latency, and quality. Each processor supports calibrated confidences.
  * - Output metadata: citations, excerpts, reasoning, and confidence per field
  *
  * Task Groups enable batch execution of many independent Task runs with group-level monitoring and failure handling.
- *  - Submit hundreds or thousands of Tasks as a single group
+ * - Submit hundreds or thousands of Tasks as a single group
  * - Observe group progress and receive results as they complete
  * - Real-time updates via Server-Sent Events (SSE)
  * - Add tasks to an existing group while it is running
@@ -19,39 +18,14 @@ import { RequestOptions } from "../../internal/request-options.mjs";
 export declare class TaskGroup extends APIResource {
     /**
      * Initiates a TaskGroup to group and track multiple runs.
-     *
-     * @example
-     * ```ts
-     * const taskGroup = await client.beta.taskGroup.create();
-     * ```
      */
     create(body: TaskGroupCreateParams, options?: RequestOptions): APIPromise<TaskGroup>;
     /**
      * Retrieves aggregated status across runs in a TaskGroup.
-     *
-     * @example
-     * ```ts
-     * const taskGroup = await client.beta.taskGroup.retrieve(
-     *   'taskgroup_id',
-     * );
-     * ```
      */
     retrieve(taskGroupID: string, options?: RequestOptions): APIPromise<TaskGroup>;
     /**
      * Initiates multiple task runs within a TaskGroup.
-     *
-     * @example
-     * ```ts
-     * const taskGroupRunResponse =
-     *   await client.beta.taskGroup.addRuns('taskgroup_id', {
-     *     inputs: [
-     *       {
-     *         input: 'What was the GDP of France in 2023?',
-     *         processor: 'base',
-     *       },
-     *     ],
-     *   });
-     * ```
      */
     addRuns(taskGroupID: string, params: TaskGroupAddRunsParams, options?: RequestOptions): APIPromise<TaskGroupRunResponse>;
     /**
@@ -59,13 +33,6 @@ export declare class TaskGroup extends APIResource {
      *
      * The connection will remain open for up to an hour as long as at least one run in
      * the group is still active.
-     *
-     * @example
-     * ```ts
-     * const response = await client.beta.taskGroup.events(
-     *   'taskgroup_id',
-     * );
-     * ```
      */
     events(taskGroupID: string, query?: TaskGroupEventsParams | undefined, options?: RequestOptions): APIPromise<Stream<TaskGroupEventsResponse>>;
     /**
@@ -79,15 +46,17 @@ export declare class TaskGroup extends APIResource {
      * specify the `last_event_id` parameter with the `event_id` of the last event in
      * the stream. The stream will resume from the next event after the
      * `last_event_id`.
-     *
-     * @example
-     * ```ts
-     * const response = await client.beta.taskGroup.getRuns(
-     *   'taskgroup_id',
-     * );
-     * ```
      */
     getRuns(taskGroupID: string, query?: TaskGroupGetRunsParams | undefined, options?: RequestOptions): APIPromise<Stream<TaskGroupGetRunsResponse>>;
+    /**
+     * Retrieves run status by run_id.
+     *
+     * This endpoint is equivalent to fetching run status directly using the
+     * `retrieve()` method or the `tasks/runs` GET endpoint.
+     *
+     * The run result is available from the `/result` endpoint.
+     */
+    retrieveRun(runID: string, params: TaskGroupRetrieveRunParams, options?: RequestOptions): APIPromise<TaskRunAPI.TaskRun>;
 }
 /**
  * Response object for a task group, including its status and metadata.
@@ -168,26 +137,24 @@ export interface TaskGroupStatus {
 /**
  * Event indicating an update to group status.
  */
-export type TaskGroupEventsResponse = TaskGroupEventsResponse.TaskGroupStatusEvent | TaskRunAPI.TaskRunEvent | TaskRunAPI.ErrorEvent;
-export declare namespace TaskGroupEventsResponse {
-    /**
-     * Event indicating an update to group status.
-     */
-    interface TaskGroupStatusEvent {
-        /**
-         * Cursor to resume the event stream.
-         */
-        event_id: string;
-        /**
-         * Task group status object.
-         */
-        status: TaskGroupAPI.TaskGroupStatus;
-        /**
-         * Event type; always 'task_group_status'.
-         */
-        type: 'task_group_status';
-    }
+export interface TaskGroupStatusEvent {
+    /**
+     * Cursor to resume the event stream.
+     */
+    event_id: string;
+    /**
+     * Task group status object.
+     */
+    status: TaskGroupStatus;
+    /**
+     * Event type; always 'task_group_status'.
+     */
+    type: 'task_group_status';
 }
+/**
+ * Event indicating an update to group status.
+ */
+export type TaskGroupEventsResponse = TaskGroupStatusEvent | TaskRunAPI.TaskRunEvent | TaskRunAPI.ErrorEvent;
 /**
  * Event when a task run transitions to a non-active status.
  *
@@ -225,7 +192,7 @@ export interface TaskGroupAddRunsParams {
     /**
      * Header param: Optional header to specify the beta version(s) to enable.
      */
-    betas?: Array<BetaTaskRunAPI.ParallelBeta>;
+    betas?: Array<FindAllAPI.ParallelBeta>;
 }
 export interface TaskGroupEventsParams {
     last_event_id?: string | null;
@@ -237,7 +204,10 @@ export interface TaskGroupGetRunsParams {
     last_event_id?: string | null;
     status?: 'queued' | 'action_required' | 'running' | 'completed' | 'failed' | 'cancelling' | 'cancelled' | null;
 }
+export interface TaskGroupRetrieveRunParams {
+    taskgroup_id: string;
+}
 export declare namespace TaskGroup {
-    export { type TaskGroup as TaskGroup, type TaskGroupRunResponse as TaskGroupRunResponse, type TaskGroupStatus as TaskGroupStatus, type TaskGroupEventsResponse as TaskGroupEventsResponse, type TaskGroupGetRunsResponse as TaskGroupGetRunsResponse, type TaskGroupCreateParams as TaskGroupCreateParams, type TaskGroupAddRunsParams as TaskGroupAddRunsParams, type TaskGroupEventsParams as TaskGroupEventsParams, type TaskGroupGetRunsParams as TaskGroupGetRunsParams, };
+    export { type TaskGroup as TaskGroup, type TaskGroupRunResponse as TaskGroupRunResponse, type TaskGroupStatus as TaskGroupStatus, type TaskGroupStatusEvent as TaskGroupStatusEvent, type TaskGroupEventsResponse as TaskGroupEventsResponse, type TaskGroupGetRunsResponse as TaskGroupGetRunsResponse, type TaskGroupCreateParams as TaskGroupCreateParams, type TaskGroupAddRunsParams as TaskGroupAddRunsParams, type TaskGroupEventsParams as TaskGroupEventsParams, type TaskGroupGetRunsParams as TaskGroupGetRunsParams, type TaskGroupRetrieveRunParams as TaskGroupRetrieveRunParams, };
 }
 //# sourceMappingURL=task-group.d.mts.map

package/resources/task-group.d.mts.map

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

package/resources/{beta/task-group.d.ts → task-group.d.ts}

@@ -1,16 +1,15 @@
-import { APIResource } from "../../core/resource.js";
-import * as TaskGroupAPI from "./task-group.js";
-import * as TaskRunAPI from "../task-run.js";
-import * as BetaTaskRunAPI from "./task-run.js";
-import { APIPromise } from "../../core/api-promise.js";
-import { Stream } from "../../core/streaming.js";
-import { RequestOptions } from "../../internal/request-options.js";
+import { APIResource } from "../core/resource.js";
+import * as TaskRunAPI from "./task-run.js";
+import * as FindAllAPI from "./beta/findall.js";
+import { APIPromise } from "../core/api-promise.js";
+import { Stream } from "../core/streaming.js";
+import { RequestOptions } from "../internal/request-options.js";
 /**
  * The Task API executes web research and extraction tasks. Clients submit a natural-language objective with an optional input schema; the service plans retrieval, fetches relevant URLs, and returns outputs that conform to a provided or inferred JSON schema. Supports deep research style queries and can return rich structured JSON outputs. Processors trade-off between cost, latency, and quality. Each processor supports calibrated confidences.
  * - Output metadata: citations, excerpts, reasoning, and confidence per field
  *
  * Task Groups enable batch execution of many independent Task runs with group-level monitoring and failure handling.
- *  - Submit hundreds or thousands of Tasks as a single group
+ * - Submit hundreds or thousands of Tasks as a single group
  * - Observe group progress and receive results as they complete
  * - Real-time updates via Server-Sent Events (SSE)
  * - Add tasks to an existing group while it is running
@@ -19,39 +18,14 @@ import { RequestOptions } from "../../internal/request-options.js";
 export declare class TaskGroup extends APIResource {
     /**
      * Initiates a TaskGroup to group and track multiple runs.
-     *
-     * @example
-     * ```ts
-     * const taskGroup = await client.beta.taskGroup.create();
-     * ```
      */
     create(body: TaskGroupCreateParams, options?: RequestOptions): APIPromise<TaskGroup>;
     /**
      * Retrieves aggregated status across runs in a TaskGroup.
-     *
-     * @example
-     * ```ts
-     * const taskGroup = await client.beta.taskGroup.retrieve(
-     *   'taskgroup_id',
-     * );
-     * ```
      */
     retrieve(taskGroupID: string, options?: RequestOptions): APIPromise<TaskGroup>;
     /**
      * Initiates multiple task runs within a TaskGroup.
-     *
-     * @example
-     * ```ts
-     * const taskGroupRunResponse =
-     *   await client.beta.taskGroup.addRuns('taskgroup_id', {
-     *     inputs: [
-     *       {
-     *         input: 'What was the GDP of France in 2023?',
-     *         processor: 'base',
-     *       },
-     *     ],
-     *   });
-     * ```
      */
     addRuns(taskGroupID: string, params: TaskGroupAddRunsParams, options?: RequestOptions): APIPromise<TaskGroupRunResponse>;
     /**
@@ -59,13 +33,6 @@ export declare class TaskGroup extends APIResource {
      *
      * The connection will remain open for up to an hour as long as at least one run in
      * the group is still active.
-     *
-     * @example
-     * ```ts
-     * const response = await client.beta.taskGroup.events(
-     *   'taskgroup_id',
-     * );
-     * ```
      */
     events(taskGroupID: string, query?: TaskGroupEventsParams | undefined, options?: RequestOptions): APIPromise<Stream<TaskGroupEventsResponse>>;
     /**
@@ -79,15 +46,17 @@ export declare class TaskGroup extends APIResource {
      * specify the `last_event_id` parameter with the `event_id` of the last event in
      * the stream. The stream will resume from the next event after the
      * `last_event_id`.
-     *
-     * @example
-     * ```ts
-     * const response = await client.beta.taskGroup.getRuns(
-     *   'taskgroup_id',
-     * );
-     * ```
      */
     getRuns(taskGroupID: string, query?: TaskGroupGetRunsParams | undefined, options?: RequestOptions): APIPromise<Stream<TaskGroupGetRunsResponse>>;
+    /**
+     * Retrieves run status by run_id.
+     *
+     * This endpoint is equivalent to fetching run status directly using the
+     * `retrieve()` method or the `tasks/runs` GET endpoint.
+     *
+     * The run result is available from the `/result` endpoint.
+     */
+    retrieveRun(runID: string, params: TaskGroupRetrieveRunParams, options?: RequestOptions): APIPromise<TaskRunAPI.TaskRun>;
 }
 /**
  * Response object for a task group, including its status and metadata.
@@ -168,26 +137,24 @@ export interface TaskGroupStatus {
 /**
  * Event indicating an update to group status.
  */
-export type TaskGroupEventsResponse = TaskGroupEventsResponse.TaskGroupStatusEvent | TaskRunAPI.TaskRunEvent | TaskRunAPI.ErrorEvent;
-export declare namespace TaskGroupEventsResponse {
-    /**
-     * Event indicating an update to group status.
-     */
-    interface TaskGroupStatusEvent {
-        /**
-         * Cursor to resume the event stream.
-         */
-        event_id: string;
-        /**
-         * Task group status object.
-         */
-        status: TaskGroupAPI.TaskGroupStatus;
-        /**
-         * Event type; always 'task_group_status'.
-         */
-        type: 'task_group_status';
-    }
+export interface TaskGroupStatusEvent {
+    /**
+     * Cursor to resume the event stream.
+     */
+    event_id: string;
+    /**
+     * Task group status object.
+     */
+    status: TaskGroupStatus;
+    /**
+     * Event type; always 'task_group_status'.
+     */
+    type: 'task_group_status';
 }
+/**
+ * Event indicating an update to group status.
+ */
+export type TaskGroupEventsResponse = TaskGroupStatusEvent | TaskRunAPI.TaskRunEvent | TaskRunAPI.ErrorEvent;
 /**
  * Event when a task run transitions to a non-active status.
  *
@@ -225,7 +192,7 @@ export interface TaskGroupAddRunsParams {
     /**
      * Header param: Optional header to specify the beta version(s) to enable.
      */
-    betas?: Array<BetaTaskRunAPI.ParallelBeta>;
+    betas?: Array<FindAllAPI.ParallelBeta>;
 }
 export interface TaskGroupEventsParams {
     last_event_id?: string | null;
@@ -237,7 +204,10 @@ export interface TaskGroupGetRunsParams {
     last_event_id?: string | null;
     status?: 'queued' | 'action_required' | 'running' | 'completed' | 'failed' | 'cancelling' | 'cancelled' | null;
 }
+export interface TaskGroupRetrieveRunParams {
+    taskgroup_id: string;
+}
 export declare namespace TaskGroup {
-    export { type TaskGroup as TaskGroup, type TaskGroupRunResponse as TaskGroupRunResponse, type TaskGroupStatus as TaskGroupStatus, type TaskGroupEventsResponse as TaskGroupEventsResponse, type TaskGroupGetRunsResponse as TaskGroupGetRunsResponse, type TaskGroupCreateParams as TaskGroupCreateParams, type TaskGroupAddRunsParams as TaskGroupAddRunsParams, type TaskGroupEventsParams as TaskGroupEventsParams, type TaskGroupGetRunsParams as TaskGroupGetRunsParams, };
+    export { type TaskGroup as TaskGroup, type TaskGroupRunResponse as TaskGroupRunResponse, type TaskGroupStatus as TaskGroupStatus, type TaskGroupStatusEvent as TaskGroupStatusEvent, type TaskGroupEventsResponse as TaskGroupEventsResponse, type TaskGroupGetRunsResponse as TaskGroupGetRunsResponse, type TaskGroupCreateParams as TaskGroupCreateParams, type TaskGroupAddRunsParams as TaskGroupAddRunsParams, type TaskGroupEventsParams as TaskGroupEventsParams, type TaskGroupGetRunsParams as TaskGroupGetRunsParams, type TaskGroupRetrieveRunParams as TaskGroupRetrieveRunParams, };
 }
 //# sourceMappingURL=task-group.d.ts.map

package/resources/task-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-group.d.ts","sourceRoot":"","sources":["../src/resources/task-group.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,KAAK,UAAU,sBAAmB;AACzC,OAAO,KAAK,UAAU,0BAAuB;AAC7C,OAAO,EAAE,UAAU,EAAE,+BAA4B;AACjD,OAAO,EAAE,MAAM,EAAE,6BAA0B;AAE3C,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAG7D;;;;;;;;;;GAUG;AACH,qBAAa,SAAU,SAAQ,WAAW;IACxC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC;IAIpF;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC;IAI9E;;OAEG;IACH,OAAO,CACL,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,oBAAoB,CAAC;IAanC;;;;;OAKG;IACH,MAAM,CACJ,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,qBAAqB,GAAG,SAAc,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAS9C;;;;;;;;;;;OAWG;IACH,OAAO,CACL,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,sBAAsB,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAS/C;;;;;;;OAOG;IACH,WAAW,CACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,0BAA0B,EAClC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC;CAIlC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,MAAM,EAAE,eAAe,CAAC;IAExB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CAChE;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;;;OAIG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEvB;;OAEG;IACH,MAAM,EAAE,eAAe,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;IACH,sBAAsB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,eAAe,CAAC;IAExB;;OAEG;IACH,IAAI,EAAE,mBAAmB,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,oBAAoB,GAAG,UAAU,CAAC,YAAY,GAAG,UAAU,CAAC,UAAU,CAAC;AAE7G;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,YAAY,GAAG,UAAU,CAAC,UAAU,CAAC;AAEvF,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CAChE;AAED,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEnC;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC;IAE/C;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,MAAM,CAAC,EACH,QAAQ,GACR,iBAAiB,GACjB,SAAS,GACT,WAAW,GACX,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,IAAI,CAAC;CACV;AAED,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,KAAK,SAAS,IAAI,SAAS,EAC3B,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,0BAA0B,IAAI,0BAA0B,GAC9D,CAAC;CACH"}