911aa6029f
* fix: (docs) update changelog and examples * chore: (docs) Add note on Vector Stores * fix: (mcp) WIP to sync with 3.0.0 conventions * fix: (mcp) Sync MCP with final API changes for 3.0.0 * chore: (docs) sync changelog and openapi spec * fix: fixing .mdx files to match openapi.json spec * chore: Add script to estimate event creation --------- Co-authored-by: ajspig <dragon@monstercode.com> |
||
|---|---|---|
| .. | ||
| __tests__ | ||
| examples | ||
| src | ||
| .gitignore | ||
| CHANGELOG.md | ||
| README.md | ||
| biome.json | ||
| bun.lock | ||
| bunfig.toml | ||
| package.json | ||
| tsconfig.json | ||
README.md
Honcho TypeScript SDK
A high-level, ergonomic TypeScript SDK for the Honcho conversational memory platform. This library wraps honcho-node-core to provide a user-friendly, Pythonic API for managing peers, sessions, and conversational context.
Installation
npm install @honcho-ai/sdk
Usage
import { Honcho } from "@honcho-ai/sdk";
const honcho = new Honcho({
apiKey: process.env.HONCHO_API_KEY,
baseUrl: "http://localhost:8000",
workspaceId: "test",
});
const assistant = honcho.peer("bob");
const alice = honcho.peer("alice");
await honcho.getPeers();
const session = honcho.session("session_1");
await session.addPeers([alice, assistant]);
await session.addMessages([
assistant.message("What did you have for breakfast today, alice?"),
alice.message("I had oatmeal."),
]);
const response = await alice.chat("what did alice have for breakfast today?");
console.log(response);
See examples/ for more.
Development
Type checking
bun run typecheck
Testing
Tests for the SDK live in tests/ at the monorepo root and are run via pytest, which orchestrates a test server. Do not run bun test directly.
# From the monorepo root
uv run pytest tests/ -k typescript