[jliounis]

Summary

Adds a new @effect/ai-perplexity package providing Effect bindings for the Perplexity Search API.

What's added

• PerplexityClient — HTTP client wrapper that handles authentication and error mapping (platform HttpClient errors → @effect/ai AiError).
• PerplexitySearch — service with a search(options) method that returns a typed SearchResponse (results: { title, url, snippet, date? }[]).
• Supports the documented Search API request fields: max_results, max_tokens_per_page, search_domain_filter, search_recency_filter, search_after_date_filter, search_before_date_filter.
• Validates that search_domain_filter does not mix allow- and deny-list entries (the API does not accept that), failing fast with AiError.MalformedInput if it does.
• API key is read from PERPLEXITY_API_KEY, falling back to PPLX_API_KEY, via Config.redacted. A custom URL can be supplied via PERPLEXITY_API_URL or programmatically.
• Includes a PerplexityConfig tag and withClientTransform helper, mirroring the pattern used by @effect/ai-anthropic.

Tests

10 unit tests in packages/ai/perplexity/test/PerplexitySearch.test.ts, all using a mocked HttpClient (HttpClient.make) so no network calls are made:

• request body construction (camelCase → snake_case mapping, optional fields)
• allowlist / denylist domain filter handling, including the mixed-mode rejection
• success decoding into SearchResponse
• non-2xx → AiError.HttpResponseError
• malformed JSON body → AiError.MalformedOutput
• header / URL / method assertions on the captured request

Run with:

pnpm --filter @effect/ai-perplexity test
pnpm --filter @effect/ai-perplexity check
pnpm --filter @effect/ai-perplexity build

All three pass locally.

Docs

• packages/ai/perplexity/README.md documents installation, authentication, basic usage, available options, and the domain-filter caveat.
• Includes a changeset (@effect/ai-perplexity minor) describing the addition.

References

• Search API reference: https://docs.perplexity.ai/api-reference/search-post
• Search quickstart: https://docs.perplexity.ai/docs/search/quickstart
• Domain filters: https://docs.perplexity.ai/docs/search/filters/domain-filter
• Date / recency filters: https://docs.perplexity.ai/docs/search/filters/date-time-filters

[changeset-bot]

🦋 Changeset detected

Latest commit: 078c05b

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@effect/ai-perplexity	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[jliounis]

Friendly bump — changeset is present, typecheck/lint/build are clean. Happy to address any feedback on the @effect/ai-perplexity package (modeled after @effect/ai-anthropic). Let me know if you'd like changes.

[IMax153]

Hi @jliounis - apologies but Effect v3 is on a feature freeze now that Effect v4 is in beta.

If you'd like to see this functionality added, please open up a PR against the (v4 repo)[https://github.com/Effect-TS/effect-smol].

[fubhy]

Closing per maintainer guidance above: Effect v3 is feature-frozen, and new integrations should target the v4 repo instead. Thanks for the contribution.