nova-terminal-assistant 0.1.0

package/src/core/model/providers/OllamaManager.ts

@@ -0,0 +1,201 @@
+// ============================================================================
+// OllamaManager - Ollama native API wrapper for model management
+// ============================================================================
+//
+// Wraps Ollama's REST API for operations beyond simple chat completion:
+// - List/pull/delete/show local models
+// - Check Ollama server status and version
+// - Runtime model discovery and auto-registration
+// ============================================================================
+
+import type { ModelConfig } from '../../types/config.js';
+
+/** A model entry from Ollama's /api/tags */
+export interface OllamaModel {
+  name: string;
+  model: string;
+  modified_at: string;
+  size: number;
+  digest: string;
+  details: {
+    parent_model?: string;
+    format: string;
+    family: string;
+    families?: string[];
+    parameter_size: string;
+    quantization_level: string;
+  };
+}
+
+/** Progress info for model pull operations */
+export interface OllamaPullProgress {
+  status: string;
+  digest?: string;
+  total?: number;
+  completed?: number;
+  percent?: number;
+}
+
+/** Model info from Ollama's /api/show */
+export interface OllamaModelInfo {
+  license?: string;
+  modelfile?: string;
+  parameters?: string;
+  template?: string;
+  details: {
+    parent_model?: string;
+    format: string;
+    family: string;
+    families?: string[];
+    parameter_size: string;
+    quantization_level: string;
+  };
+  model_info?: Record<string, unknown>;
+}
+
+/** Result from Ollama's /api/version */
+export interface OllamaVersion {
+  version: string;
+}
+
+export class OllamaManager {
+  private baseUrl: string;
+  private timeout: number;
+
+  constructor(baseUrl?: string, timeoutMs = 30000) {
+    this.baseUrl = (baseUrl || 'http://localhost:11434').replace(/\/+$/, '');
+    this.timeout = timeoutMs;
+  }
+
+  /** Check if Ollama server is running */
+  async ping(): Promise<boolean> {
+    try {
+      const res = await fetch(`${this.baseUrl}/api/tags`, {
+        signal: AbortSignal.timeout(5000),
+      });
+      return res.ok;
+    } catch {
+      return false;
+    }
+  }
+
+  /** Get Ollama server version */
+  async version(): Promise<string> {
+    const res = await this.request<{ version: string }>('/api/version', undefined, 'GET');
+    return res.version;
+  }
+
+  /** List all locally installed models */
+  async listModels(): Promise<OllamaModel[]> {
+    const res = await this.request<{ models: OllamaModel[] }>('/api/tags', undefined, 'GET');
+    return res.models || [];
+  }
+
+  /** Show detailed info about a model */
+  async showModel(name: string): Promise<OllamaModelInfo> {
+    return this.request<OllamaModelInfo>('/api/show', { name }, 'POST');
+  }
+
+  /**
+   * Pull a model from Ollama Hub. Calls onProgress periodically with download status.
+   * Returns when the pull is complete.
+   */
+  async pullModel(name: string, onProgress?: (progress: OllamaPullProgress) => void): Promise<void> {
+    const res = await fetch(`${this.baseUrl}/api/pull`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ name, stream: true }),
+      signal: AbortSignal.timeout(this.timeout * 60), // Pull can take a long time
+    });
+
+    if (!res.ok) {
+      throw new Error(`Ollama pull failed: ${res.status} ${res.statusText}`);
+    }
+
+    const reader = res.body?.getReader();
+    if (!reader) throw new Error('No response body');
+
+    const decoder = new TextDecoder();
+    let buffer = '';
+
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split('\n');
+      buffer = lines.pop() || '';
+
+      for (const line of lines) {
+        if (!line.trim()) continue;
+        try {
+          const progress: OllamaPullProgress = JSON.parse(line);
+          if (onProgress) onProgress(progress);
+        } catch {
+          // Skip malformed lines
+        }
+      }
+    }
+  }
+
+  /** Delete a locally installed model */
+  async deleteModel(name: string): Promise<void> {
+    const res = await this.request<{ status: string }>('/api/delete', { name }, 'DELETE');
+    // Some Ollama versions return empty body for DELETE
+  }
+
+  /**
+   * Convert Ollama models to Nova ModelConfig for auto-registration.
+   * Attempts to infer capabilities from model metadata.
+   */
+  toModelConfig(model: OllamaModel): ModelConfig {
+    const paramSize = model.details?.parameter_size || '';
+    const isLarge = paramSize.includes('70B') || paramSize.includes('72B') || paramSize.includes('65B');
+    const isMedium = paramSize.includes('32B') || paramSize.includes('34B') || paramSize.includes('14B');
+
+    // Estimate context window from model family
+    let contextTokens = 8192;
+    const family = (model.details?.family || '').toLowerCase();
+    if (family.includes('qwen')) contextTokens = 131072;
+    else if (family.includes('llama')) contextTokens = isLarge ? 131072 : 128000;
+    else if (family.includes('deepseek')) contextTokens = 128000;
+    else if (family.includes('mistral')) contextTokens = isLarge ? 131072 : 32768;
+    else if (family.includes('gemma')) contextTokens = isMedium ? 8192 : 128000;
+    else contextTokens = isLarge ? 131072 : 32768;
+
+    return {
+      name: model.name,
+      maxContextTokens: contextTokens,
+      maxOutputTokens: Math.min(contextTokens, isLarge ? 8192 : 4096),
+      supportsVision: family.includes('llava') || family.includes('qwen-vl'),
+      supportsTools: true, // Most models support tools via Ollama's OpenAI compat
+      supportsStreaming: true,
+      supportsThinking: false,
+    };
+  }
+
+  // --- Private helpers ---
+
+  private async request<T>(path: string, body?: Record<string, unknown>, method = 'POST'): Promise<T> {
+    const url = `${this.baseUrl}${path}`;
+    const options: RequestInit = {
+      method,
+      headers: { 'Content-Type': 'application/json' },
+      signal: AbortSignal.timeout(this.timeout),
+    };
+    if (body && method !== 'GET') {
+      options.body = JSON.stringify(body);
+    }
+
+    const res = await fetch(url, options);
+    if (!res.ok) {
+      const text = await res.text().catch(() => '');
+      throw new Error(`Ollama API error ${res.status}: ${text || res.statusText}`);
+    }
+
+    // Some endpoints return empty body (e.g., DELETE)
+    const text = await res.text();
+    if (!text) return {} as T;
+    return JSON.parse(text);
+  }
+}

