@sisu-ai/tool-wikipedia 8.0.1 → 8.0.3

package/README.md

@@ -1,3 +1,9 @@
+<div align="right">
+  <a href="https://github.com/finger-gun/sisu"><img src="https://github.com/finger-gun/sisu/raw/main/sisu-light.svg" alt="ProjectSpecs" width="100" /></a>
+</div>
+
+---
+
 # @sisu-ai/tool-wikipedia
 
 Wikipedia lookup tool using the REST API. Fetch a page summary, HTML, or related pages given an approximate title. The REST API performs redirects and normalization, so near-matches often resolve.
@@ -55,3 +61,78 @@ Discover what you can do through examples or documentation. Check it out at http
 - [License](https://github.com/finger-gun/sisu/blob/main/LICENSE)
 - [Report a Bug](https://github.com/finger-gun/sisu/issues/new?template=bug_report.md)
 - [Request a Feature](https://github.com/finger-gun/sisu/issues/new?template=feature_request.md)
+
+---
+
+## Documentation
+
+**Core** — [Package docs](packages/core/README.md) · [Error types](packages/core/ERROR_TYPES.md)
+
+**Adapters** — [OpenAI](packages/adapters/openai/README.md) · [Anthropic](packages/adapters/anthropic/README.md) · [Ollama](packages/adapters/ollama/README.md)
+
+<details>
+<summary>All middleware packages</summary>
+
+- [@sisu-ai/mw-agent-run-api](packages/middleware/agent-run-api/README.md)
+- [@sisu-ai/mw-context-compressor](packages/middleware/context-compressor/README.md)
+- [@sisu-ai/mw-control-flow](packages/middleware/control-flow/README.md)
+- [@sisu-ai/mw-conversation-buffer](packages/middleware/conversation-buffer/README.md)
+- [@sisu-ai/mw-cors](packages/middleware/cors/README.md)
+- [@sisu-ai/mw-error-boundary](packages/middleware/error-boundary/README.md)
+- [@sisu-ai/mw-guardrails](packages/middleware/guardrails/README.md)
+- [@sisu-ai/mw-invariants](packages/middleware/invariants/README.md)
+- [@sisu-ai/mw-orchestration](packages/middleware/orchestration/README.md)
+- [@sisu-ai/mw-rag](packages/middleware/rag/README.md)
+- [@sisu-ai/mw-react-parser](packages/middleware/react-parser/README.md)
+- [@sisu-ai/mw-register-tools](packages/middleware/register-tools/README.md)
+- [@sisu-ai/mw-tool-calling](packages/middleware/tool-calling/README.md)
+- [@sisu-ai/mw-trace-viewer](packages/middleware/trace-viewer/README.md)
+- [@sisu-ai/mw-usage-tracker](packages/middleware/usage-tracker/README.md)
+</details>
+
+<details>
+<summary>All tool packages</summary>
+
+- [@sisu-ai/tool-aws-s3](packages/tools/aws-s3/README.md)
+- [@sisu-ai/tool-azure-blob](packages/tools/azure-blob/README.md)
+- [@sisu-ai/tool-extract-urls](packages/tools/extract-urls/README.md)
+- [@sisu-ai/tool-github-projects](packages/tools/github-projects/README.md)
+- [@sisu-ai/tool-summarize-text](packages/tools/summarize-text/README.md)
+- [@sisu-ai/tool-terminal](packages/tools/terminal/README.md)
+- [@sisu-ai/tool-vec-chroma](packages/tools/vec-chroma/README.md)
+- [@sisu-ai/tool-web-fetch](packages/tools/web-fetch/README.md)
+- [@sisu-ai/tool-web-search-duckduckgo](packages/tools/web-search-duckduckgo/README.md)
+- [@sisu-ai/tool-web-search-google](packages/tools/web-search-google/README.md)
+- [@sisu-ai/tool-web-search-openai](packages/tools/web-search-openai/README.md)
+- [@sisu-ai/tool-wikipedia](packages/tools/wikipedia/README.md)
+</details>
+
+<details>
+<summary>All examples</summary>
+
+**Anthropic** — [hello](examples/anthropic-hello/README.md) · [control-flow](examples/anthropic-control-flow/README.md) · [stream](examples/anthropic-stream/README.md) · [weather](examples/anthropic-weather/README.md)
+
+**Ollama** — [hello](examples/ollama-hello/README.md) · [stream](examples/ollama-stream/README.md) · [vision](examples/ollama-vision/README.md) · [weather](examples/ollama-weather/README.md) · [web-search](examples/ollama-web-search/README.md)
+
+**OpenAI** — [hello](examples/openai-hello/README.md) · [weather](examples/openai-weather/README.md) · [stream](examples/openai-stream/README.md) · [vision](examples/openai-vision/README.md) · [reasoning](examples/openai-reasoning/README.md) · [react](examples/openai-react/README.md) · [control-flow](examples/openai-control-flow/README.md) · [branch](examples/openai-branch/README.md) · [parallel](examples/openai-parallel/README.md) · [graph](examples/openai-graph/README.md) · [orchestration](examples/openai-orchestration/README.md) · [orchestration-adaptive](examples/openai-orchestration-adaptive/README.md) · [guardrails](examples/openai-guardrails/README.md) · [error-handling](examples/openai-error-handling/README.md) · [rag-chroma](examples/openai-rag-chroma/README.md) · [web-search](examples/openai-web-search/README.md) · [web-fetch](examples/openai-web-fetch/README.md) · [wikipedia](examples/openai-wikipedia/README.md) · [terminal](examples/openai-terminal/README.md) · [github-projects](examples/openai-github-projects/README.md) · [server](examples/openai-server/README.md) · [aws-s3](examples/openai-aws-s3/README.md) · [azure-blob](examples/openai-azure-blob/README.md)
+</details>
+
+---
+
+## Contributing
+
+We build Sisu in the open. Contributions welcome.
+
+[Contributing Guide](CONTRIBUTING.md) · [Report a Bug](https://github.com/finger-gun/sisu/issues/new?template=bug_report.md) · [Request a Feature](https://github.com/finger-gun/sisu/issues/new?template=feature_request.md) · [Code of Conduct](CODE_OF_CONDUCT.md)
+
+---
+
+<div align="center">
+
+**[Star on GitHub](https://github.com/finger-gun/sisu)** if Sisu helps you build better agents.
+
+*Quiet, determined, relentlessly useful.*
+
+[Apache 2.0 License](LICENSE)
+
+</div>

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import type { Tool } from '@sisu-ai/core';
-export type WikipediaFormat = 'summary' | 'html' | 'related';
+import type { Tool } from "@sisu-ai/core";
+export type WikipediaFormat = "summary" | "html" | "related";
 export interface WikipediaArgs {
     title: string;
     format?: WikipediaFormat;

package/dist/index.js

@@ -1,35 +1,40 @@
-import { firstConfigValue } from '@sisu-ai/core';
-import { z } from 'zod';
+import { firstConfigValue } from "@sisu-ai/core";
+import { z } from "zod";
 export const wikipedia = {
-    name: 'wikipediaLookup',
-    description: 'Fetch a Wikipedia page summary, HTML, or related pages given an approximate title. Defaults to summary.',
+    name: "wikipediaLookup",
+    description: "Fetch a Wikipedia page summary, HTML, or related pages given an approximate title. Defaults to summary.",
     schema: z.object({
         title: z.string().min(1),
-        format: z.enum(['summary', 'html', 'related']).optional(),
+        format: z.enum(["summary", "html", "related"]).optional(),
         lang: z.string().min(2).max(10).optional(),
     }),
-    handler: async ({ title, format = 'summary', lang }, ctx) => {
+    handler: async ({ title, format = "summary", lang }, ctx) => {
         const base = resolveBaseUrl(ctx, lang);
-        if (format === 'html')
+        if (format === "html")
             return fetchHtml(base, title);
-        if (format === 'related')
+        if (format === "related")
             return fetchRelated(base, title);
         return fetchSummary(base, title);
-    }
+    },
 };
 export default wikipedia;
 function resolveBaseUrl(ctx, lang) {
     // Precedence: CLI flags (via core helpers) > env vars; allow overriding full base or just language
-    const baseFromFlags = firstConfigValue(['WIKIPEDIA_BASE_URL', 'WIKI_BASE_URL']);
-    const langFromFlags = firstConfigValue(['WIKIPEDIA_LANG', 'WIKI_LANG']) || lang;
+    const baseFromFlags = firstConfigValue([
+        "WIKIPEDIA_BASE_URL",
+        "WIKI_BASE_URL",
+    ]);
+    const langFromFlags = firstConfigValue(["WIKIPEDIA_LANG", "WIKI_LANG"]) || lang;
     if (baseFromFlags)
-        return baseFromFlags.replace(/\/$/, '');
-    const chosenLang = (langFromFlags || 'en').toLowerCase();
+        return baseFromFlags.replace(/\/$/, "");
+    const chosenLang = (langFromFlags || "en").toLowerCase();
     return `https://${chosenLang}.wikipedia.org/api/rest_v1`;
 }
 async function fetchSummary(baseUrl, title) {
     const url = `${baseUrl}/page/summary/${encodeURIComponent(title)}`;
-    const res = await fetch(url, { headers: { Accept: 'application/json' } });
+    const res = await globalThis.fetch(url, {
+        headers: { Accept: "application/json" },
+    });
     const raw = await res.text();
     if (!res.ok)
         throw new Error(`Wikipedia summary failed: ${res.status} ${res.statusText}`);
@@ -45,28 +50,32 @@ async function fetchSummary(baseUrl, title) {
 }
 async function fetchHtml(baseUrl, title) {
     const url = `${baseUrl}/page/html/${encodeURIComponent(title)}`;
-    const res = await fetch(url, { headers: { Accept: 'text/html' } });
+    const res = await globalThis.fetch(url, { headers: { Accept: "text/html" } });
     const raw = await res.text();
-    const ct = res.headers?.get?.('content-type') || '';
+    const ct = res.headers?.get?.("content-type") || "";
     if (!res.ok)
         throw new Error(`Wikipedia html failed: ${res.status} ${res.statusText}`);
-    if (!ct.toLowerCase().includes('text/html'))
+    if (!ct.toLowerCase().includes("text/html"))
         throw new Error(`Wikipedia html returned non-HTML content (content-type: ${ct})`);
     return raw;
 }
 async function fetchRelated(baseUrl, title) {
     const url = `${baseUrl}/page/related/${encodeURIComponent(title)}`;
-    const res = await fetch(url, { headers: { Accept: 'application/json' } });
+    const res = await globalThis.fetch(url, {
+        headers: { Accept: "application/json" },
+    });
     const raw = await res.text();
     if (!res.ok)
         throw new Error(`Wikipedia related failed: ${res.status} ${res.statusText}`);
     const json = raw ? JSON.parse(raw) : {};
     const pages = Array.isArray(json.pages) ? json.pages : [];
-    return pages.map(p => ({
-        title: String(p.title || ''),
+    return pages
+        .map((p) => ({
+        title: String(p.title || ""),
         description: p.description,
         extract: p.extract,
         url: p.content_urls?.desktop?.page,
         thumbnailUrl: p.thumbnail?.source,
-    })).filter(r => r.title);
+    }))
+        .filter((r) => r.title);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sisu-ai/tool-wikipedia",
-  "version": "8.0.1",
+  "version": "8.0.3",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.js",
@@ -12,7 +12,7 @@
     "zod": "^3.23.8"
   },
   "peerDependencies": {
-    "@sisu-ai/core": "^2.3.1"
+    "@sisu-ai/core": "^2.3.2"
   },
   "repository": {
     "type": "git",