CognipeerAI Gateway SDK

Official TypeScript/JavaScript SDK for CognipeerAI Gateway - A multi-tenant SaaS platform for AI and Agentic services.


Features

- 🤖 Chat Completions - OpenAI-compatible chat API with streaming support
- 📊 Embeddings - Text vectorization for semantic search
- 🗄️ Vector Operations - Manage vector databases (Pinecone, Chroma, Qdrant, etc.)
- 📁 File Management - Upload and manage files with markdown conversion
- 🔍 Agent Tracing - Observability for agent executions
- 🔒 Type-Safe - Full TypeScript support with comprehensive types
- ⚡ Modern - ESM and CommonJS support, works in Node.js and browsers

Installation

``bash
npm install @cognipeer/cgate-sdk
`

`bash
yarn add @cognipeer/cgate-sdk
`

`bash
pnpm add @cognipeer/cgate-sdk
`

Quick Start

`typescript
import { CGateClient } from '@cognipeer/cgate-sdk';

// Initialize the client
const client = new CGateClient({
apiKey: 'your-api-key',
baseURL: 'https://api.cognipeer.com', // Optional, defaults to production
});

// Chat completion
const response = await client.chat.completions.create({
model: 'gpt-4',
messages: [
{ role: 'system', content: 'You are a helpful assistant.' },
{ role: 'user', content: 'Hello!' },
],
});

console.log(response.choices[0].message.content);

// Streaming chat
const stream = await client.chat.completions.create({
model: 'gpt-4',
messages: [{ role: 'user', content: 'Tell me a story' }],
stream: true,
});

for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content || '');
}

// Create embeddings
const embeddings = await client.embeddings.create({
model: 'text-embedding-3-small',
input: 'Hello, world!',
});

console.log(embeddings.data[0].embedding);

// Vector operations
await client.vectors.upsert('my-provider', 'my-index', {
vectors: [
{
id: 'vec1',
values: [0.1, 0.2, 0.3],
metadata: { text: 'Hello world' },
},
],
});

const results = await client.vectors.query('my-provider', 'my-index', {
query: {
vector: [0.1, 0.2, 0.3],
topK: 5,
},
});

// File upload
const file = await client.files.upload('my-bucket', {
fileName: 'document.pdf',
data: 'data:application/pdf;base64,JVBERi0xLjQK...',
convertToMarkdown: true,
});
`

Documentation

Full documentation is available at cognipeer.github.io/cgate-sdk

- Getting Started
- Chat API
- Embeddings API
- Vector API
- Files API
- Tracing API
- Examples

API Reference

$3

`typescript
const client = new CGateClient({
apiKey: string; // Required: Your API token
baseURL?: string; // Optional: API base URL (default: https://api.cognipeer.com)
timeout?: number; // Optional: Request timeout in ms (default: 60000)
maxRetries?: number; // Optional: Max retry attempts (default: 3)
fetch?: typeof fetch; // Optional: Custom fetch implementation
});
`

$3

#### Chat
- client.chat.completions.create(params) - Create chat completion (streaming supported)

#### Embeddings
- client.embeddings.create(params) - Create embeddings

#### Vectors
- client.vectors.providers.list(query?) - List vector providers
- client.vectors.providers.create(data) - Create vector provider
- client.vectors.indexes.list(providerKey) - List indexes
- client.vectors.indexes.create(providerKey, data) - Create index
- client.vectors.indexes.get(providerKey, indexId) - Get index details
- client.vectors.indexes.update(providerKey, indexId, data) - Update index
- client.vectors.indexes.delete(providerKey, indexId) - Delete index
- client.vectors.upsert(providerKey, indexId, data) - Upsert vectors
- client.vectors.query(providerKey, indexId, query) - Query vectors
- client.vectors.delete(providerKey, indexId, ids) - Delete vectors

#### Files
- client.files.buckets.list() - List buckets
- client.files.buckets.get(bucketKey) - Get bucket details
- client.files.list(bucketKey, query?) - List files
- client.files.upload(bucketKey, data) - Upload file

#### Tracing
- client.tracing.ingest(data)` - Ingest tracing session

Examples

Check out the examples directory for more detailed usage:

- Chat with streaming
- RAG with vectors
- File processing
- Agent tracing

Contributing

We welcome contributions! Please see our Contributing Guide for details.

License

MIT © CognipeerAI

Support

- 📧 Email: support@cognipeer.com
- 📖 Documentation: cognipeer.github.io/cgate-sdk
- 🐛 Issues: GitHub Issues