@tool-bridge/server 0.1.1 → 0.3.0

package/dist/ipqualityscore-MKTRXIZJ.js

@@ -0,0 +1,287 @@
+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/ipqualityscore/api.ts
+var SERVICE = "ipqualityscore";
+var API_BASE = "https://www.ipqualityscore.com";
+var IP_LITERAL = external_exports.union([external_exports.ipv4(), external_exports.ipv6()]);
+function optionalText(value) {
+  return value?.trim() || void 0;
+}
+function pathValue(value, field) {
+  const trimmed = value.trim();
+  if (trimmed === "") throw new TBError("invalid_argument", `${field} \u4E0D\u80FD\u4E3A\u7A7A`);
+  return trimmed;
+}
+function messageOf(payload) {
+  if (typeof payload === "string") return optionalText(payload);
+  if (payload === null || typeof payload !== "object" || Array.isArray(payload)) return void 0;
+  const record = payload;
+  const pick = (value) => typeof value === "string" ? optionalText(value) : void 0;
+  return pick(record.message) ?? pick(record.error);
+}
+function ipqsError(response, payload) {
+  const message = messageOf(payload) ?? optionalText(response.statusText) ?? `IPQualityScore request failed with ${response.status}`;
+  const lower = message.toLowerCase();
+  if (response.status === 429 || response.status === 402 || lower.includes("insufficient credits")) {
+    return upstreamError(429, message);
+  }
+  if (lower.includes("invalid api key") || lower.includes("api key") || response.status === 401 || response.status === 403) {
+    return upstreamError(401, message);
+  }
+  if (response.status === 400 || lower.includes("invalid ip") || lower.includes("invalid email") || lower.includes("invalid phone") || lower.includes("invalid url")) {
+    return upstreamError(400, message);
+  }
+  return upstreamError(response.status >= 400 ? response.status : 502, message);
+}
+async function readPayload(response) {
+  const body = await response.text();
+  if (body === "") return null;
+  try {
+    return JSON.parse(body);
+  } catch {
+    return body;
+  }
+}
+async function request(ctx, family, value, query = []) {
+  const path = `/api/json/${family}/${encodeURIComponent(requireApiKey(ctx, SERVICE))}/${encodeURIComponent(value)}`;
+  const url = new URL(path, API_BASE);
+  for (const [key, queryValue] of query) {
+    if (queryValue !== void 0) url.searchParams.append(key, queryValue);
+  }
+  let response;
+  let payload;
+  try {
+    response = await guardedFetch(url.toString(), {
+      method: "GET",
+      headers: { accept: "application/json" }
+    });
+    payload = await readPayload(response);
+  } catch (error) {
+    throw new TBError(
+      "unavailable",
+      error instanceof Error ? `IPQualityScore \u8BF7\u6C42\u5931\u8D25: ${error.message}` : "IPQualityScore \u8BF7\u6C42\u5931\u8D25",
+      { retryable: true }
+    );
+  }
+  if (!response.ok) throw ipqsError(response, payload);
+  if (payload === null || typeof payload !== "object" || Array.isArray(payload)) {
+    throw new TBError("unavailable", `IPQualityScore \u5BF9 ${family} \u7684\u54CD\u5E94\u4E0D\u662F JSON \u5BF9\u8C61`, { retryable: true });
+  }
+  if (payload.success === false) throw ipqsError(response, payload);
+  return payload;
+}
+async function checkIpReputation(input, ctx) {
+  const ipAddress = pathValue(input.ipAddress, "ipAddress");
+  if (!IP_LITERAL.safeParse(ipAddress).success) {
+    throw new TBError("invalid_argument", "ipAddress \u5FC5\u987B\u662F\u5408\u6CD5\u7684 IPv4 \u6216 IPv6 \u5730\u5740");
+  }
+  return await request(ctx, "ip", ipAddress, [
+    ["strictness", input.strictness?.toString()],
+    ["allow_public_access_points", input.allowPublicAccessPoints?.toString()],
+    ["user_agent", optionalText(input.userAgent)],
+    ["user_language", optionalText(input.userLanguage)]
+  ]);
+}
+async function validateEmail(input, ctx) {
+  return await request(ctx, "email", pathValue(input.email, "email"), [
+    ["timeout", input.timeout?.toString()],
+    ["abuse_strictness", input.abuseStrictness?.toString()]
+  ]);
+}
+async function validatePhone(input, ctx) {
+  return await request(ctx, "phone", pathValue(input.phone, "phone"), [
+    ["strictness", input.strictness?.toString()],
+    // 多个候选国家是重复的 `country[]`,且上游只认大写的 ISO alpha-2。
+    ...(input.country ?? []).map((code) => ["country[]", code.toUpperCase()])
+  ]);
+}
+async function scanUrl(input, ctx) {
+  return await request(ctx, "url", pathValue(input.url, "url"), [
+    ["strictness", input.strictness?.toString()]
+  ]);
+}
+
+// ../plugins/src/ipqualityscore/schema.ts
+var checkIpReputationInput = external_exports.strictObject({
+  ipAddress: external_exports.string().min(1).describe("The IPv4 or IPv6 address to inspect."),
+  strictness: external_exports.int().min(0).max(3).describe("How strict IPQS should be when scoring the lookup. Higher values may increase false positives.").optional(),
+  allowPublicAccessPoints: external_exports.boolean().describe("Whether to reduce risk flags for public access points such as schools or libraries.").optional(),
+  userAgent: external_exports.string().min(1).describe("The user agent associated with the IP lookup.").optional(),
+  userLanguage: external_exports.string().min(1).describe("The browser language associated with the IP lookup.").optional()
+}).describe("Input for checking IP address reputation with IPQualityScore.");
+var checkIpReputationOutput = external_exports.looseObject({
+  success: external_exports.boolean().describe("Whether IPQS completed the IP reputation lookup successfully."),
+  message: external_exports.string().describe("Human-readable status message returned by IPQS."),
+  fraud_score: external_exports.int().min(0).max(100).describe("The risk score returned by IPQS from 0 to 100."),
+  country_code: external_exports.string().describe("The two-letter country code associated with the IP.").nullable().optional(),
+  region: external_exports.string().describe("The region associated with the IP.").nullable().optional(),
+  city: external_exports.string().describe("The city associated with the IP.").nullable().optional(),
+  ISP: external_exports.string().describe("The internet service provider associated with the IP.").nullable().optional(),
+  ASN: external_exports.int().describe("The autonomous system number associated with the IP.").nullable().optional(),
+  organization: external_exports.string().describe("The organization associated with the IP.").nullable().optional(),
+  is_crawler: external_exports.boolean().describe("Whether IPQS identified the IP as a crawler.").optional(),
+  timezone: external_exports.string().describe("The timezone associated with the IP.").nullable().optional(),
+  mobile: external_exports.boolean().describe("Whether the IP appears to belong to a mobile connection.").optional(),
+  host: external_exports.string().describe("The host associated with the IP.").nullable().optional(),
+  proxy: external_exports.boolean().describe("Whether IPQS identified the IP as a proxy.").optional(),
+  vpn: external_exports.boolean().describe("Whether IPQS identified the IP as a VPN.").optional(),
+  tor: external_exports.boolean().describe("Whether IPQS identified the IP as Tor.").optional(),
+  active_vpn: external_exports.boolean().describe("Whether IPQS identified an active VPN connection.").optional(),
+  active_tor: external_exports.boolean().describe("Whether IPQS identified an active Tor connection.").optional(),
+  recent_abuse: external_exports.boolean().describe("Whether IPQS has seen recent abuse from the IP.").optional(),
+  bot_status: external_exports.boolean().describe("Whether IPQS identified bot behavior for the IP.").optional(),
+  connection_type: external_exports.string().describe("The connection type associated with the IP.").nullable().optional(),
+  abuse_velocity: external_exports.string().describe("The recent abuse velocity associated with the IP.").nullable().optional(),
+  request_id: external_exports.string().describe("The IPQS request identifier for support and tracing.").optional()
+}).describe("IP reputation result returned by IPQualityScore.");
+var validateEmailInput = external_exports.strictObject({
+  email: external_exports.email().describe("The email address to validate."),
+  timeout: external_exports.int().min(1).max(60).describe("Maximum number of seconds IPQS should spend on mail service provider checks.").optional(),
+  abuseStrictness: external_exports.int().min(0).max(3).describe("How strict IPQS should be when scoring the lookup. Higher values may increase false positives.").optional()
+}).describe("Input for validating an email address with IPQualityScore.");
+var validateEmailOutput = external_exports.looseObject({
+  success: external_exports.boolean().describe("Whether IPQS completed the email validation lookup successfully."),
+  message: external_exports.string().describe("Human-readable status message returned by IPQS."),
+  valid: external_exports.boolean().describe("Whether IPQS considers the email address valid."),
+  disposable: external_exports.boolean().describe("Whether the email address belongs to a disposable email provider.").optional(),
+  smtp_score: external_exports.int().describe("The SMTP deliverability score returned by IPQS.").nullable().optional(),
+  overall_score: external_exports.int().describe("The overall email quality score returned by IPQS.").nullable().optional(),
+  first_name: external_exports.string().describe("The first name inferred by IPQS, when available.").nullable().optional(),
+  generic: external_exports.boolean().describe("Whether IPQS considers the email address generic.").optional(),
+  common: external_exports.boolean().describe("Whether the email address is commonly used.").optional(),
+  dns_valid: external_exports.boolean().describe("Whether DNS records for the email domain are valid.").optional(),
+  honeypot: external_exports.boolean().describe("Whether IPQS identified the email as a honeypot.").optional(),
+  deliverability: external_exports.string().describe("The deliverability classification returned by IPQS.").nullable().optional(),
+  frequent_complainer: external_exports.boolean().describe("Whether the email is associated with frequent complaints.").optional(),
+  spam_trap_score: external_exports.string().describe("The spam trap score returned by IPQS.").nullable().optional(),
+  catch_all: external_exports.boolean().describe("Whether the email domain accepts all mailbox names.").optional(),
+  timed_out: external_exports.boolean().describe("Whether IPQS timed out during provider checks.").optional(),
+  suspect: external_exports.boolean().describe("Whether IPQS considers the email suspicious.").optional(),
+  recent_abuse: external_exports.boolean().describe("Whether IPQS has seen recent abuse for the email.").optional(),
+  fraud_score: external_exports.int().min(0).max(100).describe("The risk score returned by IPQS from 0 to 100.").optional(),
+  suggested_domain: external_exports.string().describe("Suggested corrected domain for possible typos.").nullable().optional(),
+  leaked: external_exports.boolean().describe("Whether IPQS found the email in leaked data.").optional(),
+  sanitized_email: external_exports.email().describe("The normalized email address returned by IPQS.").optional(),
+  request_id: external_exports.string().describe("The IPQS request identifier for support and tracing.").optional()
+}).describe("Email validation result returned by IPQualityScore.");
+var validatePhoneInput = external_exports.strictObject({
+  phone: external_exports.string().min(1).describe("The phone number to validate."),
+  country: external_exports.array(external_exports.string().min(2).max(2).regex(new RegExp("^[A-Za-z]{2}$")).describe("An ISO 3166-1 alpha-2 country code.")).min(1).describe("Optional ISO 3166-1 alpha-2 countries to use when interpreting local numbers.").optional(),
+  strictness: external_exports.int().min(0).max(3).describe("How strict IPQS should be when scoring the lookup. Higher values may increase false positives.").optional()
+}).describe("Input for validating a phone number with IPQualityScore.");
+var validatePhoneOutput = external_exports.looseObject({
+  success: external_exports.boolean().describe("Whether IPQS completed the phone validation lookup successfully."),
+  message: external_exports.string().describe("Human-readable status message returned by IPQS."),
+  formatted: external_exports.string().describe("The formatted phone number returned by IPQS.").nullable().optional(),
+  local_format: external_exports.string().describe("The local phone number format returned by IPQS.").nullable().optional(),
+  valid: external_exports.boolean().describe("Whether IPQS considers the phone number valid."),
+  fraud_score: external_exports.int().min(0).max(100).describe("The risk score returned by IPQS from 0 to 100.").optional(),
+  recent_abuse: external_exports.boolean().describe("Whether IPQS has seen recent abuse for the phone number.").optional(),
+  VOIP: external_exports.boolean().describe("Whether the phone number appears to be a VoIP number.").optional(),
+  prepaid: external_exports.boolean().describe("Whether the phone number appears to be prepaid.").optional(),
+  risky: external_exports.boolean().describe("Whether IPQS considers the phone number risky.").optional(),
+  active: external_exports.boolean().describe("Whether IPQS considers the phone number active.").optional(),
+  name: external_exports.string().describe("The phone owner name returned by IPQS, when available.").nullable().optional(),
+  carrier: external_exports.string().describe("The carrier associated with the phone number.").nullable().optional(),
+  line_type: external_exports.string().describe("The line type associated with the phone number.").nullable().optional(),
+  country: external_exports.string().describe("The country associated with the phone number.").nullable().optional(),
+  city: external_exports.string().describe("The city associated with the phone number.").nullable().optional(),
+  zip_code: external_exports.string().describe("The postal code associated with the phone number.").nullable().optional(),
+  region: external_exports.string().describe("The region associated with the phone number.").nullable().optional(),
+  dialing_code: external_exports.int().describe("The international dialing code associated with the phone number.").nullable().optional(),
+  sms_pumping: external_exports.looseObject({
+    risk_score: external_exports.int().min(0).max(100).describe("The risk score returned by IPQS from 0 to 100.").optional(),
+    message: external_exports.string().describe("Human-readable SMS pumping risk message returned by IPQS.").optional(),
+    velocity: external_exports.string().describe("SMS pumping velocity classification returned by IPQS.").optional()
+  }).describe("SMS pumping risk details returned by IPQS.").optional(),
+  request_id: external_exports.string().describe("The IPQS request identifier for support and tracing.").optional()
+}).describe("Phone validation result returned by IPQualityScore.");
+var scanUrlInput = external_exports.strictObject({
+  url: external_exports.string().min(1).describe("The URL or domain to scan."),
+  strictness: external_exports.int().min(0).max(2).describe("How strict IPQS should be when scanning the URL. Higher values may increase false positives.").optional()
+}).describe("Input for scanning a URL or domain with IPQualityScore.");
+var scanUrlOutput = external_exports.looseObject({
+  success: external_exports.boolean().describe("Whether IPQS completed the URL scan successfully."),
+  message: external_exports.string().describe("Human-readable status message returned by IPQS."),
+  unsafe: external_exports.boolean().describe("Whether IPQS considers the URL unsafe."),
+  domain: external_exports.string().describe("The domain parsed from the submitted URL.").nullable().optional(),
+  root_domain: external_exports.string().describe("The root domain parsed from the submitted URL.").nullable().optional(),
+  ip_address: external_exports.string().describe("The IP address associated with the domain.").nullable().optional(),
+  server: external_exports.string().describe("The server header or hosting stack returned by IPQS.").nullable().optional(),
+  content_type: external_exports.string().describe("The content type returned by IPQS.").nullable().optional(),
+  status_code: external_exports.int().describe("The HTTP status code returned by IPQS.").nullable().optional(),
+  page_size: external_exports.int().describe("The page size returned by IPQS.").nullable().optional(),
+  domain_rank: external_exports.int().describe("The domain rank returned by IPQS.").nullable().optional(),
+  dns_valid: external_exports.boolean().describe("Whether DNS records for the domain are valid.").optional(),
+  parking: external_exports.boolean().describe("Whether IPQS considers the domain parked.").optional(),
+  spamming: external_exports.boolean().describe("Whether IPQS associates the URL with spam.").optional(),
+  malware: external_exports.boolean().describe("Whether IPQS associates the URL with malware.").optional(),
+  phishing: external_exports.boolean().describe("Whether IPQS associates the URL with phishing.").optional(),
+  suspicious: external_exports.boolean().describe("Whether IPQS considers the URL suspicious.").optional(),
+  adult: external_exports.boolean().describe("Whether IPQS classifies the URL as adult content.").optional(),
+  risk_score: external_exports.int().min(0).max(100).describe("The risk score returned by IPQS from 0 to 100.").optional(),
+  domain_age: external_exports.looseObject({
+    human: external_exports.string().describe("Human-readable domain age returned by IPQS.").nullable().optional(),
+    timestamp: external_exports.int().describe("Domain creation timestamp returned by IPQS.").nullable().optional(),
+    iso: external_exports.string().describe("Domain creation date returned by IPQS.").nullable().optional()
+  }).describe("Domain age details returned by IPQualityScore.").optional(),
+  category: external_exports.string().describe("The content category returned by IPQS.").nullable().optional(),
+  domain_trust: external_exports.string().describe("The domain trust classification returned by IPQS.").nullable().optional(),
+  request_id: external_exports.string().describe("The IPQS request identifier for support and tracing.").optional()
+}).describe("URL reputation result returned by IPQualityScore.");
+var ipqualityscoreActions = {
+  check_ip_reputation: {
+    description: "Check an IP address for proxy, VPN, Tor, bot, and abuse risk signals.",
+    effect: "read",
+    inputSchema: checkIpReputationInput,
+    outputSchema: external_exports.toJSONSchema(checkIpReputationOutput, { io: "output", unrepresentable: "any" })
+  },
+  validate_email: {
+    description: "Validate an email address and return deliverability and abuse risk signals.",
+    effect: "write",
+    inputSchema: validateEmailInput,
+    outputSchema: external_exports.toJSONSchema(validateEmailOutput, { io: "output", unrepresentable: "any" })
+  },
+  validate_phone: {
+    description: "Validate a phone number and return carrier, activity, and risk signals.",
+    effect: "write",
+    inputSchema: validatePhoneInput,
+    outputSchema: external_exports.toJSONSchema(validatePhoneOutput, { io: "output", unrepresentable: "any" })
+  },
+  scan_url: {
+    description: "Scan a URL or domain and return malware, phishing, and domain risk signals.",
+    effect: "write",
+    inputSchema: scanUrlInput,
+    outputSchema: external_exports.toJSONSchema(scanUrlOutput, { io: "output", unrepresentable: "any" })
+  }
+};
+
+// ../plugins/src/ipqualityscore/index.ts
+function createIpqualityscorePlugin() {
+  return createProviderPlugin({
+    description: "IPQualityScore",
+    actions: ipqualityscoreActions,
+    handlers: {
+      check_ip_reputation: checkIpReputation,
+      validate_email: validateEmail,
+      validate_phone: validatePhone,
+      scan_url: scanUrl
+    }
+  });
+}
+var ipqualityscore_default = createIpqualityscorePlugin();
+export {
+  createIpqualityscorePlugin,
+  ipqualityscore_default as default
+};

