Node.js / TypeScript SDK

// ESM / TypeScript
import cognisafe from 'cognisafe';

// CommonJS
const cognisafe = require('cognisafe');

import cognisafe from 'cognisafe';

cognisafe.configure({
  apiKey: 'csk_your_key_here',    // or reads COGNISAFE_API_KEY
  projectId: 'my-app',            // or reads COGNISAFE_PROJECT_ID
  proxyUrl: 'http://localhost:8080',  // default; omit for cloud
  apiUrl: 'http://localhost:8000',    // default; omit for cloud
});

import cognisafe from 'cognisafe';
import OpenAI from 'openai';

cognisafe.configure({ apiKey: 'csk_...', projectId: 'my-app' });
cognisafe.patchOpenAI();

const client = new OpenAI(); // baseURL is now the Cognisafe proxy

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Hello, world!' }],
});

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

import cognisafe from 'cognisafe';
import Anthropic from '@anthropic-ai/sdk';

cognisafe.configure({ apiKey: 'csk_...', projectId: 'my-app' });
cognisafe.patchAnthropic();

const client = new Anthropic();

const message = await client.messages.create({
  model: 'claude-opus-4-5',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Hello.' }],
});

console.log(message.content[0].text);

import cognisafe from 'cognisafe';

const callMyModel = cognisafe.trace(
  async (prompt: string): Promise<string> => {
    const response = await fetch('https://internal.example.com/v1/chat', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ messages: [{ role: 'user', content: prompt }] }),
    });
    const data = await response.json();
    return data.choices[0].message.content;
  },
  { model: 'my-internal-model' }
);

const result = await callMyModel('Summarise this text.');