Agent SDK

Dedicated SDK for Agent Cloud APIs. Available in TypeScript and Python.

TypeScript

npm install @ainative/agent-sdk

Quick Start

import { AINativeClient } from '@ainative/agent-sdk';

const client = new AINativeClient({
  apiKey: 'your-api-key',
  baseUrl: 'https://api.ainative.studio',
});

// Register an agent
const agent = await client.agents.register({
  name: 'my-agent',
  capabilities: ['summarization', 'web_search'],
  protocols: ['a2a/1.0'],
});

// Store memory
await client.memory.remember({
  content: 'Important context from this conversation',
  entityId: 'session-123',
  importance: 0.9,
});

// Recall memory
const memories = await client.memory.recall({
  query: 'conversation context',
  entityId: 'session-123',
  limit: 5,
});

// Vector search
const results = await client.vectors.search({
  query: 'machine learning',
  limit: 10,
});

// Graph traversal
const graph = await client.graph.traverse({
  entity: 'Alice',
  maxHops: 3,
  predicates: ['works_at', 'uses'],
});

// Chat completions
const response = await client.chat.create({
  model: 'meta-llama/llama-3.3-70b-instruct',
  messages: [{ role: 'user', content: 'Hello' }],
});

Modules

Module	Description
client.agents	Register, discover, manage agent cards
client.swarm	Create and manage agent swarms
client.memory	Remember, recall, forget, reflect, profile
client.graph	Entities, edges, traverse, GraphRAG
client.vectors	Vector upsert and search
client.chat	Chat completions
client.files	File upload and download
client.tables	NoSQL table operations
client.threads	Conversation threads
client.events	Event streaming

Task Classification

import { classifyTask } from '@ainative/agent-sdk';

const classification = classifyTask('Analyze this dataset and find trends');
// { category: 'analysis', confidence: 0.92 }

OAuth PKCE Auth

import { generateCodeVerifier, generateCodeChallenge, buildAuthUrl } from '@ainative/agent-sdk';

const verifier = generateCodeVerifier();
const challenge = await generateCodeChallenge(verifier);
const authUrl = buildAuthUrl({ clientId: 'my-app', codeChallenge: challenge });

Python

pip install ainative-agent-sdk

Quick Start

from ainative import AINativeClient

client = AINativeClient(api_key="your-api-key")

# Register an agent
agent = client.agents.register(
    name="my-agent",
    capabilities=["summarization", "web_search"],
)

# Store and recall memory
client.memory.remember(
    content="User is building a RAG pipeline",
    entity_id="user-123",
    importance=0.8,
)

memories = client.memory.recall(query="user project", entity_id="user-123")

# Vector search
results = client.vectors.search(query="machine learning", limit=10)

# Chat
response = client.chat.create(
    model="meta-llama/llama-3.3-70b-instruct",
    messages=[{"role": "user", "content": "Hello"}],
)

Async Support

pip install ainative-agent-sdk[async]

import asyncio
from ainative import AINativeClient

async def main():
    client = AINativeClient(api_key="your-api-key")
    # All methods support async via httpx
    memories = await client.memory.recall_async(query="context", entity_id="user-123")

asyncio.run(main())

Error Handling

Both SDKs export the same error hierarchy:

Error	Description
APIError	Base error for all API failures
AuthenticationError	Invalid or expired API key
RateLimitError	Rate limit exceeded
NetworkError	Connection or timeout failure

Next Steps

• Agent Runtime — Embeddable agent execution engine
• Agent Cloud — Deploy agents to the cloud
• TypeScript SDK — Full AINative SDK