Production Deployment

# AI Providers
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=...

# OAuth (32-byte hex key)
OAUTH_ENCRYPTION_KEY=abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789

# Optional: Base URLs for proxies
OPENAI_BASE_URL=https://api.openai.com/v1
ANTHROPIC_BASE_URL=https://api.anthropic.com

# Note: timeouts are configured per-tool/provider in code, not via env vars —
# there is no REQUEST_TIMEOUT env var read by the library.

import {
  Agent,
  ProviderAuthError,
  ProviderRateLimitError,
  ProviderContextLengthError,
  ToolExecutionError,
} from 'oneringai';

const agent = Agent.create({ connector: 'openai', model: 'gpt-4.1' });

try {
  const response = await agent.run('Hello');
} catch (error) {
  if (error instanceof ProviderAuthError) {
    console.error('Authentication failed:', error.message);
    // Check API key
  } else if (error instanceof ProviderRateLimitError) {
    console.error('Rate limit exceeded:', error.message);
    // Retry with backoff
  } else if (error instanceof ProviderContextLengthError) {
    console.error('Context too long:', error.message);
    // Use context management
  } else if (error instanceof ToolExecutionError) {
    console.error('Tool failed:', error.message);
    // Handle tool error
  } else {
    console.error('Unknown error:', error);
  }
}

// Good: Named connectors
Connector.create({ name: 'openai-main', vendor: Vendor.OpenAI,
  auth: { type: 'api_key', apiKey: process.env.OPENAI_API_KEY! } });
Connector.create({ name: 'openai-backup', vendor: Vendor.OpenAI,
  auth: { type: 'api_key', apiKey: process.env.OPENAI_BACKUP_API_KEY! } });

const agent = Agent.create({ connector: 'openai-main', model: 'gpt-4.1' });

// Bad: Passing keys directly
const agentVariant2 = Agent.create({
  connector: { vendor: Vendor.OpenAI, auth: { apiKey: '...' } },
  model: 'gpt-4.1'
});

// Monitor context budget
const budget = agent.context.lastPreparation?.budget; // Inspect after run/stream; do not prepare twice.
if (budget && budget.utilizationPercent > 80) {
  console.warn(`Context at ${budget.utilizationPercent}%`);
}

import { CircuitBreaker } from 'oneringai';

const breaker = new CircuitBreaker('my-breaker', {
  failureThreshold: 5,
  resetTimeoutMs: 30000,
});

const safeTool: ToolFunction = {
  // ...
  execute: async (args) => {
    return await breaker.execute(() => externalAPI.call(args));
  },
};

// Always use encryption for OAuth tokens
const oauth = new OAuthManager({
  // ...
  storage: new FileStorage({
    directory: './tokens',
    encryptionKey: process.env.OAUTH_ENCRYPTION_KEY!, // Required!
  }),
});

// Agent - cascades to AgentContextNextGen → ToolManager → CircuitBreakers
const agent = Agent.create({ connector: 'openai-main', model: 'gpt-4.1' });
agent.onCleanup(() => {
  console.log('Cleaning up...');
});
agent.destroy();  // Cleans up all child resources

// Standalone ToolManager
const toolManager = new ToolManager();
toolManager.destroy();  // Cleans up circuit breakers and listeners

// Check before use
if (!toolManager.isDestroyed) {
  await toolManager.execute('my_tool', args);
}