@vybestack/llxprt-code 0.4.8 → 0.5.0-nightly.251102.6bb3db7a

package/dist/src/runtime/runtimeContextFactory.js

@@ -0,0 +1,190 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { Config, MultiProviderTokenStore, ProviderManager, SettingsService, clearActiveProviderRuntimeContext, createProviderRuntimeContext, flushRuntimeAuthScope, ProfileManager, SubagentManager, } from '@vybestack/llxprt-code-core';
+import { OAuthManager } from '../auth/oauth-manager.js';
+const DEFAULT_MODEL = 'gemini-1.5-flash';
+const DEFAULT_DEBUG_MODE = false;
+let sharedTokenStore = null;
+let activationBindings = null;
+let runtimeCounter = 0;
+const runtimeScope = new AsyncLocalStorage();
+export function enterRuntimeScope(scope) {
+    runtimeScope.enterWith(scope);
+}
+export function runWithRuntimeScope(scope, callback) {
+    return runtimeScope.run(scope, callback);
+}
+export function getCurrentRuntimeScope() {
+    return runtimeScope.getStore();
+}
+/**
+ * @plan:PLAN-20251018-STATELESSPROVIDER2.P03
+ * @requirement:REQ-SP2-002
+ * @pseudocode multi-runtime-baseline.md lines 6-6
+ * Cache CLI activation bindings (reset/context/infrastructure/link) for deterministic invocation.
+ */
+export function registerIsolatedRuntimeBindings(bindings) {
+    activationBindings = bindings;
+}
+/**
+ * @plan:PLAN-20251018-STATELESSPROVIDER2.P03
+ * @requirement:REQ-SP2-002
+ * @pseudocode multi-runtime-baseline.md lines 2-5
+ * Construct an isolated runtime using shared immutable resources and scoped services.
+ */
+export function createIsolatedRuntimeContext(options = {}) {
+    if (!activationBindings) {
+        throw new Error('Isolated runtime activation bindings must be registered before creating contexts.');
+    }
+    const runtimeId = options.runtimeId ??
+        `cli-isolated-${Date.now().toString(16)}-${(runtimeCounter += 1).toString(16)}`;
+    const workspaceDir = options.workspaceDir ?? process.cwd();
+    const baseMetadata = {
+        source: 'cli-isolated-runtime-factory',
+        ...(options.metadata ?? {}),
+    };
+    const settingsService = options.config?.getSettingsService() ??
+        options.settingsService ??
+        new SettingsService();
+    const model = options.model ?? DEFAULT_MODEL;
+    const debugMode = options.debugMode ?? DEFAULT_DEBUG_MODE;
+    const config = options.config ??
+        new Config({
+            sessionId: runtimeId,
+            targetDir: workspaceDir,
+            debugMode,
+            cwd: workspaceDir,
+            model,
+            settingsService,
+        });
+    const configWithManagers = config;
+    const optionsConfigWithManagers = options.config;
+    const llxprtDir = path.join(os.homedir(), '.llxprt');
+    const resolvedProfileManager = optionsConfigWithManagers?.getProfileManager?.() ??
+        configWithManagers.getProfileManager?.() ??
+        new ProfileManager(path.join(llxprtDir, 'profiles'));
+    const resolvedSubagentManager = optionsConfigWithManagers?.getSubagentManager?.() ??
+        configWithManagers.getSubagentManager?.() ??
+        new SubagentManager(path.join(llxprtDir, 'subagents'), resolvedProfileManager);
+    configWithManagers.setProfileManager?.(resolvedProfileManager);
+    configWithManagers.setSubagentManager?.(resolvedSubagentManager);
+    const resolvedSettingsService = config.getSettingsService() ?? settingsService;
+    const tokenStore = sharedTokenStore ?? (sharedTokenStore = new MultiProviderTokenStore()); // Step 1 (multi-runtime-baseline.md line 2) keeps token storage shared.
+    const oauthManager = options.oauthManager ?? new OAuthManager(tokenStore);
+    const initialRuntimeContext = createProviderRuntimeContext({
+        settingsService: resolvedSettingsService,
+        config,
+        runtimeId,
+        metadata: baseMetadata,
+    });
+    const providerManager = new ProviderManager({
+        runtime: initialRuntimeContext,
+        settingsService: resolvedSettingsService,
+        config,
+    });
+    let currentRuntimeId = runtimeId;
+    let currentMetadata = baseMetadata;
+    let active = false;
+    /**
+     * @plan:PLAN-20251018-STATELESSPROVIDER2.P03
+     * @requirement:REQ-SP2-002
+     * @pseudocode multi-runtime-baseline.md lines 7-7
+     * Execute the activation flow in the reset → context → infrastructure → link order per Step 6.
+     */
+    const activate = async (activationOptions) => {
+        if (!activationBindings) {
+            throw new Error('Isolated runtime activation bindings must be registered before activation.');
+        }
+        const bindings = activationBindings;
+        currentRuntimeId = activationOptions?.runtimeId ?? runtimeId;
+        currentMetadata = {
+            ...baseMetadata,
+            ...(activationOptions?.metadata ?? {}),
+        };
+        const scope = {
+            runtimeId: currentRuntimeId,
+            metadata: currentMetadata,
+        };
+        enterRuntimeScope(scope);
+        await runWithRuntimeScope(scope, async () => {
+            const scopedRuntime = createProviderRuntimeContext({
+                settingsService: resolvedSettingsService,
+                config,
+                runtimeId: currentRuntimeId,
+                metadata: currentMetadata,
+            });
+            providerManager.runtime = scopedRuntime;
+            await Promise.resolve(bindings.resetInfrastructure());
+            await Promise.resolve(bindings.setRuntimeContext(resolvedSettingsService, config, {
+                runtimeId: currentRuntimeId,
+                metadata: currentMetadata,
+            }));
+            if (options.prepare) {
+                await options.prepare({
+                    config,
+                    settingsService: resolvedSettingsService,
+                    providerManager,
+                    oauthManager,
+                    runtimeId: currentRuntimeId,
+                    metadata: currentMetadata,
+                });
+            }
+            await Promise.resolve(bindings.registerInfrastructure(providerManager, oauthManager));
+            await Promise.resolve(bindings.linkProviderManager(config, providerManager));
+            active = true;
+        });
+    };
+    /**
+     * @plan:PLAN-20251018-STATELESSPROVIDER2.P03
+     * @requirement:REQ-SP2-002
+     * @pseudocode multi-runtime-baseline.md lines 8-8
+     * Clear activation state and invoke onCleanup hooks in the reverse order detailed in Step 7.
+     */
+    const cleanup = async () => {
+        if (!active && !options.onCleanup) {
+            return;
+        }
+        const scope = {
+            runtimeId: currentRuntimeId,
+            metadata: currentMetadata,
+        };
+        const bindings = activationBindings;
+        await runWithRuntimeScope(scope, async () => {
+            if (bindings) {
+                await Promise.resolve(bindings.resetInfrastructure());
+            }
+            clearActiveProviderRuntimeContext();
+            const revocation = flushRuntimeAuthScope(currentRuntimeId);
+            if (options.onCleanup) {
+                await options.onCleanup({
+                    config,
+                    settingsService: resolvedSettingsService,
+                    providerManager,
+                    runtimeId: currentRuntimeId,
+                    metadata: currentMetadata,
+                });
+            }
+            if (bindings?.disposeRuntime) {
+                await Promise.resolve(bindings.disposeRuntime(currentRuntimeId, revocation));
+            }
+        });
+        active = false;
+    };
+    return {
+        runtimeId,
+        metadata: baseMetadata,
+        settingsService: resolvedSettingsService,
+        config,
+        providerManager,
+        oauthManager,
+        activate,
+        cleanup,
+    };
+}
+//# sourceMappingURL=runtimeContextFactory.js.map

