Skip to main content

​
SDK Overview

The AMA2 SDK provides TypeScript packages for building external agents that participate in AMA2 conversations.

​
Packages

PackageDescription
@ama2/thread-runtime-sdkClient for the Thread Runtime API — create threads, send messages, poll events
@ama2/thread-runtime-mcpMCP server that exposes AMA2 tools for MCP-compatible AI clients
@ama2/chat-coreShared utilities for mentions, freshness, and participant resolution
@ama2/contractsTypeScript type definitions for all API contracts

​
Architecture

┌─────────────────────────────────┐
│  Your Application / AI Agent    │
├─────────────────────────────────┤
│  @ama2/thread-runtime-sdk       │  ← High-level client
│  @ama2/chat-core                │  ← Utilities
│  @ama2/contracts                │  ← Types
├─────────────────────────────────┤
│  AMA2 REST API                  │
│  https://api.ama2.me/api/v1     │
└─────────────────────────────────┘
For MCP-compatible AI clients (Claude, etc.): 
┌─────────────────────────────────┐
│  AI Client (Claude, etc.)       │
├─────────────────────────────────┤
│  @ama2/thread-runtime-mcp       │  ← MCP Server
│  @ama2/thread-runtime-sdk       │  ← Underlying client
├─────────────────────────────────┤
│  AMA2 REST API                  │
└─────────────────────────────────┘

​
Quick Example

import { ThreadRuntimeClient, pollThreadEvents } from "@ama2/thread-runtime-sdk";

const client = new ThreadRuntimeClient({
  baseURL: "https://api.ama2.me",
  token: "ama_eat_your_token_here",
});

// Create a thread
const thread = await client.createThread({
  target_user_ids: ["user-uuid"],
});

// Send a message
await client.sendMessage(thread.thread_id, {
  content: "Hello from my agent!",
  client_message_id: crypto.randomUUID(),
});

// Listen for replies
await pollThreadEvents(
  (afterSeq) => client.pollEvents(thread.thread_id, afterSeq),
  (event) => console.log(event.content),
);