@vybestack/llxprt-code-providers 0.10.0-nightly.260608.a9c742716

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @plan:PLAN-20260603-ISSUE1584.P06
+ * @requirement:REQ-PKG-001
+ * @pseudocode lines 13-14
+ */
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from './src/index.js';

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * @plan:PLAN-20260603-ISSUE1584.P06
+ * @requirement:REQ-PKG-001
+ * @pseudocode lines 13-14
+ */
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from './src/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AAEH,cAAc,gBAAgB,CAAC"}

package/dist/src/BaseProvider.d.ts

@@ -0,0 +1,297 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type IProvider, type GenerateChatOptions, type ProviderToolset } from './IProvider.js';
+import { type IModel } from './IModel.js';
+import { type IContent } from '@vybestack/llxprt-code-core/services/history/IContent.js';
+import { AuthPrecedenceResolver, type OAuthManager } from '@vybestack/llxprt-code-core/auth/precedence.js';
+import type { Config } from '@vybestack/llxprt-code-core/config/config.js';
+import { type IProviderConfig } from './types/IProviderConfig.js';
+import type { ProviderRuntimeContext } from '@vybestack/llxprt-code-core/runtime/providerRuntimeContext.js';
+import type { RuntimeInvocationContext } from '@vybestack/llxprt-code-core/runtime/RuntimeInvocationContext.js';
+import { SettingsService } from '@vybestack/llxprt-code-core/settings/SettingsService.js';
+import type { ProviderTelemetryContext, ResolvedAuthToken, UserMemoryInput } from './types/providerRuntime.js';
+export interface BaseProviderConfig {
+    name: string;
+    apiKey?: string;
+    baseURL?: string;
+    envKeyNames?: string[];
+    isOAuthEnabled?: boolean;
+    oauthProvider?: string;
+    oauthManager?: OAuthManager;
+    supportsOAuth?: boolean;
+}
+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;
+        temperature?: number;
+        maxTokens?: number;
+        streaming?: boolean;
+    };
+}
+/**
+ * Abstract base provider class that implements authentication precedence logic
+ * This class provides lazy OAuth triggering and proper authentication precedence
+ */
+export declare abstract class BaseProvider implements IProvider {
+    readonly name: string;
+    protected authResolver: AuthPrecedenceResolver;
+    protected baseProviderConfig: BaseProviderConfig;
+    protected providerConfig?: IProviderConfig;
+    /**
+     * @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;
+    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-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
+     * 3. Provider config
+     * 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)
+     */
+    protected getAuthToken(): Promise<string>;
+    /**
+     * Get auth token for prompt send - CAN trigger OAuth if needed
+     * Use this method ONLY when actually sending a prompt to the API
+     */
+    protected getAuthTokenForPrompt(): Promise<string>;
+    /**
+     * Checks if OAuth is enabled for this provider
+     */
+    protected isOAuthEnabled(): boolean;
+    /**
+     * Abstract method to determine if this provider supports OAuth
+     * Must be implemented by concrete providers
+     */
+    protected abstract supportsOAuth(): boolean;
+    /**
+     * Classify whether a given auth token is an OAuth token.
+     * Default implementation always returns false; providers that support
+     * token-prefix-based OAuth detection (e.g., Anthropic) should override.
+     *
+     * @param _authToken - The resolved auth token string
+     * @returns true if the token should be treated as an OAuth token
+     */
+    protected classifyOAuthToken(_authToken: string): 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>;
+    /**
+     * Clears authentication (used when removing keys/keyfiles)
+     */
+    clearAuth?(): void;
+    /**
+     * Updates OAuth configuration
+     */
+    protected updateOAuthConfig(isEnabled: boolean, provider?: string, manager?: OAuthManager): void;
+    /**
+     * Clears the authentication token cache.
+     * This ensures that after logout, fresh tokens are fetched on the next
+     * authentication attempt without requiring a provider switch.
+     *
+     * @plan PLAN-20251023-STATELESS-HARDENING
+     * @requirement Issue #975 - OAuth logout cache invalidation
+     */
+    clearAuthCache(): void;
+    /**
+     * Checks if the provider is authenticated using any available method
+     */
+    isAuthenticated(): Promise<boolean>;
+    abstract getModels(): Promise<IModel[]>;
+    abstract getDefaultModel(): string;
+    /**
+     * @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;
+    isPaidMode?(): boolean;
+    clearState?(): void;
+    setConfig?(config: unknown): void;
+    getServerTools(): string[];
+    invokeServerTool(toolName: string, _params: unknown, _config?: unknown, _signal?: AbortSignal): Promise<unknown>;
+    getModelParams?(): Record<string, unknown> | undefined;
+    /**
+     * Get setting value from SettingsService
+     */
+    protected getProviderSetting<T>(key: keyof ProviderSettings, fallback?: T): Promise<T | undefined>;
+    /**
+     * Set setting value in SettingsService
+     */
+    protected setProviderSetting<T>(key: keyof ProviderSettings, value: T): Promise<void>;
+    /**
+     * Get API key from SettingsService if available
+     */
+    protected getApiKeyFromSettings(): Promise<string | undefined>;
+    /**
+     * Set API key in SettingsService if available
+     */
+    protected setApiKeyInSettings(apiKey: string): Promise<void>;
+    /**
+     * Get model from SettingsService if available
+     */
+    protected getModelFromSettings(): Promise<string | undefined>;
+    /**
+     * Set model in SettingsService if available
+     */
+    protected setModelInSettings(model: string): Promise<void>;
+    /**
+     * Get base URL from SettingsService if available
+     */
+    protected getBaseUrlFromSettings(): Promise<string | undefined>;
+    /**
+     * Set base URL in SettingsService if available
+     */
+    protected setBaseUrlInSettings(baseUrl?: string): Promise<void>;
+    /**
+     * Get model parameters from SettingsService
+     */
+    protected getModelParamsFromSettings(): Promise<Record<string, unknown> | undefined>;
+    /**
+     * Set model parameters in SettingsService
+     */
+    protected setModelParamsInSettings(params: Record<string, unknown> | undefined): Promise<void>;
+    /**
+     * Get custom headers from provider configuration and ephemeral settings.
+     *
+     * This merges:
+     * - Provider config `customHeaders`
+     * - Ephemeral `custom-headers`
+     * - Ephemeral `user-agent` (mapped into a `User-Agent` header)
+     * - Invocation `customHeaders` (from separated settings)
+     */
+    protected getCustomHeaders(options?: NormalizedGenerateChatOptions): Record<string, string> | undefined;
+}
+export interface ProviderSettings {
+    enabled: boolean;
+    apiKey?: string;
+    baseUrl?: string;
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+    [key: string]: unknown;
+}