package/dist/jina_ai-MRHPCSV5.js

@@ -0,0 +1,119 @@
+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/jina_ai/api.ts
+var SERVICE = "jina_ai";
+var API_BASE = "https://api.jina.ai";
+var REQUEST_TIMEOUT_MS = 3e4;
+function record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function text(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+function errorMessage(status, body, payload) {
+  const top = record(payload);
+  return text(top?.detail) ?? text(top?.message) ?? text(body) ?? `Jina AI request failed with ${status}`;
+}
+async function request(ctx, path, body) {
+  const apiKey = requireApiKey(ctx, SERVICE);
+  const timeoutSignal = AbortSignal.timeout(REQUEST_TIMEOUT_MS);
+  let response;
+  try {
+    response = await guardedFetch(`${API_BASE}${path}`, {
+      method: "POST",
+      headers: {
+        "accept": "application/json",
+        "authorization": `Bearer ${apiKey}`,
+        "content-type": "application/json"
+      },
+      body: JSON.stringify(body),
+      signal: timeoutSignal
+    });
+  } catch (error) {
+    if (error instanceof TBError) throw error;
+    if (timeoutSignal.aborted) throw upstreamError(504, `Jina AI ${REQUEST_TIMEOUT_MS / 1e3}s \u5185\u6CA1\u6709\u8FD4\u56DE`);
+    const message = error instanceof Error ? error.message : "unknown network error";
+    throw upstreamError(502, `Jina AI \u8BF7\u6C42\u5931\u8D25: ${message}`);
+  }
+  const raw = await response.text();
+  let payload = null;
+  if (raw !== "") {
+    try {
+      payload = JSON.parse(raw);
+    } catch {
+      if (response.ok) {
+        throw new TBError("unavailable", "Jina AI \u8FD4\u56DE\u4E86\u975E JSON \u54CD\u5E94", { retryable: true });
+      }
+    }
+  }
+  if (!response.ok) throw upstreamError(response.status, errorMessage(response.status, raw, payload));
+  return payload;
+}
+async function createEmbeddings(input, ctx) {
+  return request(ctx, "/v1/embeddings", input);
+}
+async function rerankDocuments(input, ctx) {
+  return request(ctx, "/v1/rerank", input);
+}
+
+// ../plugins/src/jina_ai/schema.ts
+var createEmbeddingsInput = external_exports.strictObject({
+  model: external_exports.string().describe("The Jina AI embedding model identifier."),
+  input: external_exports.array(external_exports.union([external_exports.string().describe("Text to embed."), external_exports.looseObject({}).describe("A JSON object returned by Jina AI.")]).describe("A text or multimodal embedding input.")).min(1).describe("The texts or multimodal inputs to embed."),
+  encoding_format: external_exports.string().describe("The encoding format for returned embeddings.").optional(),
+  dimensions: external_exports.int().describe("The requested embedding dimensionality.").optional(),
+  normalized: external_exports.boolean().describe("Whether returned embeddings should be normalized.").optional()
+}).describe("Input for generating embeddings with Jina AI.");
+var createEmbeddingsOutput = external_exports.looseObject({}).describe("A JSON object returned by Jina AI.");
+var rerankDocumentsInput = external_exports.strictObject({
+  model: external_exports.string().describe("The Jina AI reranker model identifier."),
+  query: external_exports.string().describe("The query used to rank documents."),
+  documents: external_exports.array(external_exports.string().describe("A document to rank.")).min(1).describe("The documents to rank."),
+  top_n: external_exports.int().describe("The maximum number of results to return.").optional(),
+  return_documents: external_exports.boolean().describe("Whether to include document text in each result.").optional()
+}).describe("Input for ranking documents by relevance with Jina AI.");
+var rerankDocumentsOutput = external_exports.looseObject({}).describe("A JSON object returned by Jina AI.");
+var jinaAiActions = {
+  create_embeddings: {
+    description: "Create vector embeddings for text or multimodal inputs with Jina AI.",
+    effect: "write",
+    inputSchema: createEmbeddingsInput,
+    outputSchema: external_exports.toJSONSchema(createEmbeddingsOutput, { io: "output", unrepresentable: "any" })
+  },
+  rerank_documents: {
+    description: "Rank documents by relevance to a query with Jina AI.",
+    effect: "write",
+    inputSchema: rerankDocumentsInput,
+    outputSchema: external_exports.toJSONSchema(rerankDocumentsOutput, { io: "output", unrepresentable: "any" })
+  }
+};
+
+// ../plugins/src/jina_ai/index.ts
+function createJinaAiPlugin() {
+  return createProviderPlugin({
+    description: "Jina AI",
+    actions: jinaAiActions,
+    handlers: {
+      create_embeddings: createEmbeddings,
+      rerank_documents: rerankDocuments
+    }
+  });
+}
+var jina_ai_default = createJinaAiPlugin();
+export {
+  createJinaAiPlugin,
+  jina_ai_default as default
+};