parallel-web 1.0.1 → 1.2.0

package/src/resources/beta/findall.ts

@@ -231,8 +231,6 @@ export class FindAll extends APIResource {
   /**
    * Transforms a natural language search objective into a structured FindAll spec.
    *
-   * Note: Access to this endpoint requires the parallel-beta header.
-   *
    * The generated specification serves as a suggested starting point and can be
    * further customized by the user.
    *
@@ -548,10 +546,17 @@ export interface FindAllRunInput {
   objective: string;
 
   /**
-   * List of entity names/IDs to exclude from results.
+   * List of entity names/IDs to exclude from results. At most 10,000 entries are
+   * allowed.
    */
   exclude_list?: Array<FindAllRunInput.ExcludeList> | null;
 
+  /**
+   * User-provided key identifying the memory scope to use. Omit to use personal
+   * memory, if available.
+   */
+  memory_scope_key?: string | null;
+
   /**
    * Metadata for the FindAll run.
    */
@@ -799,10 +804,17 @@ export interface FindAllCreateParams {
   objective: string;
 
   /**
-   * Body param: List of entity names/IDs to exclude from results.
+   * Body param: List of entity names/IDs to exclude from results. At most 10,000
+   * entries are allowed.
    */
   exclude_list?: Array<FindAllCreateParams.ExcludeList> | null;
 
+  /**
+   * Body param: User-provided key identifying the memory scope to use. Omit to use
+   * personal memory, if available.
+   */
+  memory_scope_key?: string | null;
+
   /**
    * Body param: Metadata for the FindAll run.
    */

package/src/resources/beta/index.ts

@@ -32,3 +32,17 @@ export {
   type FindAllResultParams,
   type FindAllSchemaParams,
 } from './findall';
+export {
+  Memory,
+  type FindAllMemoryResult,
+  type MemoryClearRequest,
+  type MemoryEvictRequest,
+  type MemoryRetrieveRequest,
+  type MemoryRetrieveResponse,
+  type MonitorMemoryEvent,
+  type MonitorMemoryResult,
+  type TaskMemoryResult,
+  type MemoryRetrieveParams,
+  type MemoryClearParams,
+  type MemoryEvictParams,
+} from './memory';

package/src/resources/beta/memory.ts

@@ -0,0 +1,301 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+
+/**
+ * The Memory API retrieves and manages memories created by Tasks, Monitors, and FindAll runs. Memories can be personal or isolated with a `memory_scope_key`.
+ */
+export class Memory extends APIResource {
+  /**
+   * Retrieves relevant or recent runs from the selected memory. Provide a query to
+   * rank results by relevance; leave it empty to return the most recent runs.
+   *
+   * @example
+   * ```ts
+   * const memoryRetrieveResponse =
+   *   await client.beta.memory.retrieve();
+   * ```
+   */
+  retrieve(body: MemoryRetrieveParams, options?: RequestOptions): APIPromise<MemoryRetrieveResponse> {
+    return this._client.post('/v1beta/memory/retrieve', {
+      body,
+      ...options,
+      headers: buildHeaders([{ 'parallel-beta': 'search-extract-2025-10-10' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Clears all entries from the selected memory without deleting the underlying
+   * tasks, monitors, or FindAll runs.
+   *
+   * @example
+   * ```ts
+   * await client.beta.memory.clear();
+   * ```
+   */
+  clear(body: MemoryClearParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/v1beta/memory/clear', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { 'parallel-beta': 'search-extract-2025-10-10', Accept: '*/*' },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Removes a task run, monitor, or FindAll run from the selected memory without
+   * deleting the original resource.
+   *
+   * @example
+   * ```ts
+   * await client.beta.memory.evict({ id: 'id', kind: 'task' });
+   * ```
+   */
+  evict(body: MemoryEvictParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/v1beta/memory/evict', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { 'parallel-beta': 'search-extract-2025-10-10', Accept: '*/*' },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface FindAllMemoryResult {
+  /**
+   * ID of the FindAll run.
+   */
+  id: string;
+
+  /**
+   * Preview of the run's objective. May be truncated.
+   */
+  input_excerpt: string;
+
+  /**
+   * Current number of matched entities.
+   */
+  matched_count: number;
+
+  /**
+   * When the FindAll result was last updated, as an RFC 3339 timestamp.
+   */
+  updated_at: string;
+
+  kind?: 'findall';
+}
+
+export interface MemoryClearRequest {
+  /**
+   * User-provided key identifying the memory scope to use. Omit to use personal
+   * memory, if available.
+   */
+  memory_scope_key?: string | null;
+}
+
+export interface MemoryEvictRequest {
+  /**
+   * ID of the task run, monitor, or FindAll run to evict.
+   */
+  id: string;
+
+  /**
+   * Kind of source to evict: `task`, `monitor`, or `findall`.
+   */
+  kind: 'task' | 'monitor' | 'findall';
+
+  /**
+   * User-provided key identifying the memory scope to use. Omit to use personal
+   * memory, if available.
+   */
+  memory_scope_key?: string | null;
+}
+
+export interface MemoryRetrieveRequest {
+  /**
+   * Filter memories by kind: `task`, `monitor`, or `findall`.
+   */
+  kind?: 'task' | 'monitor' | 'findall' | null;
+
+  /**
+   * Maximum number of memories to return.
+   */
+  limit?: number;
+
+  /**
+   * User-provided key identifying the memory scope to use. Omit to use personal
+   * memory, if available.
+   */
+  memory_scope_key?: string | null;
+
+  /**
+   * Concise query describing the memories to retrieve. Empty queries return the most
+   * recent memories.
+   */
+  query?: string | null;
+
+  /**
+   * Only return memories sourced from task, monitor, or FindAll runs completed at or
+   * after this RFC 3339 timestamp.
+   */
+  since?: string | null;
+}
+
+export interface MemoryRetrieveResponse {
+  results: Array<TaskMemoryResult | MonitorMemoryResult | FindAllMemoryResult>;
+}
+
+export interface MonitorMemoryEvent {
+  /**
+   * When the event was detected, as an RFC 3339 timestamp.
+   */
+  detected_at: string;
+
+  /**
+   * ID of the execution that produced this event.
+   */
+  event_group_id: string;
+
+  /**
+   * ID of the monitor event.
+   */
+  event_id: string;
+
+  /**
+   * Excerpt of the monitor event. May be truncated.
+   */
+  excerpt: string;
+}
+
+export interface MonitorMemoryResult {
+  /**
+   * ID of the monitor.
+   */
+  id: string;
+
+  /**
+   * Preview of the monitor's query. May be truncated.
+   */
+  input_excerpt: string;
+
+  /**
+   * Current status of the monitor.
+   */
+  status: 'active' | 'cancelled';
+
+  /**
+   * When the monitor last ran, as an RFC 3339 timestamp.
+   */
+  updated_at: string;
+
+  kind?: 'monitor';
+
+  /**
+   * Detected events matching the retrieval query, ordered by relevance with more
+   * recent events favored. For an empty query, events are ordered by recency.
+   */
+  matched_events?: Array<MonitorMemoryEvent>;
+}
+
+export interface TaskMemoryResult {
+  /**
+   * ID of the task run.
+   */
+  id: string;
+
+  /**
+   * Preview of the run's input. May be truncated.
+   */
+  input_excerpt: string;
+
+  /**
+   * Preview of the run's output. May be truncated.
+   */
+  output_excerpt: string;
+
+  /**
+   * When the run completed, as an RFC 3339 timestamp.
+   */
+  updated_at: string;
+
+  kind?: 'task';
+}
+
+export interface MemoryRetrieveParams {
+  /**
+   * Filter memories by kind: `task`, `monitor`, or `findall`.
+   */
+  kind?: 'task' | 'monitor' | 'findall' | null;
+
+  /**
+   * Maximum number of memories to return.
+   */
+  limit?: number;
+
+  /**
+   * User-provided key identifying the memory scope to use. Omit to use personal
+   * memory, if available.
+   */
+  memory_scope_key?: string | null;
+
+  /**
+   * Concise query describing the memories to retrieve. Empty queries return the most
+   * recent memories.
+   */
+  query?: string | null;
+
+  /**
+   * Only return memories sourced from task, monitor, or FindAll runs completed at or
+   * after this RFC 3339 timestamp.
+   */
+  since?: string | null;
+}
+
+export interface MemoryClearParams {
+  /**
+   * User-provided key identifying the memory scope to use. Omit to use personal
+   * memory, if available.
+   */
+  memory_scope_key?: string | null;
+}
+
+export interface MemoryEvictParams {
+  /**
+   * ID of the task run, monitor, or FindAll run to evict.
+   */
+  id: string;
+
+  /**
+   * Kind of source to evict: `task`, `monitor`, or `findall`.
+   */
+  kind: 'task' | 'monitor' | 'findall';
+
+  /**
+   * User-provided key identifying the memory scope to use. Omit to use personal
+   * memory, if available.
+   */
+  memory_scope_key?: string | null;
+}
+
+export declare namespace Memory {
+  export {
+    type FindAllMemoryResult as FindAllMemoryResult,
+    type MemoryClearRequest as MemoryClearRequest,
+    type MemoryEvictRequest as MemoryEvictRequest,
+    type MemoryRetrieveRequest as MemoryRetrieveRequest,
+    type MemoryRetrieveResponse as MemoryRetrieveResponse,
+    type MonitorMemoryEvent as MonitorMemoryEvent,
+    type MonitorMemoryResult as MonitorMemoryResult,
+    type TaskMemoryResult as TaskMemoryResult,
+    type MemoryRetrieveParams as MemoryRetrieveParams,
+    type MemoryClearParams as MemoryClearParams,
+    type MemoryEvictParams as MemoryEvictParams,
+  };
+}

package/src/resources/monitor.ts

@@ -198,6 +198,12 @@ export interface CreateMonitorRequest {
    */
   type: 'event_stream' | 'snapshot';
 
+  /**
+   * User-provided key identifying the memory scope to use. Omit to use personal
+   * memory, if available.
+   */
+  memory_scope_key?: string | null;
+
   /**
    * User-provided metadata stored with the monitor and echoed back in webhook
    * notifications and GET responses, so you can map events to objects in your
@@ -563,6 +569,14 @@ export interface UpdateMonitorEventStreamSettings {
    * Advanced monitor configuration.
    */
   advanced_settings?: AdvancedMonitorSettings | null;
+
+  /**
+   * Updated search query for the monitor. Use this for minor updates to prompts and
+   * instructions only. Major changes to the query may lead to unexpected results in
+   * change detection, as the monitor compares new results with what was previously
+   * seen.
+   */
+  query?: string | null;
 }
 
 /**
@@ -571,8 +585,10 @@ export interface UpdateMonitorEventStreamSettings {
  * Only fields that are explicitly included in the request body are updated. Pass
  * `null` for `webhook` or `metadata` to clear those fields. To update
  * type-specific settings on an `event_stream` monitor, include `type` and
- * `settings`; pass `null` for `settings.advanced_settings` to clear it. At least
- * one non-`type` field must be provided.
+ * `settings`; pass `settings.query` to update the prompt, or `null` for
+ * `settings.advanced_settings` to clear it. If `settings` is provided, `type` is
+ * required to identify the settings shape. The request must still include at least
+ * one field to update; empty updates fail validation.
  */
 export interface UpdateMonitorRequest {
   /**
@@ -626,6 +642,12 @@ export interface MonitorCreateParams {
    */
   type: 'event_stream' | 'snapshot';
 
+  /**
+   * User-provided key identifying the memory scope to use. Omit to use personal
+   * memory, if available.
+   */
+  memory_scope_key?: string | null;
+
   /**
    * User-provided metadata stored with the monitor and echoed back in webhook
    * notifications and GET responses, so you can map events to objects in your

package/src/resources/task-run.ts

@@ -309,6 +309,12 @@ export interface RunInput {
    */
   mcp_servers?: Array<McpServer> | null;
 
+  /**
+   * User-provided key identifying the memory scope to use. Omit to use personal
+   * memory, if available.
+   */
+  memory_scope_key?: string | null;
+
   /**
    * User-provided metadata stored with the run. Keys and values must be strings with
    * a maximum length of 16 and 512 characters respectively.
@@ -695,6 +701,12 @@ export interface TaskRunCreateParams {
    */
   mcp_servers?: Array<McpServer> | null;
 
+  /**
+   * Body param: User-provided key identifying the memory scope to use. Omit to use
+   * personal memory, if available.
+   */
+  memory_scope_key?: string | null;
+
   /**
    * Body param: User-provided metadata stored with the run. Keys and values must be
    * strings with a maximum length of 16 and 512 characters respectively.

package/src/resources/top-level.ts

@@ -342,12 +342,13 @@ export interface SearchParams {
   max_chars_total?: number | null;
 
   /**
-   * Search mode preset: supported values are `basic` and `advanced`. Basic mode
-   * offers the lowest latency and works best with 2-3 high-quality search_queries.
-   * Advanced mode provides higher quality with more advanced retrieval and
-   * compression. Defaults to `advanced` when omitted.
+   * Search mode preset: supported values are `turbo`, `basic`, and `advanced`. Turbo
+   * mode is optimized for the fastest responses. Basic mode offers low latency and
+   * works best with 2-3 high-quality search_queries. Advanced mode provides higher
+   * quality with more advanced retrieval and compression. Defaults to `advanced`
+   * when omitted.
    */
-  mode?: 'basic' | 'advanced' | null;
+  mode?: 'turbo' | 'basic' | 'advanced' | null;
 
   /**
    * Natural-language description of the underlying question or goal driving the

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.0.1'; // x-release-please-version
+export const VERSION = '1.2.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.0.1";
+export declare const VERSION = "1.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 = '1.0.1'; // x-release-please-version
+exports.VERSION = '1.2.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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