@byokey/core

Core execution engine for the BYOK Infrastructure Toolkit.

Installation

npm install @byokey/core @byokey/types

Usage

import { createClient } from '@byokey/core';
import { openai } from '@byokey/openai';
import { google } from '@byokey/google';

const client = createClient({
  adapters: [openai(), google()]
});

// Execute a request
const response = await client.execute({
  provider: 'openai',
  model: 'gpt-5.4',
  credential: 'sk-...', // User's own API key
  messages: [{ role: 'user', content: 'Hello!' }]
});

console.log(response.content);
console.log(response.usage.totalTokens);

Streaming

for await (const chunk of client.stream(request)) {
  process.stdout.write(chunk.content);
}

Error Handling

import { ByokError } from '@byokey/core';

try {
  await client.execute(request);
} catch (err) {
  if (err instanceof ByokError) {
    console.log(err.category); // 'RATE_LIMITED', 'INVALID_CREDENTIAL', etc.
    console.log(err.retryable); // boolean
  }
}

License

MIT