Sannex Agent SDK Overview

The Sannex Agent SDK provides dual-package parity for integrating custom agents, backend services, and e-commerce platforms with AgentOS.

Dual-Package Parity Standard

Both SDKs expose the exact same public API surface, parameter schemas, and fire-and-forget telemetry batching behavior.

Feature	Python (sannex-agent)	JavaScript / TypeScript (@sannex/agent)
Package Manager	pip install sannex-agent	npm install @sannex/agent
Sync Client	SannexClient	SannexClient
Async Client	AsyncSannexClient	Native Promise-based client
Telemetry Tracking	client.track(...)	client.track(...)
Conversation Sync	client.sync_conversation(...)	client.syncConversation(...)
Remote Config	client.get_config()	await client.getConfig()
Health Ping	client.ping()	await client.ping()

---

Python SDK Quickstart

from sannex_agent import SannexClient

client = SannexClient(
    api_key="aicb_live_...",
    base_url="https://agentos.aicb.sannex.ng"
)

# Track an event (Fire-and-forget background queue)
client.track(
    channel="whatsapp",
    customer_id="+2348012345678",
    event="payment_success",
    amount=25000.0,
    metadata={"order_id": "ORD-1234"}
)

---

TypeScript / Node.js Quickstart

import { SannexClient } from '@sannex/agent';

const client = new SannexClient({
  apiKey: 'aicb_live_...',
  baseUrl: 'https://agentos.aicb.sannex.ng',
});

// Track an event
client.track({
  channel: 'widget',
  customerId: 'session_abc123',
  event: 'catalog_view',
  metadata: { productId: 42 },
});