// tool-globals.d.ts — generated by axon prepare, do not edit // Every tool the capsule can call, declared as it is callable. // Mirrors the block the model receives — same source, same members. declare global { type QueryOptions = { /** Max results to return. Capped at 100 to stay within safe response size. Default: 10. */ limit?: number; /** Offset for pagination. Default: 0. */ offset?: number; /** Sort field. Default: "relevance". */ sortBy?: "relevance" | "submittedDate" | "lastUpdatedDate"; /** Sort direction. Default: "descending". */ sortOrder?: "ascending" | "descending"; }; type Paper = { /** arXiv ID without version suffix, e.g. "1706.03762". */ id: string; /** Full versioned ID as returned by the API, e.g. "1706.03762v7". */ versionedId: string; title: string; abstract: string; authors: string[]; /** Primary category, e.g. "cs.LG". */ category: string; /** All categories the paper is filed under. */ categories: string[]; /** ISO 8601 string — original submission date. */ publishedAt: string; /** ISO 8601 string — last update date. */ updatedAt: string; /** Direct link to abstract page. */ url: string; /** Direct link to PDF. */ pdfUrl: string; /** Journal reference if the paper has been published, otherwise null. */ journalRef: string | null; /** Author comment (often includes page count, venue, code link). */ comment: string | null; }; const arxiv: { /** * Search arXiv papers using Lucene query syntax. * * **Field prefixes:** * - `ti:` — title * - `au:` — author (last name or full name) * - `abs:` — abstract * - `cat:` — category (e.g. `cat:cs.LG`) * - `all:` — all fields (default when no prefix) * * **Operators:** `AND`, `OR`, `NOT`. Phrases must be quoted. * * Tip: use `sortBy: "submittedDate"` for latest papers in a field. * Tip: quote multi-word phrases — `ti:"attention is all you need"`. * * @example * const { papers, total } = await arxiv.search("ti:\"attention is all you need\"") * // → { papers: [{ id: "1706.03762", title: "Attention Is All You Need", ... }], total: 1 } * * @example * const { papers } = await arxiv.search("au:LeCun AND cat:cs.LG", { sortBy: "submittedDate", limit: 5 }) */ search(query: string, opts?: QueryOptions): Promise<{ papers: import("../arxiv/client.ts").Paper[]; total: number; }>; /** * Fetch one or more papers by arXiv ID. * * Accepts bare IDs with or without version suffix: * - `"1706.03762"` — resolves to latest version * - `"1706.03762v7"` — resolves to exact version * * Most efficient way to retrieve papers when you already have IDs — * batch up to 100 in a single call. * * @example * const papers = await arxiv.fetch(["1706.03762", "2006.16189"]) * // → [{ id: "1706.03762", title: "Attention Is All You Need", ... }, ...] */ fetch(ids: string[]): Promise; /** * Get one paper by arXiv ID. Returns null if the ID is not found. * * @example * const paper = await arxiv.get("1706.03762") * // → { id: "1706.03762", title: "Attention Is All You Need", abstract: "...", ... } */ get(id: string): Promise; /** * Get the latest papers in a category. * * Category examples: `cs.LG`, `cs.AI`, `cs.CL`, `cs.CV`, `cs.NE`, * `stat.ML`, `math.OC`, `q-bio.NC`, `econ.GN`. * * @example * const papers = await arxiv.recent("cs.LG", 10) * // → [{ id: "...", title: "...", publishedAt: "2026-06-24T...", ... }, ...] */ recent(category: string, limit?: number): Promise; /** * Search papers by author name. Use last name for broad results, * or `"Firstname Lastname"` for exact matching. * * @example * const papers = await arxiv.byAuthor("Hinton", { limit: 20 }) * // → [{ id: "...", authors: ["Geoffrey Hinton", ...], ... }, ...] */ byAuthor(author: string, opts?: Omit): Promise; /** * Search for papers matching a concept in their title or abstract, * optionally filtered to a category. * * Handles Lucene phrase quoting automatically — just pass natural text. * * @example * const papers = await arxiv.about("diffusion models", { category: "cs.CV", limit: 15 }) */ about(concept: string, opts?: { category?: string; limit?: number; offset?: number; }): Promise; /** * Search for papers in a date range. Dates are inclusive UTC boundaries. * * Combine with a query string or leave it empty to get all papers in the range. * * @example * const papers = await arxiv.since("2026-01-01", "2026-06-25", "cat:cs.AI", { limit: 50 }) */ since(from: string, to: string, query?: string, opts?: Omit): Promise; } } export {}

@axon/arxiv