@keystrokehq/exa 0.0.1

package/dist/index.mjs

@@ -0,0 +1,578 @@
+import { t as exa } from "./integration-C7rqRVI5.mjs";
+import { z } from "zod";
+import Exa from "exa-js";
+import { createOfficialOperationFactory } from "@keystrokehq/integration-authoring/official";
+
+//#region src/client.ts
+function createExaClient(credentials) {
+	return new Exa(credentials.EXA_API_KEY);
+}
+
+//#endregion
+//#region src/factory.ts
+const exaOperation = createOfficialOperationFactory(exa);
+
+//#endregion
+//#region src/schemas.ts
+const exaSearchResultSchema = z.object({
+	id: z.string(),
+	url: z.string(),
+	title: z.string().nullable(),
+	publishedDate: z.string().nullable().optional(),
+	author: z.string().nullable().optional(),
+	score: z.number().optional(),
+	image: z.string().nullable().optional(),
+	favicon: z.string().nullable().optional(),
+	text: z.string().optional(),
+	highlights: z.array(z.string()).optional(),
+	highlightScores: z.array(z.number()).optional(),
+	summary: z.string().optional(),
+	subpages: z.array(z.unknown()).optional(),
+	entities: z.array(z.unknown()).optional()
+});
+const exaCostSchema = z.record(z.string(), z.unknown());
+const exaSearchResponseSchema = z.object({
+	requestId: z.string().optional(),
+	results: z.array(exaSearchResultSchema),
+	searchType: z.string().optional(),
+	output: z.unknown().optional(),
+	costDollars: exaCostSchema.optional()
+});
+const exaContentsResponseSchema = z.object({
+	requestId: z.string().optional(),
+	results: z.array(exaSearchResultSchema),
+	statuses: z.array(z.unknown()).optional(),
+	costDollars: exaCostSchema.optional()
+});
+const exaAnswerCitationSchema = z.object({
+	id: z.string(),
+	url: z.string(),
+	title: z.string().nullable(),
+	author: z.string().nullable().optional(),
+	publishedDate: z.string().nullable().optional(),
+	text: z.string().optional(),
+	image: z.string().nullable().optional(),
+	favicon: z.string().nullable().optional()
+});
+const exaAnswerResponseSchema = z.object({
+	answer: z.union([z.string(), z.record(z.string(), z.unknown())]),
+	citations: z.array(exaAnswerCitationSchema),
+	requestId: z.string().optional(),
+	costDollars: exaCostSchema.optional()
+});
+const exaMonitorSchema = z.object({
+	id: z.string(),
+	name: z.string().nullable().optional(),
+	status: z.string().optional(),
+	search: z.unknown().optional(),
+	trigger: z.unknown().optional(),
+	outputSchema: z.unknown().optional(),
+	metadata: z.unknown().optional(),
+	webhook: z.unknown().optional(),
+	webhookSecret: z.string().optional(),
+	nextRunAt: z.string().nullable().optional(),
+	createdAt: z.string().optional(),
+	updatedAt: z.string().optional()
+});
+const exaMonitorRunSchema = z.object({
+	id: z.string(),
+	monitorId: z.string(),
+	status: z.string().optional(),
+	output: z.unknown().optional(),
+	failReason: z.string().nullable().optional(),
+	startedAt: z.string().nullable().optional(),
+	completedAt: z.string().nullable().optional(),
+	durationMs: z.number().nullable().optional(),
+	createdAt: z.string().optional(),
+	updatedAt: z.string().optional()
+});
+const exaMonitorListResponseSchema = z.object({
+	data: z.array(exaMonitorSchema),
+	hasMore: z.boolean().optional(),
+	nextCursor: z.string().nullable().optional()
+});
+const exaMonitorRunListResponseSchema = z.object({
+	data: z.array(exaMonitorRunSchema),
+	hasMore: z.boolean().optional(),
+	nextCursor: z.string().nullable().optional()
+});
+const exaTriggerMonitorResponseSchema = z.object({ triggered: z.boolean() });
+
+//#endregion
+//#region src/answer.ts
+const answer = exaOperation({
+	id: "exa_answer",
+	name: "Exa Answer",
+	description: "Get an AI-generated answer to a query with citations from web sources using Exa.",
+	input: z.object({
+		query: z.string(),
+		text: z.boolean().optional(),
+		model: z.enum(["exa"]).optional(),
+		systemPrompt: z.string().optional(),
+		outputSchema: z.record(z.string(), z.unknown()).optional(),
+		userLocation: z.string().optional()
+	}),
+	output: exaAnswerResponseSchema,
+	run: async (input, credentials) => {
+		const client = createExaClient(credentials);
+		const { query, ...options } = input;
+		return await client.answer(query, options);
+	}
+});
+const answerTool = answer;
+
+//#endregion
+//#region src/contents.ts
+const getContents = exaOperation({
+	id: "exa_get_contents",
+	name: "Exa Get Contents",
+	description: "Retrieve page contents (text, highlights, summaries) for a list of URLs.",
+	input: z.object({
+		urls: z.array(z.string()).min(1),
+		text: z.union([z.literal(true), z.object({
+			maxCharacters: z.number().optional(),
+			includeHtmlTags: z.boolean().optional(),
+			verbosity: z.enum([
+				"compact",
+				"standard",
+				"full"
+			]).optional()
+		})]).optional(),
+		highlights: z.union([z.literal(true), z.object({
+			maxCharacters: z.number().optional(),
+			query: z.string().optional()
+		})]).optional(),
+		summary: z.object({
+			query: z.string().optional(),
+			schema: z.record(z.string(), z.unknown()).optional()
+		}).optional(),
+		livecrawl: z.enum([
+			"always",
+			"fallback",
+			"never",
+			"auto",
+			"preferred"
+		]).optional(),
+		livecrawlTimeout: z.number().optional(),
+		maxAgeHours: z.number().optional(),
+		subpages: z.number().optional(),
+		subpageTarget: z.union([z.string(), z.array(z.string())]).optional(),
+		extras: z.record(z.string(), z.unknown()).optional(),
+		filterEmptyResults: z.boolean().optional()
+	}),
+	output: exaContentsResponseSchema,
+	run: async (input, credentials) => {
+		const client = createExaClient(credentials);
+		const { urls, ...options } = input;
+		return await client.getContents(urls, options);
+	}
+});
+const getContentsTool = getContents;
+
+//#endregion
+//#region src/find-similar.ts
+const findSimilar = exaOperation({
+	id: "exa_find_similar",
+	name: "Exa Find Similar",
+	description: "Find web pages similar to a given URL.",
+	input: z.object({
+		url: z.string(),
+		excludeSourceDomain: z.boolean().optional(),
+		numResults: z.number().min(1).max(100).optional(),
+		includeDomains: z.array(z.string()).optional(),
+		excludeDomains: z.array(z.string()).optional(),
+		startCrawlDate: z.string().optional(),
+		endCrawlDate: z.string().optional(),
+		startPublishedDate: z.string().optional(),
+		endPublishedDate: z.string().optional(),
+		includeText: z.array(z.string()).optional(),
+		excludeText: z.array(z.string()).optional(),
+		moderation: z.boolean().optional()
+	}),
+	output: exaSearchResponseSchema,
+	run: async (input, credentials) => {
+		const client = createExaClient(credentials);
+		const { url, ...options } = input;
+		return await client.findSimilar(url, {
+			...options,
+			contents: false
+		});
+	}
+});
+const findSimilarTool = findSimilar;
+
+//#endregion
+//#region src/find-similar-with-contents.ts
+const findSimilarWithContents = exaOperation({
+	id: "exa_find_similar_with_contents",
+	name: "Exa Find Similar with Contents",
+	description: "Find web pages similar to a given URL and retrieve their contents in a single request.",
+	input: z.object({
+		url: z.string(),
+		excludeSourceDomain: z.boolean().optional(),
+		numResults: z.number().min(1).max(100).optional(),
+		includeDomains: z.array(z.string()).optional(),
+		excludeDomains: z.array(z.string()).optional(),
+		startCrawlDate: z.string().optional(),
+		endCrawlDate: z.string().optional(),
+		startPublishedDate: z.string().optional(),
+		endPublishedDate: z.string().optional(),
+		includeText: z.array(z.string()).optional(),
+		excludeText: z.array(z.string()).optional(),
+		moderation: z.boolean().optional(),
+		text: z.union([z.literal(true), z.object({
+			maxCharacters: z.number().optional(),
+			includeHtmlTags: z.boolean().optional(),
+			verbosity: z.enum([
+				"compact",
+				"standard",
+				"full"
+			]).optional()
+		})]).optional(),
+		highlights: z.union([z.literal(true), z.object({
+			maxCharacters: z.number().optional(),
+			query: z.string().optional()
+		})]).optional(),
+		summary: z.object({
+			query: z.string().optional(),
+			schema: z.record(z.string(), z.unknown()).optional()
+		}).optional(),
+		livecrawl: z.enum([
+			"always",
+			"fallback",
+			"never",
+			"auto",
+			"preferred"
+		]).optional(),
+		livecrawlTimeout: z.number().optional(),
+		maxAgeHours: z.number().optional(),
+		subpages: z.number().optional(),
+		subpageTarget: z.union([z.string(), z.array(z.string())]).optional(),
+		extras: z.record(z.string(), z.unknown()).optional(),
+		filterEmptyResults: z.boolean().optional()
+	}),
+	output: exaSearchResponseSchema,
+	run: async (input, credentials) => {
+		const client = createExaClient(credentials);
+		const { url, text, highlights, summary, livecrawl, livecrawlTimeout, maxAgeHours, subpages, subpageTarget, extras, filterEmptyResults, ...searchOptions } = input;
+		const contents = {
+			text,
+			highlights,
+			summary,
+			livecrawl,
+			livecrawlTimeout,
+			maxAgeHours,
+			subpages,
+			subpageTarget,
+			extras,
+			filterEmptyResults
+		};
+		return await client.findSimilar(url, {
+			...searchOptions,
+			contents
+		});
+	}
+});
+const findSimilarWithContentsTool = findSimilarWithContents;
+
+//#endregion
+//#region src/monitors.ts
+const createMonitor = exaOperation({
+	id: "exa_create_monitor",
+	name: "Create Exa Monitor",
+	description: "Create a new Exa monitor to track search results over time.",
+	needsApproval: true,
+	input: z.object({
+		name: z.string().optional(),
+		search: z.object({
+			query: z.string(),
+			numResults: z.number().optional(),
+			contents: z.unknown().optional()
+		}),
+		trigger: z.object({
+			type: z.string(),
+			period: z.string().optional()
+		}).optional(),
+		outputSchema: z.record(z.string(), z.unknown()).optional(),
+		metadata: z.record(z.string(), z.unknown()).optional(),
+		webhook: z.object({
+			url: z.string(),
+			events: z.array(z.string()).optional()
+		})
+	}),
+	output: exaMonitorSchema,
+	run: async (input, credentials) => {
+		return await createExaClient(credentials).monitors.create(input);
+	}
+});
+const createMonitorTool = createMonitor;
+const listMonitors = exaOperation({
+	id: "exa_list_monitors",
+	name: "List Exa Monitors",
+	description: "List all Exa monitors with optional status filtering and pagination.",
+	input: z.object({
+		status: z.enum([
+			"active",
+			"paused",
+			"disabled"
+		]).optional(),
+		cursor: z.string().optional(),
+		limit: z.number().min(1).max(100).optional()
+	}),
+	output: exaMonitorListResponseSchema,
+	run: async (input, credentials) => {
+		return await createExaClient(credentials).monitors.list(input);
+	}
+});
+const listMonitorsTool = listMonitors;
+const getMonitor = exaOperation({
+	id: "exa_get_monitor",
+	name: "Get Exa Monitor",
+	description: "Get details of a specific Exa monitor by ID.",
+	input: z.object({ monitorId: z.string() }),
+	output: exaMonitorSchema,
+	run: async (input, credentials) => {
+		return await createExaClient(credentials).monitors.get(input.monitorId);
+	}
+});
+const getMonitorTool = getMonitor;
+const updateMonitor = exaOperation({
+	id: "exa_update_monitor",
+	name: "Update Exa Monitor",
+	description: "Update an existing Exa monitor configuration.",
+	needsApproval: true,
+	input: z.object({
+		monitorId: z.string(),
+		name: z.string().optional(),
+		search: z.object({
+			query: z.string(),
+			numResults: z.number().optional(),
+			contents: z.unknown().optional()
+		}).optional(),
+		trigger: z.object({
+			type: z.string(),
+			period: z.string().optional()
+		}).optional(),
+		outputSchema: z.record(z.string(), z.unknown()).optional(),
+		metadata: z.record(z.string(), z.unknown()).optional(),
+		webhook: z.object({
+			url: z.string(),
+			events: z.array(z.string()).optional()
+		}).optional()
+	}),
+	output: exaMonitorSchema,
+	run: async (input, credentials) => {
+		const client = createExaClient(credentials);
+		const { monitorId, ...rest } = input;
+		return await client.monitors.update(monitorId, rest);
+	}
+});
+const updateMonitorTool = updateMonitor;
+const deleteMonitor = exaOperation({
+	id: "exa_delete_monitor",
+	name: "Delete Exa Monitor",
+	description: "Delete an Exa monitor by ID. Returns the deleted monitor object.",
+	needsApproval: true,
+	input: z.object({ monitorId: z.string() }),
+	output: exaMonitorSchema,
+	run: async (input, credentials) => {
+		return await createExaClient(credentials).monitors.delete(input.monitorId);
+	}
+});
+const deleteMonitorTool = deleteMonitor;
+const triggerMonitor = exaOperation({
+	id: "exa_trigger_monitor",
+	name: "Trigger Exa Monitor",
+	description: "Manually trigger an Exa monitor to run immediately.",
+	needsApproval: true,
+	input: z.object({ monitorId: z.string() }),
+	output: exaTriggerMonitorResponseSchema,
+	run: async (input, credentials) => {
+		return await createExaClient(credentials).monitors.trigger(input.monitorId);
+	}
+});
+const triggerMonitorTool = triggerMonitor;
+const listMonitorRuns = exaOperation({
+	id: "exa_list_monitor_runs",
+	name: "List Exa Monitor Runs",
+	description: "List runs for a specific Exa monitor with pagination.",
+	input: z.object({
+		monitorId: z.string(),
+		cursor: z.string().optional(),
+		limit: z.number().min(1).max(100).optional()
+	}),
+	output: exaMonitorRunListResponseSchema,
+	run: async (input, credentials) => {
+		const client = createExaClient(credentials);
+		const { monitorId, ...rest } = input;
+		return await client.monitors.runs.list(monitorId, rest);
+	}
+});
+const listMonitorRunsTool = listMonitorRuns;
+const getMonitorRun = exaOperation({
+	id: "exa_get_monitor_run",
+	name: "Get Exa Monitor Run",
+	description: "Get details of a specific Exa monitor run.",
+	input: z.object({
+		monitorId: z.string(),
+		runId: z.string()
+	}),
+	output: exaMonitorRunSchema,
+	run: async (input, credentials) => {
+		return await createExaClient(credentials).monitors.runs.get(input.monitorId, input.runId);
+	}
+});
+const getMonitorRunTool = getMonitorRun;
+
+//#endregion
+//#region src/search.ts
+const search = exaOperation({
+	id: "exa_search",
+	name: "Exa Search",
+	description: "Search the web using Exa semantic, keyword, or hybrid search.",
+	input: z.object({
+		query: z.string(),
+		type: z.enum([
+			"auto",
+			"neural",
+			"fast",
+			"instant",
+			"deep-lite",
+			"deep",
+			"deep-reasoning",
+			"keyword",
+			"hybrid"
+		]).optional(),
+		category: z.enum([
+			"company",
+			"research paper",
+			"news",
+			"personal site",
+			"financial report",
+			"people",
+			"pdf"
+		]).optional(),
+		numResults: z.number().min(1).max(100).optional(),
+		includeDomains: z.array(z.string()).optional(),
+		excludeDomains: z.array(z.string()).optional(),
+		startPublishedDate: z.string().optional(),
+		endPublishedDate: z.string().optional(),
+		startCrawlDate: z.string().optional(),
+		endCrawlDate: z.string().optional(),
+		includeText: z.array(z.string()).optional(),
+		excludeText: z.array(z.string()).optional(),
+		moderation: z.boolean().optional(),
+		useAutoprompt: z.boolean().optional(),
+		userLocation: z.string().optional()
+	}),
+	output: exaSearchResponseSchema,
+	run: async (input, credentials) => {
+		const client = createExaClient(credentials);
+		const { query, ...options } = input;
+		return await client.search(query, {
+			...options,
+			contents: false
+		});
+	}
+});
+const searchTool = search;
+
+//#endregion
+//#region src/search-with-contents.ts
+const contentsOptionsSchema = z.object({
+	text: z.union([z.literal(true), z.object({
+		maxCharacters: z.number().optional(),
+		includeHtmlTags: z.boolean().optional(),
+		verbosity: z.enum([
+			"compact",
+			"standard",
+			"full"
+		]).optional()
+	})]).optional(),
+	highlights: z.union([z.literal(true), z.object({
+		maxCharacters: z.number().optional(),
+		query: z.string().optional()
+	})]).optional(),
+	summary: z.object({
+		query: z.string().optional(),
+		schema: z.record(z.string(), z.unknown()).optional()
+	}).optional(),
+	livecrawl: z.enum([
+		"always",
+		"fallback",
+		"never",
+		"auto",
+		"preferred"
+	]).optional(),
+	livecrawlTimeout: z.number().optional(),
+	maxAgeHours: z.number().optional(),
+	subpages: z.number().optional(),
+	subpageTarget: z.union([z.string(), z.array(z.string())]).optional(),
+	extras: z.record(z.string(), z.unknown()).optional(),
+	filterEmptyResults: z.boolean().optional()
+});
+const searchWithContents = exaOperation({
+	id: "exa_search_with_contents",
+	name: "Exa Search with Contents",
+	description: "Search the web using Exa and retrieve page contents (text, highlights, summaries) in a single request.",
+	input: z.object({
+		query: z.string(),
+		type: z.enum([
+			"auto",
+			"neural",
+			"fast",
+			"instant",
+			"deep-lite",
+			"deep",
+			"deep-reasoning",
+			"keyword",
+			"hybrid"
+		]).optional(),
+		category: z.enum([
+			"company",
+			"research paper",
+			"news",
+			"personal site",
+			"financial report",
+			"people",
+			"pdf"
+		]).optional(),
+		numResults: z.number().min(1).max(100).optional(),
+		includeDomains: z.array(z.string()).optional(),
+		excludeDomains: z.array(z.string()).optional(),
+		startPublishedDate: z.string().optional(),
+		endPublishedDate: z.string().optional(),
+		startCrawlDate: z.string().optional(),
+		endCrawlDate: z.string().optional(),
+		includeText: z.array(z.string()).optional(),
+		excludeText: z.array(z.string()).optional(),
+		moderation: z.boolean().optional(),
+		useAutoprompt: z.boolean().optional(),
+		userLocation: z.string().optional()
+	}).merge(contentsOptionsSchema),
+	output: exaSearchResponseSchema,
+	run: async (input, credentials) => {
+		const client = createExaClient(credentials);
+		const { query, text, highlights, summary, livecrawl, livecrawlTimeout, maxAgeHours, subpages, subpageTarget, extras, filterEmptyResults, ...searchOptions } = input;
+		const contents = {
+			text,
+			highlights,
+			summary,
+			livecrawl,
+			livecrawlTimeout,
+			maxAgeHours,
+			subpages,
+			subpageTarget,
+			extras,
+			filterEmptyResults
+		};
+		return await client.search(query, {
+			...searchOptions,
+			contents
+		});
+	}
+});
+const searchWithContentsTool = searchWithContents;
+
+//#endregion
+export { answer, answerTool, createExaClient, createMonitor, createMonitorTool, deleteMonitor, deleteMonitorTool, exa, exaAnswerCitationSchema, exaAnswerResponseSchema, exaContentsResponseSchema, exaCostSchema, exaMonitorListResponseSchema, exaMonitorRunListResponseSchema, exaMonitorRunSchema, exaMonitorSchema, exaOperation, exaSearchResponseSchema, exaSearchResultSchema, exaTriggerMonitorResponseSchema, findSimilar, findSimilarTool, findSimilarWithContents, findSimilarWithContentsTool, getContents, getContentsTool, getMonitor, getMonitorRun, getMonitorRunTool, getMonitorTool, listMonitorRuns, listMonitorRunsTool, listMonitors, listMonitorsTool, search, searchTool, searchWithContents, searchWithContentsTool, triggerMonitor, triggerMonitorTool, updateMonitor, updateMonitorTool };