package/src/core/model/providers/OllamaProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OllamaProvider.d.ts","sourceRoot":"","sources":["OllamaProvider.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,qBAAa,cAAe,SAAQ,wBAAwB;IAC1D,QAAQ,CAAC,IAAI,YAAY;gBAEb,MAAM,EAAE,oBAAoB;IAUxC;;;;OAIG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE;IAiBjF,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,GAAG,QAAQ,GAAG,KAAK;IAS5E,SAAS,CAAC,iBAAiB,CAAC,GAAG,EAAE,OAAO;CAQzC"}

package/src/core/model/providers/OllamaProvider.ts

@@ -0,0 +1,73 @@
+// ============================================================================
+// Ollama Provider - Local LLM via Ollama OpenAI-compatible API
+// ============================================================================
+// Refactored: now extends OpenAICompatibleProvider base class.
+// Handles Ollama-specific concerns: no API key, /v1 suffix, friendly error hints.
+// ============================================================================
+
+import type { OpenAICompatibleConfig } from './OpenAICompatibleProvider.js';
+import { OpenAICompatibleProvider } from './OpenAICompatibleProvider.js';
+import type { ToolDefinition } from '../../types/tools.js';
+
+export interface OllamaProviderConfig {
+  /** Base URL for Ollama, defaults to http://localhost:11434 */
+  baseUrl?: string;
+  /** Model name (e.g., llama3, codellama, mistral) */
+  model: string;
+  /** Custom headers */
+  headers?: Record<string, string>;
+}
+
+export class OllamaProvider extends OpenAICompatibleProvider {
+  readonly name = 'Ollama';
+
+  constructor(config: OllamaProviderConfig) {
+    super({
+      apiKey: 'ollama', // Ollama doesn't require a real API key
+      baseUrl: config.baseUrl || 'http://localhost:11434',
+      model: config.model,
+      headers: config.headers,
+      appendV1Suffix: true, // Ollama needs /v1 appended to baseUrl
+    });
+  }
+
+  /**
+   * Ollama: whitelist-based tools filtering.
+   * Many Ollama models (e.g., deepseek-r1) do not support function calling.
+   * Only well-known tool-capable model families get tools passed through.
+   */
+  protected filterTools(tools: ToolDefinition[], modelId: string): ToolDefinition[] {
+    if (tools.length === 0) return tools;
+
+    const modelLower = modelId.toLowerCase();
+    const toolCapable = [
+      'llama3', 'llama3.1', 'llama3.2', 'llama3.3',
+      'qwen2.5', 'qwen2', 'mistral', 'mixtral',
+      'gemma2', 'gemma3', 'codellama',
+      'phi3', 'phi4', 'command-r',
+    ];
+
+    if (!toolCapable.some(p => modelLower.includes(p))) {
+      return []; // Strip tools for unknown/unsupported models
+    }
+    return tools;
+  }
+
+  protected handleError(err: unknown, operation: 'complete' | 'stream'): never {
+    const msg = (err as Error).message || String(err);
+    const hint = msg.includes('ECONNREFUSED') || msg.includes('connect')
+      ? ' Is Ollama running? Try `ollama serve` or check https://ollama.com for installation.'
+      : '';
+    const enhanced = new Error(`${msg}.${hint}`);
+    super.handleError(enhanced, operation);
+  }
+
+  protected handleStreamError(err: unknown) {
+    const msg = (err as Error).message || String(err);
+    const hint = msg.includes('ECONNREFUSED') || msg.includes('connect')
+      ? ' Is Ollama running? Try `ollama serve` or check https://ollama.com for installation.'
+      : '';
+    const enhanced = new Error(`${msg}.${hint}`);
+    return super.handleStreamError(enhanced);
+  }
+}

