@lgrammel/kiwix-tool 1.0.0

package/README.md

@@ -0,0 +1,32 @@
+# @lgrammel/kiwix-tool
+
+AI SDK 7 canary tool for reading local Kiwix/ZIM archives in Node.js with `@openzim/libzim`.
+
+```ts
+import { KiwixTools } from "@lgrammel/kiwix-tool";
+import { ToolLoopAgent } from "ai";
+
+const kiwix = new KiwixTools({
+  zimPath: "~/opt/zim/wikipedia.zim"
+});
+
+const agent = new ToolLoopAgent({
+  model,
+  instructions: "Answer using the local Wikipedia archive. Search before reading pages.",
+  tools: {
+    wikipediaSearch: kiwix.searchTool,
+    wikipediaRead: kiwix.readTool
+  }
+});
+
+const result = await agent.generate({
+  prompt: "What is Kiwix?"
+});
+```
+
+## Tools
+
+- `kiwixSearchTool`: full-text search. Input is only `{ query }`. Output is `results` with `title`, `path`, and optional `snippet`.
+- `kiwixReadTool`: read a page by exact path. Input is only `{ path }`. Output is `title`, `path`, `content`, and `truncated`.
+
+The model cannot choose limits. Search result count and page byte limits are fixed in `KiwixTools` constructor options so tool outputs stay small enough for agents. HTML pages are converted to UTF-8 text before returning them to the model.

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+import { type Tool } from "ai";
+import { z } from "zod";
+export declare const kiwixSearchInputSchema: z.ZodObject<{
+    query: z.ZodString;
+}, z.core.$strip>;
+export declare const kiwixReadInputSchema: z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strip>;
+export type KiwixSearchInput = z.input<typeof kiwixSearchInputSchema>;
+export type ParsedKiwixSearchInput = z.output<typeof kiwixSearchInputSchema>;
+export type KiwixReadInput = z.input<typeof kiwixReadInputSchema>;
+export type ParsedKiwixReadInput = z.output<typeof kiwixReadInputSchema>;
+export interface CreateKiwixToolOptions {
+    /**
+     * Path to the `.zim` file. A leading `~/` is expanded to the current user's home directory.
+     */
+    zimPath: string;
+    /**
+     * Fixed number of search results returned to the agent. This is intentionally not model-controlled.
+     */
+    searchResultLimit?: number;
+    /**
+     * Fixed maximum page bytes read before HTML-to-text conversion. This is intentionally not model-controlled.
+     */
+    readMaxBytes?: number;
+    /**
+     * Preload the full-text index when opening the archive.
+     */
+    preloadXapianDb?: boolean;
+    /**
+     * Number of directory entry ranges to preload when opening the archive.
+     */
+    preloadDirentRanges?: number;
+}
+export interface KiwixSearchResult {
+    title: string;
+    path: string;
+    snippet?: string;
+}
+export interface KiwixSearchOutput {
+    results: KiwixSearchResult[];
+}
+export interface KiwixReadOutput {
+    title: string;
+    path: string;
+    content: string;
+    truncated: boolean;
+}
+export type KiwixSearchTool = Tool<ParsedKiwixSearchInput, KiwixSearchOutput>;
+export type KiwixReadTool = Tool<ParsedKiwixReadInput, KiwixReadOutput>;
+export declare class KiwixReader {
+    #private;
+    readonly zimPath: string;
+    readonly searchResultLimit: number;
+    readonly readMaxBytes: number;
+    constructor(options: CreateKiwixToolOptions);
+    search(query: string): Promise<KiwixSearchOutput>;
+    readPath(path: string): Promise<KiwixReadOutput>;
+}
+export declare class KiwixTools {
+    #private;
+    readonly reader: KiwixReader;
+    constructor(options: CreateKiwixToolOptions);
+    get searchTool(): KiwixSearchTool;
+    get readTool(): KiwixReadTool;
+}
+export declare function createKiwixSearchTool(options: CreateKiwixToolOptions): KiwixSearchTool;
+export declare function createKiwixReadTool(options: CreateKiwixToolOptions): KiwixReadTool;
+export declare function kiwixSearchTool(reader: KiwixReader): KiwixSearchTool;
+export declare function kiwixReadTool(reader: KiwixReader): KiwixReadTool;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,IAAI,EAAE,MAAM,IAAI,CAAC;AAKrC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,sBAAsB;;iBAEjC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;iBAE/B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC7E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEzE,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAAC;AAC9E,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,oBAAoB,EAAE,eAAe,CAAC,CAAC;AAExE,qBAAa,WAAW;;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAOlB,OAAO,EAAE,sBAAsB;IASrC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAejD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAsCvD;AAED,qBAAa,UAAU;;IACrB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;gBAKjB,OAAO,EAAE,sBAAsB;IAI3C,IAAI,UAAU,IAAI,eAAe,CAGhC;IAED,IAAI,QAAQ,IAAI,aAAa,CAG5B;CACF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAGtF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,GAAG,aAAa,CAGlF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,eAAe,CAOpE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,CAMhE"}