package/dist/src/runtime/runtimeContextFactory.js.map

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

package/dist/src/runtime/runtimeSettings.d.ts

@@ -0,0 +1,217 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Config, ProviderRuntimeContext, SettingsService, AuthType } from '@vybestack/llxprt-code-core';
+import type { ProviderManager, Profile, IModel } from '@vybestack/llxprt-code-core';
+import { OAuthManager } from '../auth/oauth-manager.js';
+import type { HistoryItemWithoutId } from '../ui/types.js';
+import type { LoadedSettings } from '../config/settings.js';
+import { createIsolatedRuntimeContext as createIsolatedRuntimeContextInternal, type IsolatedRuntimeActivationOptions, type IsolatedRuntimeContextHandle } from './runtimeContextFactory.js';
+export { createIsolatedRuntimeContextInternal as createIsolatedRuntimeContext };
+export type { IsolatedRuntimeActivationOptions, IsolatedRuntimeContextHandle, IsolatedRuntimeContextOptions, } from './runtimeContextFactory.js';
+export type StatelessHardeningPreference = 'legacy' | 'strict';
+/**
+ * @plan:PLAN-20251023-STATELESS-HARDENING.P07
+ * @requirement:REQ-SP4-005
+ * Configure the global CLI stateless guard preference. Tests and CLI bootstrap
+ * can call this to opt into strict guards without environment toggles.
+ */
+export declare function configureCliStatelessHardening(preference: StatelessHardeningPreference | null): void;
+/**
+ * @plan:PLAN-20251023-STATELESS-HARDENING.P07
+ * @requirement:REQ-SP4-005
+ */
+export declare function getCliStatelessHardeningOverride(): StatelessHardeningPreference | null;
+/**
+ * @plan:PLAN-20251023-STATELESS-HARDENING.P07
+ * @requirement:REQ-SP4-005
+ * Reports the currently resolved stateless hardening preference.
+ */
+export declare function getCliStatelessHardeningPreference(): StatelessHardeningPreference;
+export declare function isCliStatelessProviderModeEnabled(): boolean;
+export interface CliRuntimeServices {
+    settingsService: SettingsService;
+    config: Config;
+    providerManager: ProviderManager;
+}
+/**
+ * @plan:PLAN-20251023-STATELESS-HARDENING.P08
+ * @requirement:REQ-SP4-004
+ * @requirement:REQ-SP4-005
+ *
+ * Acquire the active provider runtime context that CLI bootstrap registered.
+ * Throws if the runtime has not yet been initialised.
+ *
+ * When stateless hardening is enabled, this enforces that all required
+ * services (settingsService, config) are present in the runtime registry
+ * before allowing provider operations.
+ */
+export declare function getCliRuntimeContext(): ProviderRuntimeContext;
+/**
+ * Obtain the services that CLI surfaces through the runtime context.
+ */
+export declare function getCliRuntimeServices(): CliRuntimeServices;
+export declare function getCliProviderManager(options?: {
+    allowBrowserEnvironment?: boolean;
+    settings?: LoadedSettings;
+    addItem?: (itemData: Omit<HistoryItemWithoutId, 'id'>, baseTimestamp: number) => number;
+}): ProviderManager;
+export declare function isCliRuntimeStatelessReady(): boolean;
+/**
+ * @plan:PLAN-20251023-STATELESS-HARDENING.P08
+ * @requirement:REQ-SP4-004
+ * @requirement:REQ-SP4-005
+ *
+ * Ensure the active provider runtime context is normalized and pushed into
+ * ProviderManager before any provider invocation. This function enforces
+ * stateless provider guarantees by requiring explicit runtime-scoped services
+ * (settings, config, userMemory) before execution.
+ *
+ * When stateless hardening is enabled (runtime metadata/global preference),
+ * this helper normalizes the current runtime context and registers it with
+ * ProviderManager so downstream providers always receive call-scoped
+ * configuration without relying on singleton fallbacks.
+ */
+export declare function ensureStatelessProviderReady(): void;
+/**
+ * @plan:PLAN-20251018-STATELESSPROVIDER2.P03
+ * @requirement:REQ-SP2-002
+ * @pseudocode multi-runtime-baseline.md lines 7-7
+ * Delegate helper that activates an isolated runtime while merging metadata overrides per Step 6.
+ */
+export declare function activateIsolatedRuntimeContext(handle: IsolatedRuntimeContextHandle, options?: IsolatedRuntimeActivationOptions): Promise<void>;
+export declare function registerCliProviderInfrastructure(manager: ProviderManager, oauthManager: OAuthManager): void;
+export declare function resetCliProviderInfrastructure(runtimeId?: string): void;
+export declare function getCliOAuthManager(): OAuthManager | null;
+/**
+ * Accessor for the active CLI Config instance registered with the runtime
+ * context. Throws if the bootstrap failed to attach the Config.
+ */
+export declare function getCliRuntimeConfig(): Config;
+export declare function getActiveModelName(): string;
+export declare function getActiveProviderStatus(): ProviderRuntimeStatus;
+export declare function listAvailableModels(providerName?: string): Promise<IModel[]>;
+export declare function getActiveProviderMetrics(): ReturnType<ProviderManager['getProviderMetrics']>;
+export declare function getSessionTokenUsage(): {
+    input: number;
+    output: number;
+    cache: number;
+    tool: number;
+    thought: number;
+    total: number;
+};
+export declare function getEphemeralSettings(): Record<string, unknown>;
+export declare function getEphemeralSetting(key: string): unknown;
+export declare function setEphemeralSetting(key: string, value: unknown): void;
+export declare function clearEphemeralSetting(key: string): void;
+export declare function getActiveModelParams(): Record<string, unknown>;
+export declare function setActiveModelParam(name: string, value: unknown): void;
+export declare function clearActiveModelParam(name: string): void;
+export declare function buildRuntimeProfileSnapshot(): Profile;
+export interface ProfileLoadOptions {
+    profileName?: string;
+}
+export interface ProfileLoadResult {
+    profileName?: string;
+    providerName: string;
+    modelName: string;
+    infoMessages: string[];
+    warnings: string[];
+    providerChanged: boolean;
+    authType?: AuthType;
+    baseUrl?: string;
+    didFallback: boolean;
+    requestedProvider: string | null;
+}
+export interface RuntimeDiagnosticsSnapshot {
+    providerName: string | null;
+    modelName: string | null;
+    profileName: string | null;
+    modelParams: Record<string, unknown>;
+    ephemeralSettings: Record<string, unknown>;
+}
+export declare function applyProfileSnapshot(profile: Profile, options?: ProfileLoadOptions): Promise<ProfileLoadResult>;
+export declare function saveProfileSnapshot(profileName: string): Promise<Profile>;
+export declare function loadProfileByName(profileName: string): Promise<ProfileLoadResult>;
+export declare function deleteProfileByName(profileName: string): Promise<void>;
+export declare function listSavedProfiles(): Promise<string[]>;
+export declare function getActiveProfileName(): string | null;
+export declare function setDefaultProfileName(profileName: string | null): void;
+export declare function getRuntimeDiagnosticsSnapshot(): RuntimeDiagnosticsSnapshot;
+export declare function listProviders(): string[];
+export declare function getActiveProviderName(): string;
+/**
+ * Register or update the active CLI runtime context.
+ */
+export declare function setCliRuntimeContext(settingsService: SettingsService, config?: Config, options?: {
+    metadata?: ProviderRuntimeContext['metadata'];
+    runtimeId?: string;
+}): void;
+export interface ProviderSwitchResult {
+    changed: boolean;
+    previousProvider: string | null;
+    nextProvider: string;
+    defaultModel?: string;
+    authType?: AuthType;
+    infoMessages: string[];
+}
+export interface ApiKeyUpdateResult {
+    changed: boolean;
+    providerName: string;
+    message: string;
+    isPaidMode?: boolean;
+    authType?: AuthType;
+}
+export interface BaseUrlUpdateResult {
+    changed: boolean;
+    providerName: string;
+    message: string;
+    baseUrl?: string;
+}
+export interface ToolFormatState {
+    providerName: string;
+    currentFormat: string | null;
+    override: string | null;
+    isAutoDetected: boolean;
+}
+export type ToolFormatOverrideLiteral = 'auto' | 'openai' | 'qwen' | 'hermes' | 'xml' | 'anthropic' | 'deepseek' | 'gemma' | 'llama';
+export interface ProviderRuntimeStatus {
+    providerName: string | null;
+    modelName: string | null;
+    displayLabel: string;
+    isPaidMode?: boolean;
+    authType?: AuthType;
+    baseURL?: string;
+}
+/**
+ * Switch the active provider using the runtime context, updating Config and
+ * SettingsService consistently.
+ *
+ * @plan:PLAN-20250218-STATELESSPROVIDER.P06
+ * @requirement:REQ-SP-005
+ * @pseudocode:cli-runtime.md lines 9-10
+ */
+export declare function switchActiveProvider(providerName: string, options?: {
+    autoOAuth?: boolean;
+}): Promise<ProviderSwitchResult>;
+export interface ModelChangeResult {
+    providerName: string;
+    previousModel?: string;
+    nextModel: string;
+    authRefreshed: boolean;
+}
+export declare function updateActiveProviderApiKey(apiKey: string | null): Promise<ApiKeyUpdateResult>;
+export declare function updateActiveProviderBaseUrl(baseUrl: string | null): Promise<BaseUrlUpdateResult>;
+export declare function getActiveToolFormatState(): Promise<ToolFormatState>;
+export declare function setActiveToolFormatOverride(formatName: ToolFormatOverrideLiteral | null): Promise<ToolFormatState>;
+/**
+ * Update the active model for the current provider while keeping Config and
+ * SettingsService in sync.
+ *
+ * @plan:PLAN-20250218-STATELESSPROVIDER.P06
+ * @requirement:REQ-SP-005
+ * @pseudocode:cli-runtime.md line 10
+ */
+export declare function setActiveModel(modelName: string): Promise<ModelChangeResult>;