package/src/core/model/providers/OpenAICompatibleProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAICompatibleProvider.d.ts","sourceRoot":"","sources":["OpenAICompatibleProvider.ts"],"names":[],"mappings":"AAWA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAqC,MAAM,wBAAwB,CAAC;AACvG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI9G,sEAAsE;AACtE,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,sDAAsD;IACtD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,8BAAsB,wBAAyB,YAAW,aAAa;IACrE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEb,MAAM,EAAE,sBAAsB;IAe1C;;;OAGG;IACH,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,GAAG,QAAQ,GAAG,KAAK;IAgB5E,2DAA2D;IAC3D,SAAS,CAAC,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW;IAetD;;;;;;OAMG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE;IAM3E,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IA+BlF,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,mBAAmB,GAAG,cAAc,CAAC,WAAW,CAAC;IA4DvF,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAYvD,SAAS,CAAC,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,0BAA0B,EAAE;IAsD1G,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,kBAAkB,EAAE;IAW5E,SAAS,CAAC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,YAAY,EAAE;IA2BtF,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,eAAe,GAAG,SAAS,GAAG,UAAU;IAO7E,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,CAAC,YAAY,CAAC;IAU3F;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAatC"}

package/src/core/model/providers/OpenAICompatibleProvider.ts

@@ -0,0 +1,327 @@
+// ============================================================================
+// OpenAICompatibleProvider - Base class for all OpenAI-compatible providers
+// ============================================================================
+//
+// This base class handles all shared logic for providers that use the OpenAI
+// SDK with an OpenAI-compatible API endpoint. Subclasses only need to define:
+// - Provider name
+// - Constructor (how to create the OpenAI client)
+// - Error handling specifics (provider name in error messages)
+// ============================================================================
+
+import OpenAI from 'openai';
+import type { Message, ContentBlock, ToolUseContent, ToolResultContent } from '../../types/session.js';
+import type { ToolDefinition } from '../../types/tools.js';
+import type { ModelProvider, ModelRequestOptions, ModelResponse, TokenUsage, StreamEvent } from '../types.js';
+import { ModelError, RateLimitError } from '../../types/errors.js';
+import { createToolCallId } from '../../types/session.js';
+
+/** Configuration options shared by all OpenAI-compatible providers */
+export interface OpenAICompatibleConfig {
+  apiKey?: string;
+  baseUrl?: string;
+  model: string;
+  organizationId?: string;
+  headers?: Record<string, string>;
+  /** Append /v1 suffix to baseUrl (needed by Ollama) */
+  appendV1Suffix?: boolean;
+}
+
+export abstract class OpenAICompatibleProvider implements ModelProvider {
+  abstract readonly name: string;
+  protected client: OpenAI;
+
+  constructor(config: OpenAICompatibleConfig) {
+    let baseURL = config.baseUrl;
+    if (baseURL && config.appendV1Suffix) {
+      baseURL = baseURL.replace(/\/+$/, '') + '/v1';
+    }
+    this.client = new OpenAI({
+      apiKey: config.apiKey || 'no-key-required',
+      baseURL,
+      ...(config.organizationId && { organization: config.organizationId }),
+      ...(config.headers && { defaultHeaders: config.headers }),
+    });
+  }
+
+  // --- Provider-specific hooks ---
+
+  /**
+   * Override to customize the error handling in complete()
+   * Subclasses should call super.handleError(err, operation) after wrapping the error.
+   */
+  protected handleError(err: unknown, operation: 'complete' | 'stream'): never {
+    if (err instanceof OpenAI.APIError) {
+      if (err.status === 429) {
+        const retryAfter = parseInt(err.headers?.['retry-after'] || '60', 10) * 1000;
+        throw new RateLimitError(err.message, retryAfter, this.name);
+      }
+      throw new ModelError(err.message, err.status, this.name, err);
+    }
+    throw new ModelError(
+      `${this.name} ${operation} failed: ${(err as Error).message}`,
+      undefined,
+      this.name,
+      { originalError: err }
+    );
+  }
+
+  /** Override to customize the error handling in stream() */
+  protected handleStreamError(err: unknown): StreamEvent {
+    if (err instanceof OpenAI.APIError) {
+      return { type: 'error', error: new ModelError(err.message, err.status, this.name, err) };
+    }
+    return {
+      type: 'error',
+      error: new ModelError(
+        `${this.name} stream failed: ${(err as Error).message}`,
+        undefined,
+        this.name,
+        { originalError: err }
+      ),
+    };
+  }
+
+  /**
+   * Hook to filter or disable tools before sending to the API.
+   * Override in subclasses to conditionally disable tools (e.g., for models that don't support them).
+   * Default implementation passes tools through unchanged.
+   * @param tools - The tool definitions to filter
+   * @param modelId - The model ID being called (useful for per-model decisions)
+   */
+  protected filterTools(tools: ToolDefinition[], modelId: string): ToolDefinition[] {
+    return tools;
+  }
+
+  // --- Shared implementations ---
+
+  async complete(messages: Message[], options: ModelRequestOptions): Promise<ModelResponse> {
+    try {
+      const openaiMessages = this.convertMessages(messages, options.systemPrompt);
+      const tools = this.convertTools(this.filterTools(options.tools, options.model));
+
+      const params: OpenAI.ChatCompletionCreateParams = {
+        model: options.model,
+        max_tokens: options.maxTokens,
+        messages: openaiMessages,
+        temperature: options.temperature,
+        ...(tools.length > 0 && { tools }),
+        ...(options.stopSequences && options.stopSequences.length > 0 && { stop: options.stopSequences }),
+      };
+
+      const response = await this.client.chat.completions.create(params);
+      const choice = response.choices[0]!;
+      const content = this.convertResponseContent(choice);
+      const usage = this.convertUsage(response.usage);
+
+      return {
+        content,
+        model: response.model,
+        stopReason: this.convertStopReason(choice.finish_reason),
+        usage,
+        sessionId: options.sessionId,
+      };
+    } catch (err) {
+      this.handleError(err, 'complete');
+    }
+  }
+
+  async *stream(messages: Message[], options: ModelRequestOptions): AsyncGenerator<StreamEvent> {
+    try {
+      const openaiMessages = this.convertMessages(messages, options.systemPrompt);
+      const tools = this.convertTools(this.filterTools(options.tools, options.model));
+
+      const params: OpenAI.ChatCompletionCreateParams = {
+        model: options.model,
+        max_tokens: options.maxTokens,
+        messages: openaiMessages,
+        temperature: options.temperature,
+        ...(tools.length > 0 && { tools }),
+        stream: true,
+      };
+
+      const stream = await this.client.chat.completions.create(params);
+      let currentToolCallId = '';
+      let currentToolName = '';
+
+      for await (const chunk of stream as AsyncIterable<OpenAI.ChatCompletionChunk>) {
+        const delta = chunk.choices[0]?.delta;
+        if (!delta) continue;
+
+        if (delta.content) {
+          yield { type: 'text_delta', delta: delta.content };
+        }
+
+        if (delta.tool_calls) {
+          for (const tc of delta.tool_calls) {
+            if (tc.id) {
+              currentToolCallId = tc.id;
+              currentToolName = tc.function?.name || '';
+              yield { type: 'tool_call_start', toolCallId: tc.id, toolName: currentToolName };
+            }
+            if (tc.function?.arguments) {
+              yield {
+                type: 'tool_call_delta',
+                toolCallId: tc.id || currentToolCallId,
+                delta: tc.function.arguments,
+              };
+            }
+          }
+        }
+
+        if (chunk.choices[0]?.finish_reason) {
+          const usage: TokenUsage = {
+            inputTokens: chunk.usage?.prompt_tokens ?? 0,
+            outputTokens: chunk.usage?.completion_tokens ?? 0,
+          };
+          yield {
+            type: 'message_complete',
+            stopReason: this.convertStopReason(chunk.choices[0].finish_reason),
+            usage,
+          };
+        }
+      }
+    } catch (err) {
+      yield this.handleStreamError(err);
+    }
+  }
+
+  async countTokens(messages: Message[]): Promise<number> {
+    const text = messages
+      .map((m) => m.content
+        .filter((c): c is Extract<ContentBlock, { type: 'text' }> => c.type === 'text')
+        .map((c) => c.text)
+        .join(' '))
+      .join(' ');
+    return Math.ceil(text.length / 4);
+  }
+
+  // --- Conversion helpers (shared by all OpenAI-compatible providers) ---
+
+  protected convertMessages(messages: Message[], systemPrompt?: string): OpenAI.ChatCompletionMessageParam[] {
+    const result: OpenAI.ChatCompletionMessageParam[] = [];
+
+    if (systemPrompt) {
+      result.push({ role: 'system', content: systemPrompt });
+    }
+
+    for (const msg of messages) {
+      if (msg.role === 'system') {
+        result.push({ role: 'system', content: msg.content.map((c) => c.type === 'text' ? c.text : '').join('') });
+        continue;
+      }
+
+      if (msg.role === 'tool') {
+        const toolResults = msg.content
+          .filter((c): c is ToolResultContent => c.type === 'tool_result')
+          .map((c) => ({
+            role: 'tool' as const,
+            tool_call_id: c.tool_use_id,
+            content: typeof c.content === 'string' ? c.content : c.content.map((cc) => 'text' in cc ? cc.text : '').join(''),
+          }));
+        result.push(...toolResults);
+        continue;
+      }
+
+      // user or assistant
+      const textContent = msg.content
+        .filter((c): c is Extract<ContentBlock, { type: 'text' }> => c.type === 'text')
+        .map((c) => c.text)
+        .join('');
+
+      const toolCalls = msg.content
+        .filter((c): c is ToolUseContent => c.type === 'tool_use')
+        .map((c) => ({
+          id: c.id,
+          type: 'function' as const,
+          function: { name: c.name, arguments: JSON.stringify(c.input) },
+        }));
+
+      if (msg.role === 'assistant') {
+        const param: OpenAI.ChatCompletionAssistantMessageParam = {
+          role: 'assistant',
+          content: textContent || null,
+          ...(toolCalls.length > 0 && { tool_calls: toolCalls }),
+        };
+        result.push(param);
+      } else {
+        result.push({ role: 'user', content: textContent });
+      }
+    }
+
+    return result;
+  }
+
+  protected convertTools(tools: ToolDefinition[]): OpenAI.ChatCompletionTool[] {
+    return tools.map((t) => ({
+      type: 'function' as const,
+      function: {
+        name: t.name,
+        description: t.description,
+        parameters: t.inputSchema,
+      },
+    }));
+  }
+
+  protected convertResponseContent(choice: OpenAI.ChatCompletion.Choice): ContentBlock[] {
+    const content: ContentBlock[] = [];
+
+    if (choice.message.content) {
+      content.push({ type: 'text', text: choice.message.content });
+    }
+
+    if (choice.message.tool_calls) {
+      for (const tc of choice.message.tool_calls) {
+        let input: Record<string, unknown>;
+        try {
+          input = JSON.parse(tc.function.arguments);
+        } catch {
+          input = { raw: tc.function.arguments };
+        }
+        content.push({
+          type: 'tool_use',
+          id: createToolCallId(tc.id),
+          name: tc.function.name,
+          input,
+        });
+      }
+    }
+
+    return content;
+  }
+
+  protected convertUsage(usage: OpenAI.CompletionUsage | undefined): TokenUsage {
+    return {
+      inputTokens: usage?.prompt_tokens ?? 0,
+      outputTokens: usage?.completion_tokens ?? 0,
+    };
+  }
+
+  protected convertStopReason(reason: string | null | undefined): ModelResponse['stopReason'] {
+    switch (reason) {
+      case 'stop': return 'end_turn';
+      case 'tool_calls': return 'tool_use';
+      case 'length': return 'max_tokens';
+      case 'content_filter': return 'end_turn';
+      default: return 'end_turn';
+    }
+  }
+
+  /**
+   * List available models from the API.
+   * Returns model IDs that can be used with this provider.
+   */
+  async listModels(): Promise<string[]> {
+    try {
+      const response = await this.client.models.list();
+      const models: string[] = [];
+      for await (const model of response) {
+        models.push(model.id);
+      }
+      return models.sort();
+    } catch {
+      // If the API doesn't support /models endpoint, return empty array
+      return [];
+    }
+  }
+}

