The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	Mar 10, 2026 2:47am

PR Summary

Medium Risk
Medium risk because it changes request/response shapes and parameter defaults for external Parallel AI calls, which could break existing workflows expecting the old fields or stringified outputs.

Overview
Updates the Parallel AI integration to match the latest API: parallel_search replaces the deprecated processor with mode, adds domain include/exclude source policy support, and adjusts result excerpt handling/defaults.

parallel_extract and parallel_deep_research are updated to relax/rename parameters, align processor tiers/defaults, and add stronger error handling plus safer nullable-field mapping. Tool/block outputs and TypeScript types now expose structured json outputs and new response fields (search_id, extract_id, publish_date, full_content), with docs and the block UI updated accordingly.

^{Written by Cursor Bugbot for commit 2df13b6. Configure here.}

Greptile Summary

This PR aligns the Parallel AI integration with the current API documentation, correcting processor tier values, replacing the deprecated processor param with a mode param on search, adding source_policy domain filtering to search, fixing the result polling URL, making extract fields optional, and surfacing previously missing response fields (search_id, extract_id, publish_date, full_content). The param-remapping logic is also correctly moved from config.tool (mutation) to config.params (return value), which is the right architectural approach.

Key changes:

• search.ts: processor → mode (one-shot/agentic/fast), max_chars_per_result wrapped inside excerpts object per new API shape, source_policy construction added, error handling + search_id output added.
• extract.ts: objective, excerpts, full_content made optional, extract_id and publish_date added to output, error handling added.
• deep_research.ts: Processor values corrected (pro/ultra/pro-fast/ultra-fast), default changed from base → pro, result parsing updated to read taskResult.status directly, error handling added.
• parallel.ts block: New advanced fields added for search (mode, domain filtering), processor dropdown updated, param remapping moved to config.params.
• types.ts: Interfaces extended with new fields; ParallelSearchResult.url/title and ParallelExtractResult.url remain typed as non-nullable string while the transform functions can produce null — a type inconsistency worth fixing.

Confidence Score: 4/5

• Safe to merge with minor type fixes recommended before downstream consumers rely on search/extract result types.
• The functional changes are well-reasoned and align with API docs. Error handling has been added throughout, and the param remapping refactor is clean. The main concern is a type inconsistency where url/title in ParallelSearchResult and url in ParallelExtractResult are declared as string but can be null at runtime — this could cause silent type errors in downstream code. The include_domains/exclude_domains unconditional undefined assignment and the search_queries input type declaration are minor style issues with no immediate runtime impact.
• apps/sim/tools/parallel/types.ts — nullable field types need to be corrected to match the actual runtime values produced by the transform functions.

Important Files Changed

Sequence Diagram

sequenceDiagram
    participant UI as Block UI (parallel.ts)
    participant BP as config.params()
    participant ST as parallel_search tool
    participant ET as parallel_extract tool
    participant DR as parallel_deep_research tool
    participant API as Parallel AI API

    UI->>BP: params (operation, search_mode, search_queries, search_include/exclude_domains, ...)
    BP-->>ST: {objective, search_queries[], mode, max_results, max_chars_per_result, include_domains, exclude_domains}
    ST->>API: POST /v1beta/search\n{objective, search_queries, mode,\n max_results, excerpts:{max_chars_per_result},\n source_policy:{include/exclude_domains}}
    API-->>ST: {search_id, results:[{url, title, publish_date, excerpts}]}
    ST-->>UI: {search_id, results[]}

    UI->>BP: params (operation=extract, extract_objective, urls, excerpts, full_content)
    BP-->>ET: {urls, objective, excerpts, full_content}
    ET->>API: POST /v1beta/extract\n{urls[], objective, excerpts, full_content}
    API-->>ET: {extract_id, results:[{url, title, publish_date, excerpts, full_content}]}
    ET-->>UI: {extract_id, results[]}

    UI->>BP: params (operation=deep_research, research_input, processor, include/exclude_domains)
    BP-->>DR: {input, processor, include_domains, exclude_domains}
    DR->>API: POST /v1/tasks/runs\n{input, processor, task_spec:{output_schema:auto}, source_policy}
    API-->>DR: {run_id, status}
    DR->>API: GET /v1/tasks/runs/{run_id}/result
    API-->>DR: {status, output:{content, basis}}
    DR-->>UI: {status, run_id, message, content, basis[]}

_{Last reviewed commit: 2df13b6}

@cursor review

@greptile

@greptile

@cursor review