LLM Provider
Adds a new LLM provider implementing LLMProvider interface with call() and stream()...
Install
npx skills add caliber-ai-org/ai-setup --skill llm-provider -g -a claude-code -y- Repository
- caliber-ai-org/ai-setup1.3k
- Category
- AI and agents
- Updated
- 1mo ago
- License
- MIT
- Context cost
- Mediumabout 2,570 tokens
- Runs scripts
- No, instructions only
What it does
Adds a new LLM provider implementing LLMProvider interface with call() and stream() methods. Integrates with provider factory in src/llm/index.ts, config detection in src/llm/config.ts, and error handling via tracking and recovery. Use when adding a new model backend, integrating a third-party LLM API, or extending LLM platform support. Do NOT use for fixing bugs in existing providers, modifying existing provider behavior, or changing the LLMProvider interface.
LLM Provider
Critical
-
All providers MUST implement the LLMProvider interface from src/llm/types.ts with three methods:
- call(options: LLMCallOptions): Promise<string>, single non-streaming call returning text
- stream(options: LLMStreamOptions, callbacks: LLMStreamCallbacks): Promise<void>, streaming call invoking callbacks
- listModels?(): Promise<string[]>, optional; list available models from the API
-
Initialize client in constructor and store defaultModel from config. Example:
this.client = new YourSDK({ apiKey: config.apiKey }). Never lazy-initialize on first call, providers are instantiated once and cached in src/llm/index.ts. -
For EVERY response in call() and stream(), invoke trackUsage(model, usage) from src/llm/usage.js before returning/ending. This is mandatory, it captures token metrics for CLI telemetry and cost analysis. If the API doesn't return usage data, estimate via estimateTokens(text), which assumes ~4 chars per token.
-
Both call() and stream() must respect the model parameter using pattern:
options.model || this.defaultModel. Never hardcode model names. Callers supply model overrides via LLMCallOptions.model. -
Error handling: catch all errors, preserve error messages unchanged. The retry logic in src/llm/index.ts handles transient errors (ECONNRESET, socket hang up, 529 overload). For seat-based providers (Cursor, Claude CLI), wrap stderr via parseSeatBasedError() for user-friendly messages.
-
Always update ProviderType union (Step 2), DEFAULT_MODELS (Step 4), and createProvider() switch case (Step 5) in lock-step. Missing any one breaks the build or causes runtime Unknown provider error.
Instructions
Step 1: Create provider class file
Verify directory exists: ls -la src/llm/. Create src/llm/your-provider.ts. Match existing provider patterns (src/llm/anthropic.ts, src/llm/openai-compat.ts).
