@eos-ai/sdk

TypeScript client for the EOS Memory API — semantic search over your engineering team's knowledge graph.

API surface evolves until Loop 3. Breaking changes in minor versions until 1.0.0.

Install

npm install @eos-ai/sdk

Quick start

import { EosClient } from "@eos-ai/sdk";

const client = new EosClient({ apiKey: "eos_..." });

const r = await client.search("what changed in auth last week");
for (const node of r.data.results) {
  console.log(`[${node.node_type}] ${node.content}  score=${node.score}`);
}

API

new EosClient(opts?)

| Option | Type | Default | Description | |-----------|----------|--------------------------|--------------------------| | apiKey | string | process.env.EOS_API_KEY| EOS API key (eos_…) | | baseUrl | string | https://www.eos.dev | Override for local dev |

client.search(query, opts?)

| Option | Type | Default | Description | |-----------------------|-----------|---------|----------------------------------| | limit | number | 5 | Max knowledge nodes (1–20) | | includeConversations| boolean | true | Include conversation summaries |

Returns SearchResponse:

{
  data: {
    query:         string;
    results:       SearchResult[];      // ranked knowledge nodes
    conversations: ConversationResult[]; // conversation summaries
    total:         number;
  };
  meta: {
    request_id: string;
    took_ms:    number;
    cached:     boolean;
  };
  errors: null | string[];
}

Get an API key

eos.dev/settings/api — Starter plan or higher.