AgentHub TypeScript Implementation

This directory contains the TypeScript implementation of AgentHub, mirroring the Python implementation in src_py/.

Building

make install  # Install dependencies
make build    # Build TypeScript to JavaScript
make lint     # Run ESLint
make test     # Run tests

Usage

Basic Client Usage

import { AutoLLMClient } from "@prismshadow/agenthub";

process.env.OPENAI_API_KEY = "your-openai-api-key";

async function main() {
  const client = new AutoLLMClient({ model: "gpt-5.5" });
  // For OpenAI Chat Completions-compatible endpoints:
  // const client = new AutoLLMClient({ model: "custom-model", clientType: "openai" });

  for await (const event of client.streamingResponseStateful({
    message: {
      role: "user",
      content_items: [{ type: "text", text: "Hello!" }],
    },
    config: {},
  })) {
    console.log(event);
  }
}

main().catch(console.error);

History Management

// Get current history
const history = client.getHistory();

// Clear all history
client.clearHistory();

// Replace history with a saved copy
client.setHistory(history);

Tracer Usage

Save and browse conversation history with a web interface:

import { Tracer } from "@prismshadow/agenthub/integration/tracer";

// Create a tracer instance
const tracer = new Tracer("./cache");

// Save conversation history
const model = "gpt-5.5";
const history = [
  { role: "user", content_items: [{ type: "text", text: "Hello!" }] },
  { role: "assistant", content_items: [{ type: "text", text: "Hi there!" }] },
];
const config = {};
tracer.saveHistory(model, history, "session/conv_001", config);

// Start web server to view saved conversations
tracer.startWebServer("127.0.0.1", 25750);
// Open http://127.0.0.1:25750 in your browser

Playground Usage

Interactive web interface for chatting with LLMs:

import { startPlaygroundServer } from "@prismshadow/agenthub/integration/playground";

// Start the playground server
startPlaygroundServer("127.0.0.1", 25751);
// Open http://127.0.0.1:25751 in your browser
// Open http://127.0.0.1:25751/tracer/ to browse traces

Examples

Run the examples:

# Build the project
npm run build

# Run tracer example
npm run tracer

# Run playground example
npm run playground