honcho/sdks/typescript
Vineeth Voruganti 73c5eb1f5a
SDK Changes (#223)
* fix: Add top level transactions for tracing in deriver

* fix: Add Delete methods to sdks for sessions

* feat: Add session deletion and session level deriver status methods

* fix: Streaming support to python sdk

* fix: Checkpoint Streaming working in SDKs with workarounds for stainless

* feat: fix pagination, add message metadata update, and get peer card methods

* feat: parity in typescript and python sdks

* fix: Address Coderabbit

* fix: Address Coderabbit

* chore: add basedpyright rules to sdk

* fix: Code Rabbit & Changelog

* fix: updated docs with api-reference
2025-10-01 16:25:30 -04:00
..
__tests__ SDK Changes (#223) 2025-10-01 16:25:30 -04:00
examples feat: Add get summaries endpoints & Custom Timestamps (#185) 2025-08-12 17:19:53 -04:00
src SDK Changes (#223) 2025-10-01 16:25:30 -04:00
.gitignore Add Pre-commit Hooks (#165) 2025-07-22 15:17:53 -04:00
CHANGELOG.md 2.3.0 Release & N+1 Query Optimization (#190) 2025-08-13 14:58:58 -04:00
README.md Add Pre-commit Hooks (#165) 2025-07-22 15:17:53 -04:00
biome.json feat: add filter params everywhere (#164) 2025-07-21 13:40:30 -04:00
bun.lock SDK Changes (#223) 2025-10-01 16:25:30 -04:00
jest.config.js Add Pre-commit Hooks (#165) 2025-07-22 15:17:53 -04:00
package.json SDK Changes (#223) 2025-10-01 16:25:30 -04:00
tsconfig.json Ben/search rrf (#179) 2025-08-06 17:43:03 -04:00

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.