package/dist/integration-Bl0--6XJ.d.mts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import * as _keystrokehq_integration_authoring_official0 from "@keystrokehq/integration-authoring/official";
+import * as _keystrokehq_core_credential_set0 from "@keystrokehq/core/credential-set";
+import { InferCredentialSetAuth } from "@keystrokehq/core/credential-set";
+import * as _keystrokehq_core0 from "@keystrokehq/core";
+
+//#region src/integration.d.ts
+declare const exaBundle: _keystrokehq_integration_authoring_official0.OfficialIntegrationBundle<"exa", z.ZodObject<{
+  EXA_API_KEY: z.ZodString;
+}, z.core.$strip>>;
+declare const exa: _keystrokehq_core0.CredentialSet<"exa", z.ZodObject<{
+  EXA_API_KEY: z.ZodString;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  EXA_API_KEY: z.ZodString;
+}, z.core.$strip>>[] | undefined>;
+type ExaCredentials = InferCredentialSetAuth<typeof exa>;
+//#endregion
+export { exa as n, exaBundle as r, ExaCredentials as t };

package/dist/integration-C7rqRVI5.mjs

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import { defineOfficialIntegration } from "@keystrokehq/integration-authoring/official";
+
+//#region src/integration.ts
+const exaAuthSchema = z.object({ EXA_API_KEY: z.string().min(1) });
+const exaOfficialIntegration = {
+	id: "exa",
+	name: "Exa",
+	description: "AI-native semantic web search, content extraction, and monitoring",
+	auth: exaAuthSchema,
+	proxy: { hosts: ["api.exa.ai"] }
+};
+const exaBundle = defineOfficialIntegration(exaOfficialIntegration);
+const exa = exaBundle.credentialSet;
+
+//#endregion
+export { exaBundle as n, exa as t };

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@keystrokehq/exa",
+  "version": "0.0.1",
+  "private": false,
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./_official": {
+      "types": "./dist/_official/index.d.mts",
+      "default": "./dist/_official/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsgo --build",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "test:unit": "vitest run --passWithNoTests --project unit",
+    "test:int": "vitest run --passWithNoTests --project int",
+    "prepublishOnly": "pnpm build"
+  },
+  "dependencies": {
+    "exa-js": "^2.11.0",
+    "@keystrokehq/integration-authoring": "^0.0.1",
+    "@keystrokehq/core": "^0.0.5",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:",
+    "tsdown": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:",
+    "@keystrokehq/test-utils": "workspace:*",
+    "@keystrokehq/typescript-config": "workspace:*"
+  },
+  "keywords": [
+    "exa",
+    "web-search",
+    "semantic-search",
+    "keystroke",
+    "integration"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/keystrokehq/integrations",
+    "directory": "integrations/exa"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}