@vybestack/llxprt-code-core 0.6.2 → 0.7.0-nightly.251207.a6190e71e

package/dist/src/providers/openai-vercel/OpenAIVercelProvider.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Copyright 2025 Vybestack LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { IContent } from '../../services/history/IContent.js';
+import { IProviderConfig } from '../types/IProviderConfig.js';
+import { BaseProvider, NormalizedGenerateChatOptions } from '../BaseProvider.js';
+import { OAuthManager } from '../../auth/precedence.js';
+import { IModel } from '../IModel.js';
+import { IProvider } from '../IProvider.js';
+/**
+ * Vercel OpenAI-based provider using AI SDK v5.
+ *
+ * NOTE:
+ * - No dependency on the official `openai` SDK.
+ * - Uses `openai.chat(modelId)` to talk to the Chat Completions API.
+ * - Tools are configured via AI SDK `tool()` with JSON schema input.
+ */
+export declare class OpenAIVercelProvider extends BaseProvider implements IProvider {
+    private getLogger;
+    /**
+     * @plan:PLAN-20251023-STATELESS-HARDENING.P08
+     * @requirement:REQ-SP4-003
+     * Constructor reduced to minimal initialization - no state captured.
+     */
+    constructor(apiKey: string | undefined, baseURL?: string, config?: IProviderConfig, oauthManager?: OAuthManager);
+    protected supportsOAuth(): boolean;
+    /**
+     * Create an OpenAI provider instance for this call using AI SDK v5.
+     *
+     * Uses the resolved runtime auth token and baseURL, and still allows
+     * local endpoints without authentication (for Ollama-style servers).
+     */
+    private createOpenAIClient;
+    /**
+     * Extract model parameters from normalized options instead of settings service.
+     * This mirrors OpenAIProvider but feeds AI SDK call options instead.
+     */
+    private extractModelParamsFromOptions;
+    private getAiJsonSchema;
+    private getAiTool;
+    /**
+     * Normalize tool IDs from various formats to OpenAI-style format.
+     * Kept for compatibility with existing history/tool logic.
+     */
+    private normalizeToOpenAIToolId;
+    /**
+     * Normalize tool IDs from OpenAI-style format to history format.
+     */
+    private normalizeToHistoryToolId;
+    /**
+     * Convert internal history IContent[] to AI SDK ModelMessage[].
+     *
+     * This implementation uses textual tool replay for past tool calls/results.
+     * New tool calls in the current response still use structured ToolCallBlocks.
+     *
+     * For Kimi K2 models, uses ToolIdStrategy to generate proper tool IDs
+     * in the format functions.{name}:{index} instead of call_xxx.
+     */
+    private convertToModelMessages;
+    /**
+     * Build an AI SDK ToolSet from already-normalized OpenAI-style tool definitions.
+     *
+     * Input is the array produced by convertToolsToOpenAIVercel().
+     */
+    private buildVercelTools;
+    private mapUsageToMetadata;
+    /**
+     * Extract thinking content from <think>, <thinking>, or <analysis> tags
+     * and return it as a ThinkingBlock. Returns null if no thinking tags found.
+     *
+     * This must be called BEFORE sanitizeText which strips these tags.
+     *
+     * Handles two formats:
+     * 1. Standard: <think>Full thinking paragraph here...</think>
+     * 2. Fragmented (Synthetic API): <think>word</think><think>word</think>...
+     *
+     * For fragmented format, joins with spaces. For standard, joins with newlines.
+     */
+    private extractThinkTagsAsBlock;
+    /**
+     * Sanitize text content from provider response by removing thinking tags and artifacts.
+     * This prevents <think>...</think> tags from leaking into visible output.
+     */
+    private sanitizeText;
+    /**
+     * Get a short preview of a message's content for debug logging.
+     */
+    private getContentPreview;
+    /**
+     * Core chat completion implementation using AI SDK v5.
+     *
+     * This replaces the original OpenAI SDK v5 client usage with:
+     *   - createOpenAI({ apiKey, baseURL })
+     *   - openai.chat(modelId)
+     *   - generateText / streamText
+     */
+    protected generateChatCompletionWithOptions(options: NormalizedGenerateChatOptions): AsyncIterableIterator<IContent>;
+    /**
+     * Models listing – uses HTTP GET /models via fetch instead of the OpenAI SDK.
+     * Falls back to a small static list if the request fails.
+     */
+    getModels(): Promise<IModel[]>;
+    private getFallbackModels;
+    getDefaultModel(): string;
+    getCurrentModel(): string;
+    clearClientCache(runtimeKey?: string): void;
+    clearState(): void;
+    getServerTools(): string[];
+    invokeServerTool(toolName: string, _params: unknown, _config?: unknown, _signal?: AbortSignal): Promise<unknown>;
+    getToolFormat(): string;
+    /**
+     * Detects the tool call format based on the model being used.
+     * Mirrors OpenAIProvider behavior so existing ToolFormatter logic works.
+     */
+    private detectToolFormat;
+    parseToolResponse(response: unknown): unknown;
+    /**
+     * Disallow memoization of model params to preserve stateless behavior.
+     */
+    setModelParams(_params: Record<string, unknown> | undefined): void;
+    /**
+     * Gets model parameters from SettingsService per call (stateless).
+     * Mirrors OpenAIProvider.getModelParams for compatibility.
+     */
+    getModelParams(): Record<string, unknown> | undefined;
+    /**
+     * Determines whether a response should be retried based on error codes.
+     *
+     * This is retained for compatibility with existing retryWithBackoff
+     * callers, even though AI SDK's generateText/streamText have their
+     * own built-in retry logic.
+     */
+    shouldRetryResponse(error: unknown): boolean;
+}