dsh-tool-arxiv

Readme

# dsh-tool-arxiv

An [arXiv](https://arxiv.org) preprint search tool for
[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) —
scaffolded with [dshp](https://www.npmjs.com/package/dshp).

Adds an `arxiv_search` tool to your agent: search by topic or arXiv ID and get
structured results (title, authors, arxiv_id, abstract, abs_url, pdf_url,
submit_date). **Abstracts only** — PDF bodies are never fetched, keeping token
usage bounded.

## Install

```sh
dsh plugin --profile my add dsh-tool-arxiv
dsh --profile my --dump-config   # see the layer land
dsh --profile my                 # boot
```

## Tool signature

| Parameter | Required | Description |
|---|---|---|
| `query` | yes | Keywords (any language) or a bare arXiv ID such as `2608.16889` |
| `category` | no | arXiv category filter, e.g. `cs.AI`; omit for all fields |
| `max_results` | no | Number of papers, default 5, capped at 20 |
| `sort_by` | no | `submittedDate` (default) or `relevance` |

Results carry the standing caveat: arXiv preprints are not peer-reviewed.

## Configuration

Optional `cordis.yml` overrides:

```yaml
- id: tool-arxiv
  config:
    timeoutMs: 15000
```

## Library use

The core is dependency-light and exported for reuse:

```ts
import { searchArxiv, buildApiUrl, renderPapers } from 'dsh-tool-arxiv'
const papers = await searchArxiv({ query: 'LLM agent', category: 'cs.AI', maxResults: 5 })
```

## Develop

```sh
pnpm install && pnpm build
npx dshp verify          # boot-free composition check
npx dshp dev             # live dev overlay (needs dsh)
```

## License

MIT