@tool-bridge/server 0.1.1 → 0.3.0

package/dist/exa-KTDY6IV3.js

@@ -0,0 +1,360 @@
+import {
+  createProviderPlugin,
+  guardedFetch,
+  requireApiKey,
+  upstreamError
+} from "./chunk-CSJEZHQO.js";
+import "./chunk-K7FVSFUX.js";
+import {
+  TBError,
+  external_exports
+} from "./chunk-JLTYA2B3.js";
+import "./chunk-MLKGABMK.js";
+
+// ../plugins/src/exa/api.ts
+var SERVICE = "exa";
+var API_BASE = "https://api.exa.ai";
+var SEARCH_PATH = "/search";
+var CONTENTS_PATH = "/contents";
+var ANSWER_PATH = "/answer";
+var FIND_SIMILAR_PATH = "/findSimilar";
+function asRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function optionalText(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+function compact(input) {
+  const output = {};
+  for (const [key, value] of Object.entries(input)) {
+    if (value !== void 0) output[key] = value;
+  }
+  return output;
+}
+async function readPayload(response) {
+  const text = await response.text().catch(() => "");
+  if (text.trim() === "") return null;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+function errorMessage(payload) {
+  if (typeof payload === "string") return optionalText(payload);
+  const object = asRecord(payload);
+  if (object === void 0) return void 0;
+  return optionalText(object.error) ?? optionalText(object.message) ?? optionalText(object.detail);
+}
+async function request(ctx, path, body) {
+  const apiKey = requireApiKey(ctx, SERVICE);
+  let response;
+  let payload;
+  try {
+    response = await guardedFetch(new URL(path, API_BASE).toString(), {
+      method: "POST",
+      headers: {
+        "accept": "application/json",
+        "content-type": "application/json",
+        "x-api-key": apiKey
+      },
+      body: JSON.stringify(body)
+    });
+    payload = await readPayload(response);
+  } catch (error) {
+    if (error instanceof TBError) throw error;
+    throw upstreamError(502, error instanceof Error ? `exa \u8BF7\u6C42\u5931\u8D25: ${error.message}` : "exa \u8BF7\u6C42\u5931\u8D25");
+  }
+  if (!response.ok) {
+    throw upstreamError(
+      response.status,
+      errorMessage(payload) ?? (response.statusText || `exa \u8FD4\u56DE HTTP ${response.status}`)
+    );
+  }
+  if (payload === null) return {};
+  if (typeof payload === "string") {
+    throw upstreamError(502, "exa \u8FD4\u56DE\u4E86\u975E JSON \u54CD\u5E94");
+  }
+  return payload;
+}
+function responseText(value, field) {
+  const text = optionalText(value);
+  if (text === void 0) throw upstreamError(502, `exa \u54CD\u5E94\u7F3A\u5C11 ${field}`);
+  return text;
+}
+function responseRecord(payload, field) {
+  const object = asRecord(payload);
+  if (object === void 0) throw upstreamError(502, `exa ${field} \u54CD\u5E94\u4E0D\u662F\u5BF9\u8C61`);
+  return object;
+}
+function responseArray(value, field) {
+  if (!Array.isArray(value)) throw upstreamError(502, `exa \u54CD\u5E94\u7684 ${field} \u4E0D\u662F\u6570\u7EC4`);
+  return value;
+}
+function resultItems(value, field) {
+  return responseArray(value, field).map((item) => responseRecord(item, `${field} \u7ED3\u679C\u9879`));
+}
+function assertDomainFilters(input) {
+  if (input.includeDomains !== void 0 && input.excludeDomains !== void 0) {
+    throw new TBError("invalid_argument", "includeDomains \u4E0E excludeDomains \u4E0D\u80FD\u540C\u65F6\u63D0\u4F9B");
+  }
+}
+function normalizeResults(object, extra = {}) {
+  return compact({
+    requestId: responseText(object.requestId, "requestId"),
+    results: resultItems(object.results, "results"),
+    ...extra,
+    costDollars: asRecord(object.costDollars)
+  });
+}
+async function search(input, ctx) {
+  assertDomainFilters(input);
+  const object = responseRecord(await request(ctx, SEARCH_PATH, compact(input)), "\u641C\u7D22");
+  return normalizeResults(object, {
+    searchType: optionalText(object.searchType),
+    output: asRecord(object.output)
+  });
+}
+async function getContents(input, ctx) {
+  const object = responseRecord(await request(ctx, CONTENTS_PATH, compact(input)), "contents");
+  return compact({
+    requestId: responseText(object.requestId, "requestId"),
+    results: resultItems(object.results, "results"),
+    // statuses 是可选的:字段缺席与"空数组"不是一回事,前者不该被伪造成后者。
+    statuses: object.statuses === void 0 ? void 0 : resultItems(object.statuses, "statuses"),
+    costDollars: asRecord(object.costDollars)
+  });
+}
+async function answer(input, ctx) {
+  const object = responseRecord(await request(ctx, ANSWER_PATH, compact(input)), "answer");
+  return compact({
+    // answer 既可能是一段文本,也可能是结构化对象(取决于 Exa 选的答案形态)。
+    // 文本这里**不 trim**:它是内容而非标识符,首尾空白由调用方自己决定怎么处理。
+    answer: typeof object.answer === "string" ? object.answer : asRecord(object.answer),
+    citations: resultItems(object.citations, "citations"),
+    costDollars: asRecord(object.costDollars)
+  });
+}
+async function findSimilar(input, ctx) {
+  assertDomainFilters(input);
+  return normalizeResults(responseRecord(await request(ctx, FIND_SIMILAR_PATH, compact(input)), "\u641C\u7D22"));
+}
+
+// ../plugins/src/exa/schema.ts
+var searchInput = external_exports.strictObject({
+  query: external_exports.string().min(1).describe("The search query to send to Exa."),
+  additionalQueries: external_exports.array(external_exports.string().min(1)).min(1).describe("Additional query variations to use with deep or deep-reasoning search.").optional(),
+  type: external_exports.enum(["neural", "fast", "auto", "deep", "deep-reasoning", "instant"]).describe("The Exa search mode to execute.").optional(),
+  category: external_exports.enum(["company", "research paper", "news", "pdf", "github", "personal site", "people", "financial report"]).describe("The Exa category used to narrow search results.").optional(),
+  numResults: external_exports.int().min(1).max(100).describe("The number of search results to return, up to 100.").optional(),
+  userLocation: external_exports.string().min(2).max(2).describe("A two-letter ISO country code used to localize search results.").optional(),
+  includeDomains: external_exports.array(external_exports.string().min(1)).min(1).describe("Only return results from these domains.").optional(),
+  excludeDomains: external_exports.array(external_exports.string().min(1)).min(1).describe("Exclude results from these domains.").optional(),
+  startCrawlDate: external_exports.iso.datetime({ offset: true }).describe("Only return results crawled after this timestamp.").optional(),
+  endCrawlDate: external_exports.iso.datetime({ offset: true }).describe("Only return results crawled before this timestamp.").optional(),
+  startPublishedDate: external_exports.iso.datetime({ offset: true }).describe("Only return results published after this timestamp.").optional(),
+  endPublishedDate: external_exports.iso.datetime({ offset: true }).describe("Only return results published before this timestamp.").optional(),
+  includeText: external_exports.array(external_exports.string().min(1)).min(1).describe("Phrases that must appear in the result text.").optional(),
+  excludeText: external_exports.array(external_exports.string().min(1)).min(1).describe("Phrases that must not appear in the result text.").optional(),
+  moderation: external_exports.boolean().describe("Whether Exa should filter unsafe content from results.").optional(),
+  contents: external_exports.strictObject({
+    text: external_exports.union([external_exports.boolean().describe("Whether Exa should return extracted text."), external_exports.strictObject({
+      maxCharacters: external_exports.int().min(1).describe("The maximum number of characters to return for extracted text.").optional(),
+      includeHtmlTags: external_exports.boolean().describe("Whether Exa should preserve HTML tags in extracted text.").optional(),
+      verbosity: external_exports.enum(["compact", "standard", "full"]).describe("The verbosity level for extracted page text.").optional(),
+      includeSections: external_exports.array(external_exports.enum(["header", "navigation", "banner", "body", "sidebar", "footer", "metadata"]).describe("A semantic page section used by Exa content extraction.")).min(1).describe("Only include content from these semantic page sections.").optional(),
+      excludeSections: external_exports.array(external_exports.enum(["header", "navigation", "banner", "body", "sidebar", "footer", "metadata"]).describe("A semantic page section used by Exa content extraction.")).min(1).describe("Exclude content from these semantic page sections.").optional()
+    }).describe("Advanced configuration for Exa text extraction.")]).optional(),
+    highlights: external_exports.union([external_exports.boolean().describe("Whether Exa should return highlights."), external_exports.strictObject({
+      maxCharacters: external_exports.int().min(1).describe("The maximum number of characters to return across highlights.").optional(),
+      numSentences: external_exports.int().min(1).describe("Deprecated by Exa. The number of sentences to include in each highlight snippet.").optional(),
+      highlightsPerUrl: external_exports.int().min(1).describe("Deprecated by Exa. The number of highlight snippets to return per URL.").optional(),
+      query: external_exports.string().min(1).describe("A custom query that guides Exa highlight selection.").optional()
+    }).describe("Advanced configuration for Exa highlights.")]).optional(),
+    summary: external_exports.strictObject({
+      query: external_exports.string().min(1).describe("A custom query that guides Exa summary generation.").optional(),
+      schema: external_exports.looseObject({}).describe("A JSON Schema object used for structured Exa summaries.").optional()
+    }).describe("Configuration for an Exa summary response.").optional(),
+    livecrawlTimeout: external_exports.int().min(0).describe("The livecrawl timeout in milliseconds.").optional(),
+    maxAgeHours: external_exports.union([external_exports.literal(-1), external_exports.int().min(0).describe("A non-negative cache age in hours.")]).describe("Maximum age of cached content in hours. Use -1 to always use cache, 0 to always livecrawl, or a positive integer to require fresher content.").optional(),
+    subpages: external_exports.int().min(0).describe("The maximum number of subpages Exa should crawl per result.").optional(),
+    subpageTarget: external_exports.union([external_exports.string().min(1).describe("A single keyword used to locate relevant subpages."), external_exports.array(external_exports.string().min(1)).min(1).describe("A list of keywords used to locate relevant subpages.")]).describe("Keywords Exa should use when selecting subpages.").optional(),
+    extras: external_exports.strictObject({
+      links: external_exports.int().min(0).describe("The maximum number of webpage links to return for each result.").optional(),
+      imageLinks: external_exports.int().min(0).describe("The maximum number of image links to return for each result.").optional()
+    }).describe("Additional Exa extraction options.").optional()
+  }).describe("The Exa contents request object.").optional()
+}).describe("The input payload for an Exa search request. includeDomains and excludeDomains cannot be provided together.");
+var searchOutput = external_exports.strictObject({
+  requestId: external_exports.string().describe("The unique identifier for this Exa request."),
+  results: external_exports.array(external_exports.looseObject({
+    id: external_exports.string().describe("The temporary Exa document identifier.").optional(),
+    url: external_exports.string().describe("The result URL.").optional(),
+    title: external_exports.string().describe("The result title.").optional(),
+    publishedDate: external_exports.string().describe("The estimated publication timestamp for the result.").nullable().optional(),
+    author: external_exports.string().describe("The result author.").nullable().optional(),
+    score: external_exports.number().describe("The result relevance score.").nullable().optional()
+  }).describe("An Exa search or contents result object.")).describe("The Exa search results."),
+  searchType: external_exports.string().describe("The search type Exa selected for the request.").optional(),
+  output: external_exports.looseObject({}).describe("The Exa deep search output object.").optional(),
+  costDollars: external_exports.looseObject({
+    total: external_exports.number().describe("The total request cost in US dollars.").optional()
+  }).describe("The Exa costDollars object.").optional()
+}).describe("The response payload for exa.search.");
+var getContentsInput = external_exports.strictObject({
+  urls: external_exports.array(external_exports.url().describe("One URL to retrieve content for.")).min(1).describe("The list of URLs to retrieve content for."),
+  ids: external_exports.array(external_exports.string().min(1)).min(1).describe("Deprecated. A backward-compatibility list of Exa document IDs.").optional(),
+  text: external_exports.union([external_exports.boolean().describe("Whether Exa should return extracted text."), external_exports.strictObject({
+    maxCharacters: external_exports.int().min(1).describe("The maximum number of characters to return for extracted text.").optional(),
+    includeHtmlTags: external_exports.boolean().describe("Whether Exa should preserve HTML tags in extracted text.").optional(),
+    verbosity: external_exports.enum(["compact", "standard", "full"]).describe("The verbosity level for extracted page text.").optional(),
+    includeSections: external_exports.array(external_exports.enum(["header", "navigation", "banner", "body", "sidebar", "footer", "metadata"]).describe("A semantic page section used by Exa content extraction.")).min(1).describe("Only include content from these semantic page sections.").optional(),
+    excludeSections: external_exports.array(external_exports.enum(["header", "navigation", "banner", "body", "sidebar", "footer", "metadata"]).describe("A semantic page section used by Exa content extraction.")).min(1).describe("Exclude content from these semantic page sections.").optional()
+  }).describe("Advanced configuration for Exa text extraction.")]).optional(),
+  highlights: external_exports.union([external_exports.boolean().describe("Whether Exa should return highlights."), external_exports.strictObject({
+    maxCharacters: external_exports.int().min(1).describe("The maximum number of characters to return across highlights.").optional(),
+    numSentences: external_exports.int().min(1).describe("Deprecated by Exa. The number of sentences to include in each highlight snippet.").optional(),
+    highlightsPerUrl: external_exports.int().min(1).describe("Deprecated by Exa. The number of highlight snippets to return per URL.").optional(),
+    query: external_exports.string().min(1).describe("A custom query that guides Exa highlight selection.").optional()
+  }).describe("Advanced configuration for Exa highlights.")]).optional(),
+  summary: external_exports.strictObject({
+    query: external_exports.string().min(1).describe("A custom query that guides Exa summary generation.").optional(),
+    schema: external_exports.looseObject({}).describe("A JSON Schema object used for structured Exa summaries.").optional()
+  }).describe("Configuration for an Exa summary response.").optional(),
+  livecrawlTimeout: external_exports.int().min(0).describe("The livecrawl timeout in milliseconds.").optional(),
+  maxAgeHours: external_exports.union([external_exports.literal(-1), external_exports.int().min(0).describe("A non-negative cache age in hours.")]).describe("Maximum age of cached content in hours. Use -1 to always use cache, 0 to always livecrawl, or a positive integer to require fresher content.").optional(),
+  subpages: external_exports.int().min(0).describe("The maximum number of subpages Exa should crawl per result.").optional(),
+  subpageTarget: external_exports.union([external_exports.string().min(1).describe("A single keyword used to locate relevant subpages."), external_exports.array(external_exports.string().min(1)).min(1).describe("A list of keywords used to locate relevant subpages.")]).describe("Keywords Exa should use when selecting subpages.").optional(),
+  extras: external_exports.strictObject({
+    links: external_exports.int().min(0).describe("The maximum number of webpage links to return for each result.").optional(),
+    imageLinks: external_exports.int().min(0).describe("The maximum number of image links to return for each result.").optional()
+  }).describe("Additional Exa extraction options.").optional()
+}).describe("The input payload for fetching Exa contents by URL.");
+var getContentsOutput = external_exports.strictObject({
+  requestId: external_exports.string().describe("The unique identifier for this Exa request."),
+  results: external_exports.array(external_exports.looseObject({
+    id: external_exports.string().describe("The temporary Exa document identifier.").optional(),
+    url: external_exports.string().describe("The result URL.").optional(),
+    title: external_exports.string().describe("The result title.").optional(),
+    publishedDate: external_exports.string().describe("The estimated publication timestamp for the result.").nullable().optional(),
+    author: external_exports.string().describe("The result author.").nullable().optional(),
+    score: external_exports.number().describe("The result relevance score.").nullable().optional()
+  }).describe("An Exa search or contents result object.")).describe("The Exa content results returned successfully."),
+  statuses: external_exports.array(external_exports.looseObject({}).describe("One Exa content status.")).describe("The fetch status for each requested input item.").optional(),
+  costDollars: external_exports.looseObject({
+    total: external_exports.number().describe("The total request cost in US dollars.").optional()
+  }).describe("The Exa costDollars object.").optional()
+}).describe("The response payload for exa.get_contents.");
+var answerInput = external_exports.strictObject({
+  query: external_exports.string().min(1).describe("The question or prompt Exa should answer."),
+  text: external_exports.boolean().describe("Whether citations should include the full source text.").optional()
+}).describe("The input payload for an Exa answer request.");
+var answerOutput = external_exports.strictObject({
+  answer: external_exports.union([external_exports.string().describe("The text answer returned by Exa."), external_exports.looseObject({}).describe("The structured answer returned by Exa.")]).optional(),
+  citations: external_exports.array(external_exports.looseObject({}).describe("An Exa answer citation.")).describe("The citations supporting the Exa answer."),
+  costDollars: external_exports.looseObject({
+    total: external_exports.number().describe("The total request cost in US dollars.").optional()
+  }).describe("The Exa costDollars object.").optional()
+}).describe("The response payload for exa.answer.");
+var findSimilarInput = external_exports.strictObject({
+  url: external_exports.url().describe("The URL used to find similar pages."),
+  excludeSourceDomain: external_exports.boolean().describe("Whether to exclude results from the same domain as the input URL.").optional(),
+  numResults: external_exports.int().min(1).max(100).describe("The number of similar results to return, up to 100.").optional(),
+  includeDomains: external_exports.array(external_exports.string().min(1)).min(1).describe("Only return results from these domains.").optional(),
+  excludeDomains: external_exports.array(external_exports.string().min(1)).min(1).describe("Exclude results from these domains.").optional(),
+  startCrawlDate: external_exports.iso.datetime({ offset: true }).describe("Only return results crawled after this timestamp.").optional(),
+  endCrawlDate: external_exports.iso.datetime({ offset: true }).describe("Only return results crawled before this timestamp.").optional(),
+  startPublishedDate: external_exports.iso.datetime({ offset: true }).describe("Only return results published after this timestamp.").optional(),
+  endPublishedDate: external_exports.iso.datetime({ offset: true }).describe("Only return results published before this timestamp.").optional(),
+  includeText: external_exports.array(external_exports.string().min(1)).min(1).describe("Phrases that must appear in the result text.").optional(),
+  excludeText: external_exports.array(external_exports.string().min(1)).min(1).describe("Phrases that must not appear in the result text.").optional(),
+  moderation: external_exports.boolean().describe("Whether Exa should filter unsafe content from results.").optional(),
+  contents: external_exports.strictObject({
+    text: external_exports.union([external_exports.boolean().describe("Whether Exa should return extracted text."), external_exports.strictObject({
+      maxCharacters: external_exports.int().min(1).describe("The maximum number of characters to return for extracted text.").optional(),
+      includeHtmlTags: external_exports.boolean().describe("Whether Exa should preserve HTML tags in extracted text.").optional(),
+      verbosity: external_exports.enum(["compact", "standard", "full"]).describe("The verbosity level for extracted page text.").optional(),
+      includeSections: external_exports.array(external_exports.enum(["header", "navigation", "banner", "body", "sidebar", "footer", "metadata"]).describe("A semantic page section used by Exa content extraction.")).min(1).describe("Only include content from these semantic page sections.").optional(),
+      excludeSections: external_exports.array(external_exports.enum(["header", "navigation", "banner", "body", "sidebar", "footer", "metadata"]).describe("A semantic page section used by Exa content extraction.")).min(1).describe("Exclude content from these semantic page sections.").optional()
+    }).describe("Advanced configuration for Exa text extraction.")]).optional(),
+    highlights: external_exports.union([external_exports.boolean().describe("Whether Exa should return highlights."), external_exports.strictObject({
+      maxCharacters: external_exports.int().min(1).describe("The maximum number of characters to return across highlights.").optional(),
+      numSentences: external_exports.int().min(1).describe("Deprecated by Exa. The number of sentences to include in each highlight snippet.").optional(),
+      highlightsPerUrl: external_exports.int().min(1).describe("Deprecated by Exa. The number of highlight snippets to return per URL.").optional(),
+      query: external_exports.string().min(1).describe("A custom query that guides Exa highlight selection.").optional()
+    }).describe("Advanced configuration for Exa highlights.")]).optional(),
+    summary: external_exports.strictObject({
+      query: external_exports.string().min(1).describe("A custom query that guides Exa summary generation.").optional(),
+      schema: external_exports.looseObject({}).describe("A JSON Schema object used for structured Exa summaries.").optional()
+    }).describe("Configuration for an Exa summary response.").optional(),
+    livecrawlTimeout: external_exports.int().min(0).describe("The livecrawl timeout in milliseconds.").optional(),
+    maxAgeHours: external_exports.union([external_exports.literal(-1), external_exports.int().min(0).describe("A non-negative cache age in hours.")]).describe("Maximum age of cached content in hours. Use -1 to always use cache, 0 to always livecrawl, or a positive integer to require fresher content.").optional(),
+    subpages: external_exports.int().min(0).describe("The maximum number of subpages Exa should crawl per result.").optional(),
+    subpageTarget: external_exports.union([external_exports.string().min(1).describe("A single keyword used to locate relevant subpages."), external_exports.array(external_exports.string().min(1)).min(1).describe("A list of keywords used to locate relevant subpages.")]).describe("Keywords Exa should use when selecting subpages.").optional(),
+    extras: external_exports.strictObject({
+      links: external_exports.int().min(0).describe("The maximum number of webpage links to return for each result.").optional(),
+      imageLinks: external_exports.int().min(0).describe("The maximum number of image links to return for each result.").optional()
+    }).describe("Additional Exa extraction options.").optional()
+  }).describe("The Exa contents request object.").optional()
+}).describe("The input payload for an Exa findSimilar request. includeDomains and excludeDomains cannot be provided together.");
+var findSimilarOutput = external_exports.strictObject({
+  requestId: external_exports.string().describe("The unique identifier for this Exa request."),
+  results: external_exports.array(external_exports.looseObject({
+    id: external_exports.string().describe("The temporary Exa document identifier.").optional(),
+    url: external_exports.string().describe("The result URL.").optional(),
+    title: external_exports.string().describe("The result title.").optional(),
+    publishedDate: external_exports.string().describe("The estimated publication timestamp for the result.").nullable().optional(),
+    author: external_exports.string().describe("The result author.").nullable().optional(),
+    score: external_exports.number().describe("The result relevance score.").nullable().optional()
+  }).describe("An Exa search or contents result object.")).describe("The Exa similar-page results."),
+  costDollars: external_exports.looseObject({
+    total: external_exports.number().describe("The total request cost in US dollars.").optional()
+  }).describe("The Exa costDollars object.").optional()
+}).describe("The response payload for exa.find_similar.");
+var exaActions = {
+  search: {
+    description: "Search the web with Exa and optionally enrich each result with contents.",
+    effect: "write",
+    inputSchema: searchInput,
+    outputSchema: external_exports.toJSONSchema(searchOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_contents: {
+    description: "Fetch text, highlights, or summaries from Exa for URLs or document IDs.",
+    effect: "read",
+    inputSchema: getContentsInput,
+    outputSchema: external_exports.toJSONSchema(getContentsOutput, { io: "output", unrepresentable: "any" })
+  },
+  answer: {
+    description: "Generate a citation-backed answer from Exa search results.",
+    effect: "write",
+    inputSchema: answerInput,
+    outputSchema: external_exports.toJSONSchema(answerOutput, { io: "output", unrepresentable: "any" })
+  },
+  find_similar: {
+    description: "Find pages similar to a given URL and optionally enrich them with contents.",
+    effect: "read",
+    inputSchema: findSimilarInput,
+    outputSchema: external_exports.toJSONSchema(findSimilarOutput, { io: "output", unrepresentable: "any" })
+  }
+};
+
+// ../plugins/src/exa/index.ts
+function createExaPlugin() {
+  return createProviderPlugin({
+    description: "Exa",
+    actions: exaActions,
+    handlers: {
+      search,
+      get_contents: getContents,
+      answer,
+      find_similar: findSimilar
+    }
+  });
+}
+var exa_default = createExaPlugin();
+export {
+  createExaPlugin,
+  exa_default as default
+};