package/dist/index.js

@@ -0,0 +1,167 @@
+import { tool } from "ai";
+import { convert as htmlToText } from "html-to-text";
+import { homedir } from "node:os";
+import { isAbsolute, join } from "node:path";
+import { z } from "zod";
+const DEFAULT_SEARCH_RESULT_LIMIT = 5;
+const MAX_SEARCH_RESULT_LIMIT = 10;
+const DEFAULT_READ_MAX_BYTES = 80 * 1024;
+const HARD_READ_MAX_BYTES = 512 * 1024;
+const MAX_SNIPPET_LENGTH = 600;
+export const kiwixSearchInputSchema = z.object({
+    query: z.string().min(1).describe("Full-text search query for the Kiwix archive."),
+});
+export const kiwixReadInputSchema = z.object({
+    path: z.string().min(1).describe("Exact ZIM page path returned by the search tool."),
+});
+export class KiwixReader {
+    zimPath;
+    searchResultLimit;
+    readMaxBytes;
+    #archive;
+    #libzim;
+    #searcher;
+    #options;
+    constructor(options) {
+        this.zimPath = resolveHomePath(options.zimPath);
+        this.searchResultLimit = clampSearchResultLimit(options.searchResultLimit ?? DEFAULT_SEARCH_RESULT_LIMIT);
+        this.readMaxBytes = clampReadMaxBytes(options.readMaxBytes ?? DEFAULT_READ_MAX_BYTES);
+        this.#options = options;
+    }
+    async search(query) {
+        const { Searcher } = await this.#loadLibzim();
+        this.#searcher ??= new Searcher(await this.#getArchive());
+        const search = this.#searcher.search(query);
+        const results = Array.from(search.getResults(0, this.searchResultLimit)).map((result) => ({
+            title: result.title,
+            path: result.path,
+            snippet: cleanSnippet(result.snippet),
+        }));
+        return { results };
+    }
+    async readPath(path) {
+        const entry = (await this.#getArchive()).getEntryByPath(path);
+        const item = entry.getItem(true);
+        const size = toSafeNumber(item.size);
+        const data = item.getData(0, Math.min(this.readMaxBytes, size)).data;
+        return {
+            title: entry.title,
+            path: entry.path,
+            content: formatPageContent(item, data),
+            truncated: data.byteLength < size,
+        };
+    }
+    #getArchive() {
+        this.#archive ??= this.#openArchive();
+        return this.#archive;
+    }
+    async #openArchive() {
+        const { Archive, OpenConfig } = await this.#loadLibzim();
+        const config = new OpenConfig();
+        if (this.#options.preloadXapianDb !== undefined) {
+            config.preloadXapianDb(this.#options.preloadXapianDb);
+        }
+        if (this.#options.preloadDirentRanges !== undefined) {
+            config.preloadDirentRanges(this.#options.preloadDirentRanges);
+        }
+        return new Archive(this.zimPath, config);
+    }
+    #loadLibzim() {
+        this.#libzim ??= import("@openzim/libzim");
+        return this.#libzim;
+    }
+}
+export class KiwixTools {
+    reader;
+    #searchTool;
+    #readTool;
+    constructor(options) {
+        this.reader = new KiwixReader(options);
+    }
+    get searchTool() {
+        this.#searchTool ??= kiwixSearchTool(this.reader);
+        return this.#searchTool;
+    }
+    get readTool() {
+        this.#readTool ??= kiwixReadTool(this.reader);
+        return this.#readTool;
+    }
+}
+export function createKiwixSearchTool(options) {
+    const reader = new KiwixReader(options);
+    return kiwixSearchTool(reader);
+}
+export function createKiwixReadTool(options) {
+    const reader = new KiwixReader(options);
+    return kiwixReadTool(reader);
+}
+export function kiwixSearchTool(reader) {
+    return tool({
+        description: "Search the local Kiwix archive. Returns page paths, titles, and short snippets. Use the read tool with a returned path to read a page.",
+        inputSchema: kiwixSearchInputSchema,
+        execute: async ({ query }) => reader.search(query),
+    });
+}
+export function kiwixReadTool(reader) {
+    return tool({
+        description: "Read one page from the local Kiwix archive by exact path from the search tool.",
+        inputSchema: kiwixReadInputSchema,
+        execute: async ({ path }) => reader.readPath(path),
+    });
+}
+function formatPageContent(item, data) {
+    if (!isTextMimeType(item.mimetype)) {
+        return `[${item.mimetype} content omitted: this Kiwix entry is not a text page.]`;
+    }
+    const text = data.toString("utf8");
+    if (!isHtmlMimeType(item.mimetype)) {
+        return text;
+    }
+    return htmlToText(text, {
+        selectors: [
+            { selector: "a", options: { ignoreHref: true } },
+            { selector: "img", format: "skip" },
+            { selector: "script", format: "skip" },
+            { selector: "style", format: "skip" },
+        ],
+        wordwrap: false,
+    });
+}
+function cleanSnippet(snippet) {
+    const text = htmlToText(snippet, { wordwrap: false }).replace(/\s+/g, " ").trim();
+    if (!text) {
+        return undefined;
+    }
+    return text.length > MAX_SNIPPET_LENGTH ? `${text.slice(0, MAX_SNIPPET_LENGTH).trim()}...` : text;
+}
+function isTextMimeType(mimeType) {
+    return (mimeType.startsWith("text/") ||
+        isHtmlMimeType(mimeType) ||
+        mimeType === "application/json" ||
+        mimeType === "application/xml" ||
+        mimeType === "application/xhtml+xml" ||
+        mimeType.endsWith("+json") ||
+        mimeType.endsWith("+xml"));
+}
+function isHtmlMimeType(mimeType) {
+    return mimeType === "text/html" || mimeType === "application/xhtml+xml";
+}
+function resolveHomePath(path) {
+    if (path === "~") {
+        return homedir();
+    }
+    if (path.startsWith("~/")) {
+        return join(homedir(), path.slice(2));
+    }
+    return isAbsolute(path) ? path : join(process.cwd(), path);
+}
+function clampSearchResultLimit(limit) {
+    return Math.min(Math.max(Math.trunc(limit), 1), MAX_SEARCH_RESULT_LIMIT);
+}
+function clampReadMaxBytes(maxBytes) {
+    return Math.min(Math.max(Math.trunc(maxBytes), 1), HARD_READ_MAX_BYTES);
+}
+function toSafeNumber(value) {
+    return typeof value === "bigint" ? Number(value) : value;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@lgrammel/kiwix-tool",
+  "version": "1.0.0",
+  "description": "AI SDK 7 tool for reading Kiwix/ZIM archives with Node.js libzim bindings.",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "dependencies": {
+    "@openzim/libzim": "^4.1.0",
+    "html-to-text": "^10.0.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/html-to-text": "^9.0.4",
+    "ai": "7.0.0-canary.120"
+  },
+  "peerDependencies": {
+    "ai": "7.0.0-canary.120"
+  }
+}