2c: TypeScript/JS client

[valiantone]

Summary

NPM package hotmem — a typed TypeScript client for the HotMem HTTP API. Most agent developers work in both Python and TS/JS.

Proposed Interface

Mirrors the Python HotMemClient:

const client = new HotMemClient("http://127.0.0.1:8711");
await client.add("vendor_x", "Invoice total $5000", { importance: 0.8 });
const memories = await client.search("duplicate invoice risk", { topK: 5 });
// memories are LLM-ready message objects

Scope

• HotMemClient class with add, search, health, hydrate, snapshot
• Full TypeScript types for all request/response shapes
• Works in Node.js and edge runtimes (Deno, Bun, Cloudflare Workers)
• Zero dependencies (use fetch)
• Published to NPM as hotmem

Acceptance Criteria

• npm install hotmem works
• All 5 API methods typed and functional
• Works with Node.js 18+, Deno, Bun
• README with quickstart example