origin-search

Zero-dependency Node.js SDK for the Origin AI Search Gateway.

Install

npm install origin-search

Quick Start

import { SearchClient } from "origin-search";

const client = new SearchClient("your-api-key");

// Fast search (default)
const result = await client.searchFast("latest AI news");
console.log(result.content);

// Deep multi-source search
const deep = await client.searchDeep("compare React vs Svelte");
console.log(deep.providers); // ["grok", "exa", "tavily"]

// AI answer mode
const answer = await client.searchAnswer("what is the capital of France?");
console.log(answer.answer);

Custom endpoint

const client = new SearchClient("your-api-key", {
  baseUrl: "https://my-gateway.example.com",
});

API

| Method | Description | |--------|-------------| | search(query, options?) | Search with full options (mode, model, split, num) | | searchFast(query) | Fast single-source search (Grok) | | searchDeep(query) | Multi-source deep search (Grok + Exa + Tavily) | | searchAnswer(query) | AI-summarized answer (Tavily) | | models() | List available models | | providers() | List search providers | | providersHealth() | Check provider health | | health() | Gateway health check |

Search Options

const result = await client.search("Rust web frameworks", {
  mode: "deep",       // "fast" | "deep" | "answer"
  model: "grok-4.1-fast",
  split: 3,           // max sub-queries
  num: 10,            // max results
});

Error Handling

import { SearchClient, SearchError } from "origin-search";

try {
  const result = await client.searchFast("test");
} catch (err) {
  if (err instanceof SearchError) {
    console.error(`API error (${err.status}): ${err.message}`);
  }
}

Requirements

• Node.js >= 18 (uses native fetch)
• Zero runtime dependencies

License

MIT