jixu-tools-jina

jixu-tools-jina gives an Agent two explicit network capabilities: discover public webpages and read one known public URL. Credentials stay behind the Tool boundary rather than entering Events or Agent-visible inputs.

Install

npm install jixu-core jixu-tools-jina

Create the Tools

import { defineAgent } from "jixu-core";
import {
  createJinaWebReadTool,
  createJinaWebSearchTool,
} from "jixu-tools-jina";

const apiKey = process.env.JINA_API_KEY;
const webSearch = createJinaWebSearchTool({ apiKey });
const webRead = createJinaWebReadTool({ apiKey });

const agent = defineAgent({
  instructions: "Use web evidence carefully and cite resolved URLs.",
  model: { provider: "model", model: "configured-model" },
  modelCapabilities,
  tools: [webSearch, webRead],
});

Capabilities

Both Tools are declared idempotent and network-risking. They enforce request timeouts, response byte limits, content-length limits, cancellation, and typed upstream failures. Search returns an empty successful result when Jina reports no matches.

Trust boundary

Web content is untrusted evidence, not an instruction source and not durable authority. The Agent should inspect relevance, cite the resolved URL, and avoid treating retrieved text as privileged context.