{"_id":"@artchristech/fillin-client","name":"@artchristech/fillin-client","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@artchristech/fillin-client","version":"0.1.0","description":"TypeScript client for Fillin — search engine for AI agents (post-cutoff retrieval + daily snapshot slices).","type":"module","main":"./dist/index.js","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"build":"tsc","test":"node --test --import=tsx test/*.test.ts","prepublishOnly":"npm run build"},"engines":{"node":">=18"},"keywords":["mcp","llm","retrieval","rag","x402","agent"],"homepage":"https://fillin.glyphapi.dev","repository":{"type":"git","url":"git+https://github.com/artchristech/fillin.git","directory":"clients/fillin-ts"},"license":"MIT","devDependencies":{"tsx":"^4.7.0","typescript":"^5.4.0"},"_id":"@artchristech/fillin-client@0.1.0","gitHead":"1403208daad44cfd0bb3f082a22fdbb97cfddd34","bugs":{"url":"https://github.com/artchristech/fillin/issues"},"_nodeVersion":"20.19.4","_npmVersion":"10.8.2","dist":{"integrity":"sha512-G8aVBxadQzrIspDPMVPPdffkZfiBYRf+Wiz38KAdFUZII0i7vFSHjPX30zn0VsimS/awKDY7XlR20yzveKPlaA==","shasum":"600c8116b5b2ec1167a9a4718493af05e8fcc2b0","tarball":"https://registry.npmjs.org/@artchristech/fillin-client/-/fillin-client-0.1.0.tgz","fileCount":6,"unpackedSize":13644,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEA7gjkLU10SUkl/fYeELvkDi1Ez9x46tYPm3ylyLqNQAiBeS9E+YgDz1bBQYeA6J3PNe18rEqt5YwZe3h9et+cXFQ=="}]},"_npmUser":{"name":"artchristech","email":"mandalazenwave@gmail.com"},"directories":{},"maintainers":[{"name":"artchristech","email":"mandalazenwave@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fillin-client_0.1.0_1778789766177_0.14910326071043212"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-14T20:16:05.924Z","0.1.0":"2026-05-14T20:16:06.329Z","modified":"2026-05-14T20:16:06.639Z"},"maintainers":[{"name":"artchristech","email":"mandalazenwave@gmail.com"}],"description":"TypeScript client for Fillin — search engine for AI agents (post-cutoff retrieval + daily snapshot slices).","homepage":"https://fillin.glyphapi.dev","keywords":["mcp","llm","retrieval","rag","x402","agent"],"repository":{"type":"git","url":"git+https://github.com/artchristech/fillin.git","directory":"clients/fillin-ts"},"bugs":{"url":"https://github.com/artchristech/fillin/issues"},"license":"MIT","readme":"# @fillin/client\n\nTypeScript client for [Fillin](https://fillin.glyphapi.dev) — search engine for AI agents. Closes the gap between an LLM's training cutoff and now across HN, arXiv, GitHub Releases, and curated RSS, plus daily snapshots of supply-chain CVEs, new research papers, and frontier AI lab releases.\n\n## Install\n\n```bash\nnpm install @fillin/client\n```\n\n## Quickstart\n\n```ts\nimport { FillinClient } from \"@fillin/client\";\n\nconst fillin = new FillinClient({\n  apiKey: process.env.FILLIN_API_KEY!,\n});\n\n// Generic post-cutoff vector search across all corpora — $0.01/call\nconst { results } = await fillin.query({\n  cutoff: \"2026-01-01\",                // your model's training cutoff\n  query: \"rust async runtime developments\",\n  k: 5,                                 // 1–20\n});\n\nfor (const hit of results) {\n  console.log(`[${hit.source}] ${hit.title}  ←  ${hit.url}`);\n}\n```\n\nGet a bearer key at [fillin.glyphapi.dev/signup](https://fillin.glyphapi.dev/signup) (20 free queries, no card). For per-call pricing see [fillin.glyphapi.dev/pricing](https://fillin.glyphapi.dev/pricing).\n\n## API\n\n### `new FillinClient(options)`\n\n| Option       | Type     | Default                            | Description                              |\n|--------------|----------|------------------------------------|------------------------------------------|\n| `apiKey`     | `string` | —                                  | Pre-issued bearer key.                   |\n| `host`       | `string` | `https://fillin.glyphapi.dev`      | API base URL.                            |\n| `timeoutMs`  | `number` | `30000`                            | Per-request abort timeout.               |\n| `fetch`      | function | `globalThis.fetch`                 | Inject for testing or custom transports. |\n\n### Methods\n\n- `query(params)` — generic post-cutoff vector search across all corpora. **$0.01/call.**\n- `stats()` — bearer-gated corpus stats.\n- `freshness()` — public corpus freshness (no auth).\n- `health()` — liveness check (no auth).\n- `paymentInfo()` — public x402 payment surface.\n\n> **Slice routes** (`/query/cves` $0.02, `/query/papers` $0.03, `/query/frontier` $0.05) and `/answer` ($0.02) ship in the underlying API but aren't yet wrapped in this client. Hit them directly via `fetch`, or open an issue/PR if you want first-class methods.\n\n### Errors\n\nNon-2xx responses throw `FillinError` carrying `.status` and `.body` (truncated to 500 chars).\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-5f4fbc16b8984d0a2ed0354fe57a1164"}