@mastra/perplexity 0.0.0-observe-20260504181920

package/CHANGELOG.md

@@ -0,0 +1,48 @@
+# @mastra/perplexity
+
+## 0.0.0-observe-20260504181920
+
+### Patch Changes
+
+- Updated dependencies [[`6dcd65f`](https://github.com/mastra-ai/mastra/commit/6dcd65f2a34069e6dc43ba35f1d11119b9b40bef), [`86c0298`](https://github.com/mastra-ai/mastra/commit/86c0298e647306423c842f9d5ac827bd616bd13d), [`c05c9a1`](https://github.com/mastra-ai/mastra/commit/c05c9a13230988cef6d438a62f37760f31927bc7), [`ca28c23`](https://github.com/mastra-ai/mastra/commit/ca28c232a2f18801a6cf20fe053479237b4d4fb0), [`e24aacb`](https://github.com/mastra-ai/mastra/commit/e24aacba07bd66f5d95b636dc24016fca26b52cf), [`7fce309`](https://github.com/mastra-ai/mastra/commit/7fce30912b14170bfc41f0ac736cca0f39fe0cd4), [`1c2dda8`](https://github.com/mastra-ai/mastra/commit/1c2dda805fbfccc0abf55d4cb20cc34402dc3f0c), [`c721164`](https://github.com/mastra-ai/mastra/commit/c7211643f7ac861f83b19a3757cc921487fc9d75), [`1b55954`](https://github.com/mastra-ai/mastra/commit/1b559541c1e08a10e49d01ffc51a634dfc37a286), [`7997c2e`](https://github.com/mastra-ai/mastra/commit/7997c2e55ddd121562a4098cd8d2b89c68433bf1), [`5adc55e`](https://github.com/mastra-ai/mastra/commit/5adc55e63407be8ee977914957d68bcc2a075ceb), [`e97ccb9`](https://github.com/mastra-ai/mastra/commit/e97ccb900f8b7a390ce82c9f8eb8d6eb2c5e3777), [`c5daf48`](https://github.com/mastra-ai/mastra/commit/c5daf48556e98c46ae06caf00f92c249912007e9), [`70017d7`](https://github.com/mastra-ai/mastra/commit/70017d72ab741b5d7040e2a15c251a317782e39e), [`cd96779`](https://github.com/mastra-ai/mastra/commit/cd9677937f113b2856dc8b9f3d4bdabcee58bb2e), [`e4942bc`](https://github.com/mastra-ai/mastra/commit/e4942bc7fdc903572f7d84f26d5e15f9d39c763d)]:
+  - @mastra/core@0.0.0-observe-20260504181920
+
+## 0.1.0
+
+### Minor Changes
+
+- Added new `@mastra/perplexity` integration with the Perplexity Search tool for agents. ([#15939](https://github.com/mastra-ai/mastra/pull/15939))
+
+  ```ts
+  import { createPerplexityTools } from '@mastra/perplexity';
+
+  const { perplexitySearch } = createPerplexityTools({ apiKey: process.env.PERPLEXITY_API_KEY });
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`1723e09`](https://github.com/mastra-ai/mastra/commit/1723e099829892419ddbfe49287acfeac2522724), [`629f9e9`](https://github.com/mastra-ai/mastra/commit/629f9e9a7e56aa8f129515a3923c5813298790c7), [`25168fb`](https://github.com/mastra-ai/mastra/commit/25168fb9c1de9db7f8171df4f58ceb842c53aa29), [`ab34b5a`](https://github.com/mastra-ai/mastra/commit/ab34b5a2191b8e4353df1dbf7b9155e7d6628d79), [`5fb6c2a`](https://github.com/mastra-ai/mastra/commit/5fb6c2a95c1843cc231704b91354311fc1f34a71), [`2b0f355`](https://github.com/mastra-ai/mastra/commit/2b0f3553be3e9e5524da539a66e5cf82668440a4), [`394f0cf`](https://github.com/mastra-ai/mastra/commit/394f0cfc31e6b4d801219fdef2e9cc69e5bc8682), [`b2deb29`](https://github.com/mastra-ai/mastra/commit/b2deb29412b300c868655b5840463614fbb7962d), [`66644be`](https://github.com/mastra-ai/mastra/commit/66644beac1aa560f0e417956ff007c89341dc382), [`e109607`](https://github.com/mastra-ai/mastra/commit/e10960749251e34d46b480a20648c490fd30381b), [`310b953`](https://github.com/mastra-ai/mastra/commit/310b95345f302dcd5ba3ed862bdc96f059d44122), [`3d7f709`](https://github.com/mastra-ai/mastra/commit/3d7f709b615e588050bb6283c4ee5cfe2978cbde), [`48a42f1`](https://github.com/mastra-ai/mastra/commit/48a42f114a4006a95e0b7a1b5ad1a24815a175c2), [`8091c7c`](https://github.com/mastra-ai/mastra/commit/8091c7c944d15e13fef6d61b6cfd903f158d4006), [`2c83efc`](https://github.com/mastra-ai/mastra/commit/2c83efc4482b3efe50830e3b8b4ba9a8d219edff), [`43f0e1d`](https://github.com/mastra-ai/mastra/commit/43f0e1d5d5a74ba6fc746f2ad89ebe0c64777a7d), [`da0b9e2`](https://github.com/mastra-ai/mastra/commit/da0b9e2ba7ecc560213b426d6c097fe63946086e), [`282a10c`](https://github.com/mastra-ai/mastra/commit/282a10c9446e9922afe80e10e3770481c8ac8a28), [`04151c7`](https://github.com/mastra-ai/mastra/commit/04151c7dcea934b4fe9076708a23fac161195414), [`8091c7c`](https://github.com/mastra-ai/mastra/commit/8091c7c944d15e13fef6d61b6cfd903f158d4006)]:
+  - @mastra/core@1.31.0
+
+## 0.1.0-alpha.1
+
+### Minor Changes
+
+- Added new `@mastra/perplexity` integration with the Perplexity Search tool for agents. ([#15939](https://github.com/mastra-ai/mastra/pull/15939))
+
+  ```ts
+  import { createPerplexityTools } from '@mastra/perplexity';
+
+  const { perplexitySearch } = createPerplexityTools({ apiKey: process.env.PERPLEXITY_API_KEY });
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`2b0f355`](https://github.com/mastra-ai/mastra/commit/2b0f3553be3e9e5524da539a66e5cf82668440a4)]:
+  - @mastra/core@1.31.0-alpha.2
+
+## 0.1.0-alpha.0
+
+### Minor Changes
+
+- Initial release. Adds `createPerplexitySearchTool` and `createPerplexityTools` for the [Perplexity Search API](https://docs.perplexity.ai/docs/search/quickstart).

package/LICENSE.md

@@ -0,0 +1,30 @@
+Portions of this software are licensed as follows:
+
+- All content that resides under any directory named "ee/" within this
+  repository, including but not limited to:
+  - `packages/core/src/auth/ee/`
+  - `packages/server/src/server/auth/ee/`
+    is licensed under the license defined in `ee/LICENSE`.
+
+- All third-party components incorporated into the Mastra Software are
+  licensed under the original license provided by the owner of the
+  applicable component.
+
+- Content outside of the above-mentioned directories or restrictions is
+  available under the "Apache License 2.0" as defined below.
+
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,79 @@
+# @mastra/perplexity
+
+Web search tool for [Mastra](https://mastra.ai) agents, backed by the [Perplexity Search API](https://docs.perplexity.ai/docs/search/quickstart).
+
+## Installation
+
+```bash
+npm install @mastra/perplexity zod
+```
+
+## Quick Start
+
+```typescript
+import { Agent } from '@mastra/core/agent';
+import { createPerplexitySearchTool } from '@mastra/perplexity';
+
+const agent = new Agent({
+  id: 'research-agent',
+  name: 'Research Agent',
+  model: 'anthropic/claude-sonnet-4-6',
+  instructions:
+    'You are a research assistant. Use the perplexity-search tool to find up-to-date information from the web before answering.',
+  tools: {
+    search: createPerplexitySearchTool(),
+  },
+});
+```
+
+The tool reads `PERPLEXITY_API_KEY` (or `PPLX_API_KEY` as a fallback) from the environment. Pass `{ apiKey }` explicitly to override.
+
+## Filtering
+
+The Search API supports filtering by domain and date. All filters are optional.
+
+```typescript
+const tool = createPerplexitySearchTool();
+
+await tool.execute!({
+  query: 'recent papers on agent evaluation',
+  maxResults: 10,
+  searchRecencyFilter: 'month',
+  searchDomainFilter: ['arxiv.org', 'openreview.net'],
+}, {} as any);
+```
+
+To exclude domains, prefix them with `-`. Don't mix allow- and deny-list entries in the same call.
+
+```typescript
+searchDomainFilter: ['-pinterest.com', '-quora.com'];
+```
+
+## Using Perplexity as a Model Provider
+
+Perplexity is also a first-class model provider in Mastra's model router. To chat with Perplexity models (separate from this search tool), set `PERPLEXITY_API_KEY` and reference the model directly:
+
+```typescript
+import { Agent } from '@mastra/core/agent';
+
+const agent = new Agent({
+  id: 'agent-api',
+  name: 'Perplexity Agent',
+  model: 'perplexity-agent/openai/gpt-5',
+  instructions: 'You are a research assistant powered by the Perplexity Agent API.',
+});
+```
+
+See the [Perplexity provider docs](https://mastra.ai/models/providers/perplexity) and [Perplexity Agent provider docs](https://mastra.ai/models/providers/perplexity-agent).
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `apiKey` | `string` | `PERPLEXITY_API_KEY` → `PPLX_API_KEY` | Perplexity API key. |
+| `baseUrl` | `string` | `https://api.perplexity.ai` | Override the API base URL (useful for proxies and tests). |
+| `fetch` | `typeof fetch` | global `fetch` | Inject a custom `fetch` implementation. |
+
+## License
+
+Apache-2.0

package/dist/client.d.ts

@@ -0,0 +1,38 @@
+export declare const DEFAULT_BASE_URL = "https://api.perplexity.ai";
+export type PerplexityClientOptions = {
+    /**
+     * Perplexity API key. Falls back to `PERPLEXITY_API_KEY` then `PPLX_API_KEY`
+     * environment variables when not provided.
+     */
+    apiKey?: string;
+    /**
+     * Override the API base URL. Defaults to `https://api.perplexity.ai`.
+     */
+    baseUrl?: string;
+    /**
+     * Optional `fetch` implementation. Useful for tests, retries, or instrumentation.
+     * Defaults to the global `fetch`.
+     */
+    fetch?: typeof fetch;
+};
+export type PerplexitySearchResultItem = {
+    title: string;
+    url: string;
+    snippet: string;
+    date?: string;
+};
+export type PerplexitySearchResponse = {
+    id?: string;
+    results: PerplexitySearchResultItem[];
+};
+export type PerplexitySearchRequest = {
+    query: string;
+    max_results?: number;
+    max_tokens_per_page?: number;
+    search_domain_filter?: string[];
+    search_recency_filter?: 'hour' | 'day' | 'week' | 'month' | 'year';
+    search_after_date_filter?: string;
+    search_before_date_filter?: string;
+};
+export declare function perplexitySearchRequest(body: PerplexitySearchRequest, options?: PerplexityClientOptions): Promise<PerplexitySearchResponse>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,8BAA8B,CAAC;AAE5D,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,0BAA0B,EAAE,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,qBAAqB,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACnE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAYF,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,uBAAuB,EAC7B,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,wBAAwB,CAAC,CA6BnC"}

package/dist/index.cjs

@@ -0,0 +1,115 @@
+'use strict';
+
+var tools = require('@mastra/core/tools');
+var zod = require('zod');
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.perplexity.ai";
+function resolveApiKey(explicit) {
+  const key = explicit ?? process.env.PERPLEXITY_API_KEY ?? process.env.PPLX_API_KEY;
+  if (!key) {
+    throw new Error(
+      "Perplexity API key is required. Pass { apiKey } or set the PERPLEXITY_API_KEY (or PPLX_API_KEY) environment variable."
+    );
+  }
+  return key;
+}
+async function perplexitySearchRequest(body, options) {
+  const apiKey = resolveApiKey(options?.apiKey);
+  const baseUrl = options?.baseUrl ?? DEFAULT_BASE_URL;
+  const fetchImpl = options?.fetch ?? fetch;
+  const response = await fetchImpl(`${baseUrl.replace(/\/$/, "")}/search`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${apiKey}`
+    },
+    body: JSON.stringify(body)
+  });
+  if (!response.ok) {
+    const rawText = await response.text().catch(() => "");
+    const MAX_ERROR_BODY = 1e3;
+    const text = rawText.length > MAX_ERROR_BODY ? `${rawText.slice(0, MAX_ERROR_BODY)}\u2026` : rawText;
+    throw new Error(
+      `Perplexity Search request failed with status ${response.status}${text ? `: ${text}` : ""}`
+    );
+  }
+  const json = await response.json();
+  return {
+    id: json.id,
+    results: Array.isArray(json.results) ? json.results : []
+  };
+}
+var inputSchema = zod.z.object({
+  query: zod.z.string().describe("The search query."),
+  maxResults: zod.z.number().int().min(1).max(20).optional().describe("Maximum number of results to return (1-20). Defaults to the API default."),
+  searchDomainFilter: zod.z.array(zod.z.string()).optional().refine(
+    (domains) => {
+      if (!domains || domains.length === 0) return true;
+      const hasAllow = domains.some((d) => !d.startsWith("-"));
+      const hasDeny = domains.some((d) => d.startsWith("-"));
+      return !(hasAllow && hasDeny);
+    },
+    { message: "searchDomainFilter cannot mix allow and deny domain entries in the same call." }
+  ).describe(
+    "Restrict (or exclude) results by domain. Prefix a domain with `-` to exclude it (e.g. `-pinterest.com`). Do not mix allow and deny entries in the same call."
+  ),
+  searchRecencyFilter: zod.z.enum(["hour", "day", "week", "month", "year"]).optional().describe("Only return results from within the given recency window."),
+  searchAfterDateFilter: zod.z.string().optional().describe("Only return results published on or after this date. Format: m/d/yyyy (e.g. 1/1/2025)."),
+  searchBeforeDateFilter: zod.z.string().optional().describe("Only return results published on or before this date. Format: m/d/yyyy (e.g. 12/31/2025).")
+});
+var outputSchema = zod.z.object({
+  query: zod.z.string(),
+  results: zod.z.array(
+    zod.z.object({
+      title: zod.z.string(),
+      url: zod.z.string(),
+      snippet: zod.z.string(),
+      date: zod.z.string().optional()
+    })
+  )
+});
+function createPerplexitySearchTool(config) {
+  return tools.createTool({
+    id: "perplexity-search",
+    description: "Search the web for up-to-date information using the Perplexity Search API. Returns ranked results with titles, URLs, snippets, and optional publication dates. Supports filtering by domain, recency, and date range.",
+    inputSchema,
+    outputSchema,
+    execute: async (input) => {
+      const response = await perplexitySearchRequest(
+        {
+          query: input.query,
+          max_results: input.maxResults,
+          search_domain_filter: input.searchDomainFilter,
+          search_recency_filter: input.searchRecencyFilter,
+          search_after_date_filter: input.searchAfterDateFilter,
+          search_before_date_filter: input.searchBeforeDateFilter
+        },
+        config
+      );
+      return {
+        query: input.query,
+        results: response.results.map((r) => ({
+          title: r.title,
+          url: r.url,
+          snippet: r.snippet,
+          date: r.date
+        }))
+      };
+    }
+  });
+}
+
+// src/tools.ts
+function createPerplexityTools(config) {
+  return {
+    perplexitySearch: createPerplexitySearchTool(config)
+  };
+}
+
+exports.DEFAULT_BASE_URL = DEFAULT_BASE_URL;
+exports.createPerplexitySearchTool = createPerplexitySearchTool;
+exports.createPerplexityTools = createPerplexityTools;
+exports.perplexitySearchRequest = perplexitySearchRequest;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/search.ts","../src/tools.ts"],"names":["z","createTool"],"mappings":"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","file":"index.cjs","sourcesContent":["export const DEFAULT_BASE_URL = 'https://api.perplexity.ai';\n\nexport type PerplexityClientOptions = {\n  /**\n   * Perplexity API key. Falls back to `PERPLEXITY_API_KEY` then `PPLX_API_KEY`\n   * environment variables when not provided.\n   */\n  apiKey?: string;\n  /**\n   * Override the API base URL. Defaults to `https://api.perplexity.ai`.\n   */\n  baseUrl?: string;\n  /**\n   * Optional `fetch` implementation. Useful for tests, retries, or instrumentation.\n   * Defaults to the global `fetch`.\n   */\n  fetch?: typeof fetch;\n};\n\nexport type PerplexitySearchResultItem = {\n  title: string;\n  url: string;\n  snippet: string;\n  date?: string;\n};\n\nexport type PerplexitySearchResponse = {\n  id?: string;\n  results: PerplexitySearchResultItem[];\n};\n\nexport type PerplexitySearchRequest = {\n  query: string;\n  max_results?: number;\n  max_tokens_per_page?: number;\n  search_domain_filter?: string[];\n  search_recency_filter?: 'hour' | 'day' | 'week' | 'month' | 'year';\n  search_after_date_filter?: string;\n  search_before_date_filter?: string;\n};\n\nfunction resolveApiKey(explicit?: string): string {\n  const key = explicit ?? process.env.PERPLEXITY_API_KEY ?? process.env.PPLX_API_KEY;\n  if (!key) {\n    throw new Error(\n      'Perplexity API key is required. Pass { apiKey } or set the PERPLEXITY_API_KEY (or PPLX_API_KEY) environment variable.',\n    );\n  }\n  return key;\n}\n\nexport async function perplexitySearchRequest(\n  body: PerplexitySearchRequest,\n  options?: PerplexityClientOptions,\n): Promise<PerplexitySearchResponse> {\n  const apiKey = resolveApiKey(options?.apiKey);\n  const baseUrl = options?.baseUrl ?? DEFAULT_BASE_URL;\n  const fetchImpl = options?.fetch ?? fetch;\n\n  const response = await fetchImpl(`${baseUrl.replace(/\\/$/, '')}/search`, {\n    method: 'POST',\n    headers: {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${apiKey}`,\n    },\n    body: JSON.stringify(body),\n  });\n\n  if (!response.ok) {\n    const rawText = await response.text().catch(() => '');\n    const MAX_ERROR_BODY = 1000;\n    const text =\n      rawText.length > MAX_ERROR_BODY ? `${rawText.slice(0, MAX_ERROR_BODY)}…` : rawText;\n    throw new Error(\n      `Perplexity Search request failed with status ${response.status}${text ? `: ${text}` : ''}`,\n    );\n  }\n\n  const json = (await response.json()) as Partial<PerplexitySearchResponse>;\n  return {\n    id: json.id,\n    results: Array.isArray(json.results) ? json.results : [],\n  };\n}\n","import { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport { perplexitySearchRequest } from './client.js';\nimport type { PerplexityClientOptions } from './client.js';\n\nconst inputSchema = z.object({\n  query: z.string().describe('The search query.'),\n  maxResults: z\n    .number()\n    .int()\n    .min(1)\n    .max(20)\n    .optional()\n    .describe('Maximum number of results to return (1-20). Defaults to the API default.'),\n  searchDomainFilter: z\n    .array(z.string())\n    .optional()\n    .refine(\n      domains => {\n        if (!domains || domains.length === 0) return true;\n        const hasAllow = domains.some(d => !d.startsWith('-'));\n        const hasDeny = domains.some(d => d.startsWith('-'));\n        return !(hasAllow && hasDeny);\n      },\n      { message: 'searchDomainFilter cannot mix allow and deny domain entries in the same call.' },\n    )\n    .describe(\n      'Restrict (or exclude) results by domain. Prefix a domain with `-` to exclude it (e.g. `-pinterest.com`). Do not mix allow and deny entries in the same call.',\n    ),\n  searchRecencyFilter: z\n    .enum(['hour', 'day', 'week', 'month', 'year'])\n    .optional()\n    .describe('Only return results from within the given recency window.'),\n  searchAfterDateFilter: z\n    .string()\n    .optional()\n    .describe('Only return results published on or after this date. Format: m/d/yyyy (e.g. 1/1/2025).'),\n  searchBeforeDateFilter: z\n    .string()\n    .optional()\n    .describe('Only return results published on or before this date. Format: m/d/yyyy (e.g. 12/31/2025).'),\n});\n\nconst outputSchema = z.object({\n  query: z.string(),\n  results: z.array(\n    z.object({\n      title: z.string(),\n      url: z.string(),\n      snippet: z.string(),\n      date: z.string().optional(),\n    }),\n  ),\n});\n\n/**\n * Creates a tool that searches the web using the Perplexity Search API.\n *\n * Returns ranked web results with titles, URLs, snippets, and optional\n * publication dates. Supports filtering by domain (allow- or deny-list),\n * recency, and explicit date ranges.\n *\n * @see https://docs.perplexity.ai/docs/search/quickstart\n */\nexport function createPerplexitySearchTool(config?: PerplexityClientOptions) {\n  return createTool({\n    id: 'perplexity-search',\n    description:\n      'Search the web for up-to-date information using the Perplexity Search API. Returns ranked results with titles, URLs, snippets, and optional publication dates. Supports filtering by domain, recency, and date range.',\n    inputSchema,\n    outputSchema,\n    execute: async input => {\n      const response = await perplexitySearchRequest(\n        {\n          query: input.query,\n          max_results: input.maxResults,\n          search_domain_filter: input.searchDomainFilter,\n          search_recency_filter: input.searchRecencyFilter,\n          search_after_date_filter: input.searchAfterDateFilter,\n          search_before_date_filter: input.searchBeforeDateFilter,\n        },\n        config,\n      );\n\n      return {\n        query: input.query,\n        results: response.results.map(r => ({\n          title: r.title,\n          url: r.url,\n          snippet: r.snippet,\n          date: r.date,\n        })),\n      };\n    },\n  });\n}\n","import type { PerplexityClientOptions } from './client.js';\nimport { createPerplexitySearchTool } from './search.js';\n\nexport function createPerplexityTools(config?: PerplexityClientOptions) {\n  return {\n    perplexitySearch: createPerplexitySearchTool(config),\n  };\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { perplexitySearchRequest, DEFAULT_BASE_URL, type PerplexityClientOptions, type PerplexitySearchRequest, type PerplexitySearchResponse, type PerplexitySearchResultItem, } from './client.js';
+export { createPerplexitySearchTool } from './search.js';
+export { createPerplexityTools } from './tools.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,GAChC,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,110 @@
+import { createTool } from '@mastra/core/tools';
+import { z } from 'zod';
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.perplexity.ai";
+function resolveApiKey(explicit) {
+  const key = explicit ?? process.env.PERPLEXITY_API_KEY ?? process.env.PPLX_API_KEY;
+  if (!key) {
+    throw new Error(
+      "Perplexity API key is required. Pass { apiKey } or set the PERPLEXITY_API_KEY (or PPLX_API_KEY) environment variable."
+    );
+  }
+  return key;
+}
+async function perplexitySearchRequest(body, options) {
+  const apiKey = resolveApiKey(options?.apiKey);
+  const baseUrl = options?.baseUrl ?? DEFAULT_BASE_URL;
+  const fetchImpl = options?.fetch ?? fetch;
+  const response = await fetchImpl(`${baseUrl.replace(/\/$/, "")}/search`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${apiKey}`
+    },
+    body: JSON.stringify(body)
+  });
+  if (!response.ok) {
+    const rawText = await response.text().catch(() => "");
+    const MAX_ERROR_BODY = 1e3;
+    const text = rawText.length > MAX_ERROR_BODY ? `${rawText.slice(0, MAX_ERROR_BODY)}\u2026` : rawText;
+    throw new Error(
+      `Perplexity Search request failed with status ${response.status}${text ? `: ${text}` : ""}`
+    );
+  }
+  const json = await response.json();
+  return {
+    id: json.id,
+    results: Array.isArray(json.results) ? json.results : []
+  };
+}
+var inputSchema = z.object({
+  query: z.string().describe("The search query."),
+  maxResults: z.number().int().min(1).max(20).optional().describe("Maximum number of results to return (1-20). Defaults to the API default."),
+  searchDomainFilter: z.array(z.string()).optional().refine(
+    (domains) => {
+      if (!domains || domains.length === 0) return true;
+      const hasAllow = domains.some((d) => !d.startsWith("-"));
+      const hasDeny = domains.some((d) => d.startsWith("-"));
+      return !(hasAllow && hasDeny);
+    },
+    { message: "searchDomainFilter cannot mix allow and deny domain entries in the same call." }
+  ).describe(
+    "Restrict (or exclude) results by domain. Prefix a domain with `-` to exclude it (e.g. `-pinterest.com`). Do not mix allow and deny entries in the same call."
+  ),
+  searchRecencyFilter: z.enum(["hour", "day", "week", "month", "year"]).optional().describe("Only return results from within the given recency window."),
+  searchAfterDateFilter: z.string().optional().describe("Only return results published on or after this date. Format: m/d/yyyy (e.g. 1/1/2025)."),
+  searchBeforeDateFilter: z.string().optional().describe("Only return results published on or before this date. Format: m/d/yyyy (e.g. 12/31/2025).")
+});
+var outputSchema = z.object({
+  query: z.string(),
+  results: z.array(
+    z.object({
+      title: z.string(),
+      url: z.string(),
+      snippet: z.string(),
+      date: z.string().optional()
+    })
+  )
+});
+function createPerplexitySearchTool(config) {
+  return createTool({
+    id: "perplexity-search",
+    description: "Search the web for up-to-date information using the Perplexity Search API. Returns ranked results with titles, URLs, snippets, and optional publication dates. Supports filtering by domain, recency, and date range.",
+    inputSchema,
+    outputSchema,
+    execute: async (input) => {
+      const response = await perplexitySearchRequest(
+        {
+          query: input.query,
+          max_results: input.maxResults,
+          search_domain_filter: input.searchDomainFilter,
+          search_recency_filter: input.searchRecencyFilter,
+          search_after_date_filter: input.searchAfterDateFilter,
+          search_before_date_filter: input.searchBeforeDateFilter
+        },
+        config
+      );
+      return {
+        query: input.query,
+        results: response.results.map((r) => ({
+          title: r.title,
+          url: r.url,
+          snippet: r.snippet,
+          date: r.date
+        }))
+      };
+    }
+  });
+}
+
+// src/tools.ts
+function createPerplexityTools(config) {
+  return {
+    perplexitySearch: createPerplexitySearchTool(config)
+  };
+}
+
+export { DEFAULT_BASE_URL, createPerplexitySearchTool, createPerplexityTools, perplexitySearchRequest };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/search.ts","../src/tools.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export const DEFAULT_BASE_URL = 'https://api.perplexity.ai';\n\nexport type PerplexityClientOptions = {\n  /**\n   * Perplexity API key. Falls back to `PERPLEXITY_API_KEY` then `PPLX_API_KEY`\n   * environment variables when not provided.\n   */\n  apiKey?: string;\n  /**\n   * Override the API base URL. Defaults to `https://api.perplexity.ai`.\n   */\n  baseUrl?: string;\n  /**\n   * Optional `fetch` implementation. Useful for tests, retries, or instrumentation.\n   * Defaults to the global `fetch`.\n   */\n  fetch?: typeof fetch;\n};\n\nexport type PerplexitySearchResultItem = {\n  title: string;\n  url: string;\n  snippet: string;\n  date?: string;\n};\n\nexport type PerplexitySearchResponse = {\n  id?: string;\n  results: PerplexitySearchResultItem[];\n};\n\nexport type PerplexitySearchRequest = {\n  query: string;\n  max_results?: number;\n  max_tokens_per_page?: number;\n  search_domain_filter?: string[];\n  search_recency_filter?: 'hour' | 'day' | 'week' | 'month' | 'year';\n  search_after_date_filter?: string;\n  search_before_date_filter?: string;\n};\n\nfunction resolveApiKey(explicit?: string): string {\n  const key = explicit ?? process.env.PERPLEXITY_API_KEY ?? process.env.PPLX_API_KEY;\n  if (!key) {\n    throw new Error(\n      'Perplexity API key is required. Pass { apiKey } or set the PERPLEXITY_API_KEY (or PPLX_API_KEY) environment variable.',\n    );\n  }\n  return key;\n}\n\nexport async function perplexitySearchRequest(\n  body: PerplexitySearchRequest,\n  options?: PerplexityClientOptions,\n): Promise<PerplexitySearchResponse> {\n  const apiKey = resolveApiKey(options?.apiKey);\n  const baseUrl = options?.baseUrl ?? DEFAULT_BASE_URL;\n  const fetchImpl = options?.fetch ?? fetch;\n\n  const response = await fetchImpl(`${baseUrl.replace(/\\/$/, '')}/search`, {\n    method: 'POST',\n    headers: {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${apiKey}`,\n    },\n    body: JSON.stringify(body),\n  });\n\n  if (!response.ok) {\n    const rawText = await response.text().catch(() => '');\n    const MAX_ERROR_BODY = 1000;\n    const text =\n      rawText.length > MAX_ERROR_BODY ? `${rawText.slice(0, MAX_ERROR_BODY)}…` : rawText;\n    throw new Error(\n      `Perplexity Search request failed with status ${response.status}${text ? `: ${text}` : ''}`,\n    );\n  }\n\n  const json = (await response.json()) as Partial<PerplexitySearchResponse>;\n  return {\n    id: json.id,\n    results: Array.isArray(json.results) ? json.results : [],\n  };\n}\n","import { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport { perplexitySearchRequest } from './client.js';\nimport type { PerplexityClientOptions } from './client.js';\n\nconst inputSchema = z.object({\n  query: z.string().describe('The search query.'),\n  maxResults: z\n    .number()\n    .int()\n    .min(1)\n    .max(20)\n    .optional()\n    .describe('Maximum number of results to return (1-20). Defaults to the API default.'),\n  searchDomainFilter: z\n    .array(z.string())\n    .optional()\n    .refine(\n      domains => {\n        if (!domains || domains.length === 0) return true;\n        const hasAllow = domains.some(d => !d.startsWith('-'));\n        const hasDeny = domains.some(d => d.startsWith('-'));\n        return !(hasAllow && hasDeny);\n      },\n      { message: 'searchDomainFilter cannot mix allow and deny domain entries in the same call.' },\n    )\n    .describe(\n      'Restrict (or exclude) results by domain. Prefix a domain with `-` to exclude it (e.g. `-pinterest.com`). Do not mix allow and deny entries in the same call.',\n    ),\n  searchRecencyFilter: z\n    .enum(['hour', 'day', 'week', 'month', 'year'])\n    .optional()\n    .describe('Only return results from within the given recency window.'),\n  searchAfterDateFilter: z\n    .string()\n    .optional()\n    .describe('Only return results published on or after this date. Format: m/d/yyyy (e.g. 1/1/2025).'),\n  searchBeforeDateFilter: z\n    .string()\n    .optional()\n    .describe('Only return results published on or before this date. Format: m/d/yyyy (e.g. 12/31/2025).'),\n});\n\nconst outputSchema = z.object({\n  query: z.string(),\n  results: z.array(\n    z.object({\n      title: z.string(),\n      url: z.string(),\n      snippet: z.string(),\n      date: z.string().optional(),\n    }),\n  ),\n});\n\n/**\n * Creates a tool that searches the web using the Perplexity Search API.\n *\n * Returns ranked web results with titles, URLs, snippets, and optional\n * publication dates. Supports filtering by domain (allow- or deny-list),\n * recency, and explicit date ranges.\n *\n * @see https://docs.perplexity.ai/docs/search/quickstart\n */\nexport function createPerplexitySearchTool(config?: PerplexityClientOptions) {\n  return createTool({\n    id: 'perplexity-search',\n    description:\n      'Search the web for up-to-date information using the Perplexity Search API. Returns ranked results with titles, URLs, snippets, and optional publication dates. Supports filtering by domain, recency, and date range.',\n    inputSchema,\n    outputSchema,\n    execute: async input => {\n      const response = await perplexitySearchRequest(\n        {\n          query: input.query,\n          max_results: input.maxResults,\n          search_domain_filter: input.searchDomainFilter,\n          search_recency_filter: input.searchRecencyFilter,\n          search_after_date_filter: input.searchAfterDateFilter,\n          search_before_date_filter: input.searchBeforeDateFilter,\n        },\n        config,\n      );\n\n      return {\n        query: input.query,\n        results: response.results.map(r => ({\n          title: r.title,\n          url: r.url,\n          snippet: r.snippet,\n          date: r.date,\n        })),\n      };\n    },\n  });\n}\n","import type { PerplexityClientOptions } from './client.js';\nimport { createPerplexitySearchTool } from './search.js';\n\nexport function createPerplexityTools(config?: PerplexityClientOptions) {\n  return {\n    perplexitySearch: createPerplexitySearchTool(config),\n  };\n}\n"]}

package/dist/search.d.ts

@@ -0,0 +1,27 @@
+import type { PerplexityClientOptions } from './client.js';
+/**
+ * Creates a tool that searches the web using the Perplexity Search API.
+ *
+ * Returns ranked web results with titles, URLs, snippets, and optional
+ * publication dates. Supports filtering by domain (allow- or deny-list),
+ * recency, and explicit date ranges.
+ *
+ * @see https://docs.perplexity.ai/docs/search/quickstart
+ */
+export declare function createPerplexitySearchTool(config?: PerplexityClientOptions): import("@mastra/core/tools").Tool<{
+    query: string;
+    maxResults?: number | undefined;
+    searchDomainFilter?: string[] | undefined;
+    searchRecencyFilter?: "hour" | "day" | "week" | "month" | "year" | undefined;
+    searchAfterDateFilter?: string | undefined;
+    searchBeforeDateFilter?: string | undefined;
+}, {
+    query: string;
+    results: {
+        title: string;
+        url: string;
+        snippet: string;
+        date?: string | undefined;
+    }[];
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "perplexity-search", unknown>;
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAoD3D;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,CAAC,EAAE,uBAAuB;;;;;;;;;;;;;;;iIA+B1E"}

package/dist/tools.d.ts

@@ -0,0 +1,20 @@
+import type { PerplexityClientOptions } from './client.js';
+export declare function createPerplexityTools(config?: PerplexityClientOptions): {
+    perplexitySearch: import("@mastra/core/tools").Tool<{
+        query: string;
+        maxResults?: number | undefined;
+        searchDomainFilter?: string[] | undefined;
+        searchRecencyFilter?: "hour" | "day" | "week" | "month" | "year" | undefined;
+        searchAfterDateFilter?: string | undefined;
+        searchBeforeDateFilter?: string | undefined;
+    }, {
+        query: string;
+        results: {
+            title: string;
+            url: string;
+            snippet: string;
+            date?: string | undefined;
+        }[];
+    }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "perplexity-search", unknown>;
+};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG3D,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,uBAAuB;;;;;;;;;;;;;;;;;EAIrE"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@mastra/perplexity",
+  "version": "0.0.0-observe-20260504181920",
+  "description": "Perplexity Search tool for Mastra agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "keywords": [
+    "mastra",
+    "perplexity",
+    "web-search",
+    "tools",
+    "ai-agent"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mastra-ai/mastra.git",
+    "directory": "integrations/perplexity"
+  },
+  "bugs": {
+    "url": "https://github.com/mastra-ai/mastra/issues"
+  },
+  "homepage": "https://mastra.ai",
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "peerDependencies": {
+    "zod": ">=3.0.0 || >=4.0.0",
+    "@mastra/core": "0.0.0-observe-20260504181920"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "4.1.5",
+    "zod": "^4.3.6",
+    "@internal/lint": "0.0.0-observe-20260504181920",
+    "@internal/types-builder": "0.0.0-observe-20260504181920",
+    "@mastra/core": "0.0.0-observe-20260504181920"
+  },
+  "scripts": {
+    "build:lib": "tsup --silent --config tsup.config.ts",
+    "build:watch": "pnpm build:lib --watch",
+    "lint": "eslint .",
+    "test": "vitest run"
+  }
+}