package/src/core/model/providers/OpenAIProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAIProvider.d.ts","sourceRoot":"","sources":["OpenAIProvider.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,cAAe,SAAQ,wBAAwB;IAC1D,QAAQ,CAAC,IAAI,YAAY;gBAEb,MAAM,EAAE,oBAAoB;CAQzC"}

package/src/core/model/providers/OpenAIProvider.ts

@@ -0,0 +1,29 @@
+// ============================================================================
+// OpenAI Provider - GPT API integration
+// ============================================================================
+// Refactored: now extends OpenAICompatibleProvider base class.
+// Only provider-specific logic remains (constructor, error hints).
+// ============================================================================
+
+import type { OpenAICompatibleConfig } from './OpenAICompatibleProvider.js';
+import { OpenAICompatibleProvider } from './OpenAICompatibleProvider.js';
+
+export interface OpenAIProviderConfig {
+  apiKey: string;
+  baseUrl?: string;
+  organizationId?: string;
+  model: string;
+}
+
+export class OpenAIProvider extends OpenAICompatibleProvider {
+  readonly name = 'OpenAI';
+
+  constructor(config: OpenAIProviderConfig) {
+    super({
+      apiKey: config.apiKey,
+      baseUrl: config.baseUrl,
+      model: config.model,
+      organizationId: config.organizationId,
+    });
+  }
+}

package/src/core/model/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/src/core/model/providers/index.ts

@@ -0,0 +1,12 @@
+export { AnthropicProvider } from './AnthropicProvider.js';
+export type { AnthropicProviderConfig } from './AnthropicProvider.js';
+export { OpenAICompatibleProvider } from './OpenAICompatibleProvider.js';
+export type { OpenAICompatibleConfig } from './OpenAICompatibleProvider.js';
+export { OpenAIProvider } from './OpenAIProvider.js';
+export type { OpenAIProviderConfig } from './OpenAIProvider.js';
+export { OllamaProvider } from './OllamaProvider.js';
+export type { OllamaProviderConfig } from './OllamaProvider.js';
+export { OllamaCloudProvider } from './OllamaCloudProvider.js';
+export type { OllamaCloudConfig } from './OllamaCloudProvider.js';
+export { OllamaManager } from './OllamaManager.js';
+export type { OllamaModel, OllamaPullProgress, OllamaModelInfo } from './OllamaManager.js';

package/src/core/model/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"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"}