@vybestack/llxprt-code-core 0.4.7 → 0.5.0-nightly.251102.f115237d

package/dist/src/providers/BaseProvider.d.ts

@@ -3,15 +3,16 @@
  * Copyright 2025 Vybestack LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-/**
- * Base provider class with authentication precedence logic
- */
-import { IProvider } from './IProvider.js';
+import { IProvider, GenerateChatOptions, ProviderToolset } from './IProvider.js';
 import { IModel } from './IModel.js';
 import { IContent } from '../services/history/IContent.js';
 import { AuthPrecedenceResolver, OAuthManager } from '../auth/precedence.js';
 import type { Config } from '../config/config.js';
 import { IProviderConfig } from './types/IProviderConfig.js';
+import type { ProviderRuntimeContext } from '../runtime/providerRuntimeContext.js';
+import { type RuntimeInvocationContext } from '../runtime/RuntimeInvocationContext.js';
+import { SettingsService } from '../settings/SettingsService.js';
+import type { ProviderTelemetryContext, ResolvedAuthToken, UserMemoryInput } from './types/providerRuntime.js';
 export interface BaseProviderConfig {
     name: string;
     apiKey?: string;
@@ -21,6 +22,21 @@ export interface BaseProviderConfig {
     oauthProvider?: string;
     oauthManager?: OAuthManager;
 }
+export interface NormalizedGenerateChatOptions extends GenerateChatOptions {
+    settings: SettingsService;
+    config?: Config;
+    userMemory?: UserMemoryInput;
+    runtime?: ProviderRuntimeContext;
+    invocation: RuntimeInvocationContext;
+    tools?: ProviderToolset;
+    metadata: Record<string, unknown>;
+    resolved: {
+        model: string;
+        baseURL?: string;
+        authToken: ResolvedAuthToken;
+        telemetry?: ProviderTelemetryContext;
+    };
+}
 /**
  * Abstract base provider class that implements authentication precedence logic
  * This class provides lazy OAuth triggering and proper authentication precedence
@@ -30,25 +46,53 @@ export declare abstract class BaseProvider implements IProvider {
     protected authResolver: AuthPrecedenceResolver;
     protected baseProviderConfig: BaseProviderConfig;
     protected providerConfig?: IProviderConfig;
-    protected globalConfig?: Config;
-    protected cachedAuthToken?: string;
-    protected authCacheTimestamp?: number;
-    protected readonly AUTH_CACHE_DURATION = 60000;
+    /**
+     * @plan PLAN-20250218-STATELESSPROVIDER.P05
+     * @requirement REQ-SP-001
+     * @pseudocode provider-invocation.md lines 8-15
+     */
+    private defaultSettingsService;
+    private defaultConfig?;
+    private readonly activeCallContext;
     protected throttleTracker?: (waitTimeMs: number) => void;
-    constructor(config: BaseProviderConfig, providerConfig?: IProviderConfig, globalConfig?: Config);
+    protected get globalConfig(): Config | undefined;
+    protected set globalConfig(config: Config | undefined);
+    constructor(config: BaseProviderConfig, providerConfig?: IProviderConfig, globalConfig?: Config, settingsService?: SettingsService);
+    /**
+     * @plan PLAN-20251018-STATELESSPROVIDER2.P06
+     * @plan:PLAN-20251018-STATELESSPROVIDER2.P06
+     * @requirement REQ-SP2-001
+     * @pseudocode base-provider-call-contract.md lines 1-2
+     */
+    setRuntimeSettingsService(settingsService: SettingsService | null | undefined): void;
+    /**
+     * @plan PLAN-20251018-STATELESSPROVIDER2.P06
+     * @plan:PLAN-20251023-STATELESS-HARDENING.P05
+     * @requirement REQ-SP2-001
+     * @requirement:REQ-SP4-001
+     * @pseudocode base-provider-call-contract.md lines 1-3
+     */
+    protected resolveSettingsService(): SettingsService;
     /**
      * Set throttle tracking callback (used by LoggingProviderWrapper)
      */
     setThrottleTracker(tracker: (waitTimeMs: number) => void): void;
     /**
+     * @plan PLAN-20251018-STATELESSPROVIDER2.P06
+     * @requirement REQ-SP2-001
+     * @pseudocode base-provider-call-contract.md lines 2-3
      * Gets the base URL with proper precedence:
      * 1. Ephemeral settings (highest priority - from /baseurl or profile)
-     * 2. Provider config (from IProviderConfig)
-     * 3. Base provider config (initial constructor value)
-     * 4. undefined (use provider default)
+     * 2. Provider-specific settings in SettingsService
+     * 3. Provider config (from IProviderConfig)
+     * 4. Base provider config (initial constructor value)
+     * 5. undefined (use provider default)
      */
     protected getBaseURL(): string | undefined;
     /**
+     * @plan PLAN-20251018-STATELESSPROVIDER2.P06
+     * @requirement REQ-SP2-001
+     * @pseudocode base-provider-call-contract.md lines 2-3
      * Gets the current model with proper precedence:
      * 1. Ephemeral settings (highest priority)
      * 2. Provider-specific settings in SettingsService
@@ -56,7 +100,12 @@ export declare abstract class BaseProvider implements IProvider {
      * 4. Default model
      */
     protected getModel(): string;
+    private computeBaseURL;
+    private computeModel;
     /**
+     * @plan PLAN-20251018-STATELESSPROVIDER2.P06
+     * @requirement REQ-SP2-001
+     * @pseudocode base-provider-call-contract.md lines 1-3
      * Gets authentication token using the precedence chain
      * This method implements lazy OAuth triggering - only triggers OAuth when actually making API calls
      * Returns empty string if no auth is available (for local/self-hosted endpoints)
@@ -72,29 +121,30 @@ export declare abstract class BaseProvider implements IProvider {
      */
     protected abstract supportsOAuth(): boolean;
     /**
+     * @plan PLAN-20251018-STATELESSPROVIDER2.P06
+     * @requirement REQ-SP2-001
+     * @pseudocode base-provider-call-contract.md lines 1-3
      * Checks if authentication is available without triggering OAuth
      */
     hasNonOAuthAuthentication(): Promise<boolean>;
     /**
+     * @plan PLAN-20251018-STATELESSPROVIDER2.P06
+     * @requirement REQ-SP2-001
+     * @pseudocode base-provider-call-contract.md lines 1-3
      * Checks if OAuth is the only available authentication method
      */
     isOAuthOnlyAvailable(): Promise<boolean>;
     /**
+     * @plan PLAN-20251018-STATELESSPROVIDER2.P06
+     * @requirement REQ-SP2-001
+     * @pseudocode base-provider-call-contract.md lines 1-3
      * Gets the current authentication method name for debugging
      */
     getAuthMethodName(): Promise<string | null>;
-    /**
-     * Updates the API key (used for CLI --key argument and other sources)
-     */
-    setApiKey(apiKey: string): void;
     /**
      * Clears authentication (used when removing keys/keyfiles)
      */
     clearAuth?(): void;
-    /**
-     * Updates the base URL in ephemeral settings
-     */
-    setBaseUrl?(baseUrl?: string): void;
     /**
      * Updates OAuth configuration
      */
@@ -109,23 +159,58 @@ export declare abstract class BaseProvider implements IProvider {
     isAuthenticated(): Promise<boolean>;
     abstract getModels(): Promise<IModel[]>;
     abstract getDefaultModel(): string;
-    abstract generateChatCompletion(content: IContent[], tools?: Array<{
-        functionDeclarations: Array<{
-            name: string;
-            description?: string;
-            parameters?: unknown;
-        }>;
-    }>, signal?: AbortSignal): AsyncIterableIterator<IContent>;
-    setModel?(_modelId: string): void;
+    /**
+     * @plan PLAN-20250218-STATELESSPROVIDER.P04
+     * @requirement REQ-SP-001
+     * @pseudocode base-provider.md lines 4-15
+     */
+    generateChatCompletion(options: GenerateChatOptions): AsyncIterableIterator<IContent>;
+    generateChatCompletion(contents: IContent[], tools?: ProviderToolset): AsyncIterableIterator<IContent>;
+    /**
+     * @plan PLAN-20250218-STATELESSPROVIDER.P04
+     * @requirement REQ-SP-001
+     * @pseudocode base-provider.md lines 7-15
+     */
+    protected abstract generateChatCompletionWithOptions(options: NormalizedGenerateChatOptions): AsyncIterableIterator<IContent>;
+    /**
+     * @plan PLAN-20251018-STATELESSPROVIDER2.P06
+     * @requirement REQ-SP2-001
+     * @pseudocode base-provider-call-contract.md lines 3-5
+     */
+    private invokeWithNormalizedOptions;
+    /**
+     * @plan PLAN-20251018-STATELESSPROVIDER2.P06
+     * @plan:PLAN-20251023-STATELESS-HARDENING.P05
+     * @requirement REQ-SP2-001
+     * @requirement:REQ-SP4-001
+     * @pseudocode base-provider-call-contract.md lines 1-3
+     */
+    private normalizeGenerateChatOptions;
+    private buildEphemeralsSnapshot;
+    /**
+     * @plan:PLAN-20251023-STATELESS-HARDENING.P05
+     * @requirement:REQ-SP4-001
+     * @pseudocode base-provider-fallback-removal.md lines 11-14
+     */
+    protected assertRuntimeContext(input: {
+        providerKey: string;
+        settings?: SettingsService | null;
+        config?: Config | null;
+        runtime?: ProviderRuntimeContext;
+        metadata?: Record<string, unknown>;
+        resolved?: NormalizedGenerateChatOptions['resolved'];
+        stage: string;
+    }): {
+        runtime: ProviderRuntimeContext;
+        metadata: Record<string, unknown>;
+    };
     getCurrentModel?(): string;
     getToolFormat?(): string;
-    setToolFormatOverride?(_format: string | null): void;
     isPaidMode?(): boolean;
     clearState?(): void;
     setConfig?(config: unknown): void;
     getServerTools(): string[];
     invokeServerTool(toolName: string, _params: unknown, _config?: unknown, _signal?: AbortSignal): Promise<unknown>;
-    setModelParams?(_params: Record<string, unknown> | undefined): void;
     getModelParams?(): Record<string, unknown> | undefined;
     /**
      * Get setting value from SettingsService