{"_id":"@aerocorp/agi-proxy-sdk","name":"@aerocorp/agi-proxy-sdk","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@aerocorp/agi-proxy-sdk","version":"1.0.0","description":"Universal SDK for AeroCorp AGI Proxy Platform - Agnostic AI provider with intelligent routing","main":"dist/agi-proxy-sdk.js","module":"dist/agi-proxy-sdk.mjs","types":"dist/agi-proxy-sdk.d.ts","exports":{".":{"types":"./dist/agi-proxy-sdk.d.ts","import":"./dist/agi-proxy-sdk.mjs","require":"./dist/agi-proxy-sdk.js"}},"scripts":{"build":"tsup agi-proxy-sdk.ts --format cjs,esm --dts","dev":"tsup agi-proxy-sdk.ts --format cjs,esm --dts --watch","test":"vitest run","test:watch":"vitest","test:manual":"tsx manual-test.ts","prepublishOnly":"npm run build"},"keywords":["ai","agi","openai","gemini","anthropic","claude","mistral","grok","ollama","chatgpt","sdk","api","proxy","router","agnostic","aerocorp"],"author":{"name":"AeroCorp Industries","email":"support@aerocorpindustries.org"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/aerocorp/agi-proxy-sdk.git"},"bugs":{"url":"https://github.com/aerocorp/agi-proxy-sdk/issues"},"homepage":"https://agi.aerocorpindustries.org","devDependencies":{"@types/node":"^24.7.0","tsup":"^8.5.0","tsx":"^4.20.6","typescript":"^5.9.3","vitest":"^1.6.1"},"_id":"@aerocorp/agi-proxy-sdk@1.0.0","gitHead":"5430cd065fb2cc24d83b0735eec86cf4ac7a7853","_nodeVersion":"24.9.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-m3FFhvoS0rA60JzHOTEUmwPOPK4t9QgySrV2KODa6CZcczxxLM+fU4oTQANnnXiRcexxQbV/zrEmGhuA547W/A==","shasum":"5eb62b86421a58291c84111e92045cc5ef2ccc78","tarball":"https://registry.npmjs.org/@aerocorp/agi-proxy-sdk/-/agi-proxy-sdk-1.0.0.tgz","fileCount":7,"unpackedSize":23038,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDGrbmst3OwwEtgwPFcCDCuNFpWpXZoV0XuJ1UB76ryywIgN5+AYdYZRivxPpqxGqLOopZvn+rSNA9rYZv8Ci5Glt8="}]},"_npmUser":{"name":"aerocorp","email":"aerox3256@hotmail.com"},"directories":{},"maintainers":[{"name":"aerocorp","email":"aerox3256@hotmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agi-proxy-sdk_1.0.0_1759853531440_0.029520730010450746"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-07T16:12:11.319Z","1.0.0":"2025-10-07T16:12:11.651Z","modified":"2025-10-07T16:12:11.971Z"},"maintainers":[{"name":"aerocorp","email":"aerox3256@hotmail.com"}],"description":"Universal SDK for AeroCorp AGI Proxy Platform - Agnostic AI provider with intelligent routing","homepage":"https://agi.aerocorpindustries.org","keywords":["ai","agi","openai","gemini","anthropic","claude","mistral","grok","ollama","chatgpt","sdk","api","proxy","router","agnostic","aerocorp"],"repository":{"type":"git","url":"git+https://github.com/aerocorp/agi-proxy-sdk.git"},"author":{"name":"AeroCorp Industries","email":"support@aerocorpindustries.org"},"bugs":{"url":"https://github.com/aerocorp/agi-proxy-sdk/issues"},"license":"MIT","readme":"# AGI-PROXY SDK\n\nUniversal SDK for integrating with AeroCorp AGI Proxy Platform - Your agnostic AI provider with intelligent routing and fallback.\n\n## Features\n\n- 🚀 **Universal AI Access**: Single SDK for multiple AI providers (Gemini, OpenAI, Anthropic, Mistral, Grok, Ollama)\n- 🔄 **Intelligent Routing**: Automatic fallback between providers for maximum reliability\n- 🎯 **Default Model**: Pre-configured with `google/gemini-2.5-flash` for optimal performance\n- 🔌 **OpenAI Compatible**: Drop-in replacement for OpenAI SDK\n- 🛡️ **Built-in Retry Logic**: Automatic retries with exponential backoff\n- 📊 **Streaming Support**: Real-time streaming responses\n- 🔐 **Secure**: Optional API key authentication\n\n## Installation\n\n### NPM\n```bash\nnpm install @aerocorp/agi-proxy-sdk\n```\n\n### Yarn\n```bash\nyarn add @aerocorp/agi-proxy-sdk\n```\n\n### PNPM\n```bash\npnpm add @aerocorp/agi-proxy-sdk\n```\n\n## Quick Start\n\n### Basic Usage\n\n```typescript\nimport { createAGIProxySDK } from '@aerocorp/agi-proxy-sdk';\n\n// Initialize the SDK\nconst agi = createAGIProxySDK({\n  baseUrl: 'https://agi.aerocorpindustries.org',\n  apiKey: 'your-api-key', // Optional\n  defaultModel: 'google/gemini-2.5-flash'\n});\n\n// Create a chat completion\nconst response = await agi.createChatCompletion({\n  messages: [\n    { role: 'user', content: 'Hello, how are you?' }\n  ]\n});\n\nconsole.log(response.choices[0].message.content);\n```\n\n### Advanced Usage\n\n```typescript\nimport { AGIProxySDK } from '@aerocorp/agi-proxy-sdk';\n\nconst agi = new AGIProxySDK({\n  baseUrl: 'https://agi.aerocorpindustries.org',\n  apiKey: 'your-api-key',\n  defaultModel: 'google/gemini-2.5-flash',\n  timeout: 120000, // 120 seconds\n  retries: 3 // Number of retry attempts\n});\n\n// Chat completion with custom parameters\nconst response = await agi.createChatCompletion({\n  messages: [\n    { role: 'system', content: 'You are a helpful assistant.' },\n    { role: 'user', content: 'Explain quantum computing in simple terms.' }\n  ],\n  model: 'google/gemini-2.5-pro', // Override default model\n  temperature: 0.7,\n  max_tokens: 1024,\n  top_p: 1.0\n});\n```\n\n### Streaming Responses\n\n```typescript\nconst stream = agi.streamChatCompletion({\n  messages: [\n    { role: 'user', content: 'Write a short story about AI.' }\n  ],\n  stream: true\n});\n\nfor await (const chunk of stream) {\n  const content = chunk.choices[0]?.delta?.content;\n  if (content) {\n    process.stdout.write(content);\n  }\n}\n```\n\n### List Available Models\n\n```typescript\nconst models = await agi.listModels();\nconsole.log('Available models:', models.data);\n```\n\n### Health Check\n\n```typescript\nconst health = await agi.getHealth();\nconsole.log('Service status:', health);\n```\n\n## Available Models\n\nThe AGI Proxy supports multiple AI providers with intelligent fallback:\n\n### Google Gemini (Default)\n- `google/gemini-2.5-flash` - Fast and efficient (default)\n- `google/gemini-2.5-flash-lite` - Lightweight version\n- `google/gemini-2.5-pro` - Advanced reasoning\n- `google/gemini-flash-1.5` - Previous generation\n\n### OpenAI\n- `openai/gpt-4` - Most capable model\n- `openai/gpt-4-turbo` - Faster GPT-4\n- `openai/gpt-3.5-turbo` - Fast and cost-effective\n\n### Anthropic\n- `anthropic/claude-3.7-sonnet:beta-4.0` - Latest Claude\n- `anthropic/claude-3-opus` - Most capable\n- `anthropic/claude-3-sonnet` - Balanced\n\n### Mistral\n- `mistral/mistral-large` - Flagship model\n- `mistral/mistral-medium` - Balanced\n- `mistral/mistral-small` - Fast and efficient\n\n### Grok\n- `grok/grok-2` - Latest Grok model\n\n### Ollama (Local)\n- `ollama/llama3` - Meta's Llama 3\n- `ollama/deepseek-coder-v2:16b` - Code specialist\n- `ollama/qwen2.5vl:7b` - Vision model\n\n## Configuration Options\n\n```typescript\ninterface AGIProxyConfig {\n  baseUrl?: string;        // Default: 'https://agi.aerocorpindustries.org'\n  apiKey?: string;         // Optional API key\n  defaultModel?: string;   // Default: 'google/gemini-2.5-flash'\n  timeout?: number;        // Default: 120000 (120 seconds)\n  retries?: number;        // Default: 3\n}\n```\n\n## Error Handling\n\n```typescript\ntry {\n  const response = await agi.createChatCompletion({\n    messages: [{ role: 'user', content: 'Hello!' }]\n  });\n} catch (error) {\n  if (error instanceof Error) {\n    console.error('Error:', error.message);\n  }\n}\n```\n\n## TypeScript Support\n\nThe SDK is written in TypeScript and includes full type definitions:\n\n```typescript\nimport type {\n  ChatMessage,\n  ChatCompletionRequest,\n  ChatCompletionResponse,\n  Model,\n  ModelsResponse\n} from '@aerocorp/agi-proxy-sdk';\n```\n\n## Examples\n\n### ChatGPT-like Interface\n\n```typescript\nconst agi = createAGIProxySDK();\n\nasync function chat(userMessage: string) {\n  const response = await agi.createChatCompletion({\n    messages: [\n      { role: 'system', content: 'You are a helpful AI assistant.' },\n      { role: 'user', content: userMessage }\n    ]\n  });\n  \n  return response.choices[0].message.content;\n}\n\nconst answer = await chat('What is the meaning of life?');\nconsole.log(answer);\n```\n\n### Multi-turn Conversation\n\n```typescript\nconst conversation: ChatMessage[] = [\n  { role: 'system', content: 'You are a helpful assistant.' }\n];\n\nasync function sendMessage(message: string) {\n  conversation.push({ role: 'user', content: message });\n  \n  const response = await agi.createChatCompletion({\n    messages: conversation\n  });\n  \n  const assistantMessage = response.choices[0].message;\n  conversation.push(assistantMessage);\n  \n  return assistantMessage.content;\n}\n\nawait sendMessage('Hello!');\nawait sendMessage('Tell me a joke.');\n```\n\n## API Reference\n\n### `createAGIProxySDK(config?: AGIProxyConfig): AGIProxySDK`\nCreates a new SDK instance with the provided configuration.\n\n### `createChatCompletion(request: ChatCompletionRequest): Promise<ChatCompletionResponse>`\nCreates a chat completion with the specified messages and parameters.\n\n### `streamChatCompletion(request: ChatCompletionRequest): AsyncGenerator`\nStreams a chat completion response in real-time.\n\n### `listModels(): Promise<ModelsResponse>`\nLists all available models from all providers.\n\n### `getHealth(): Promise<any>`\nChecks the health status of the AGI Proxy service.\n\n## Support\n\n- **Documentation**: https://agi.aerocorpindustries.org/docs\n- **Issues**: https://github.com/aerocorp/agi-proxy-sdk/issues\n- **Email**: support@aerocorpindustries.org\n\n## License\n\nMIT License - Copyright (c) 2025 AeroCorp Industries\n\n## Contributing\n\nContributions are welcome! Please read our contributing guidelines before submitting PRs.\n\n","readmeFilename":"README.md","_rev":"1-0f9c9ad70facd7b2d80dffa704d81e77"}