byterover-cli 0.3.4 → 0.4.0

package/dist/commands/push.js

@@ -1,160 +0,0 @@
-import { confirm } from '@inquirer/prompts';
-import { Command, Flags, ux } from '@oclif/core';
-import { getCurrentConfig } from '../config/environment.js';
-import { DEFAULT_BRANCH } from '../constants.js';
-import { ExitCode, ExitError, exitWithCode } from '../infra/cipher/exit-codes.js';
-import { WorkspaceNotInitializedError } from '../infra/cipher/validation/workspace-validator.js';
-import { mapToPushContexts } from '../infra/cogit/context-tree-to-push-context-mapper.js';
-import { HttpCogitPushService } from '../infra/cogit/http-cogit-push-service.js';
-import { ProjectConfigStore } from '../infra/config/file-config-store.js';
-import { FileContextFileReader } from '../infra/context-tree/file-context-file-reader.js';
-import { FileContextTreeSnapshotService } from '../infra/context-tree/file-context-tree-snapshot-service.js';
-import { KeychainTokenStore } from '../infra/storage/keychain-token-store.js';
-import { MixpanelTrackingService } from '../infra/tracking/mixpanel-tracking-service.js';
-export default class Push extends Command {
-    static description = 'Push context tree to ByteRover memory storage';
-    static examples = [
-        '<%= config.bin %> <%= command.id %>',
-        '<%= config.bin %> <%= command.id %> --branch develop',
-        '<%= config.bin %> <%= command.id %> -b feature-auth',
-    ];
-    static flags = {
-        branch: Flags.string({
-            // Can pass either --branch or -b
-            char: 'b',
-            default: DEFAULT_BRANCH,
-            description: 'ByteRover branch name (not Git branch)',
-        }),
-        yes: Flags.boolean({
-            char: 'y',
-            default: false,
-            description: 'Skip confirmation prompt',
-        }),
-    };
-    buildSpaceUrl(webAppUrl, teamName, spaceName) {
-        return `${webAppUrl}/${teamName}/${spaceName}`;
-    }
-    // Override catch to prevent oclif from logging errors that were already displayed
-    async catch(error) {
-        // Check if error is ExitError (message already displayed by exitWithCode)
-        if (error instanceof ExitError) {
-            return;
-        }
-        // Backwards compatibility: also check oclif.exit property
-        if (error.oclif?.exit !== undefined) {
-            // Error already displayed by exitWithCode, silently exit
-            return;
-        }
-        // For other errors, re-throw to let oclif handle them
-        throw error;
-    }
-    async checkProjectInit(projectConfigStore) {
-        const projectConfig = await projectConfigStore.read();
-        if (projectConfig === undefined) {
-            throw new WorkspaceNotInitializedError('Project not initialized. Please run "brv init" to select your team and workspace.', '.brv');
-        }
-        return projectConfig;
-    }
-    async confirmPush(projectConfig, branch) {
-        this.log('\nYou are about to push to ByteRover memory storage:');
-        this.log(`  Space: ${projectConfig.spaceName}`);
-        this.log(`  Branch: ${branch}`);
-        return confirm({
-            default: false,
-            message: 'Push to ByteRover?',
-        });
-    }
-    createServices() {
-        const envConfig = getCurrentConfig();
-        const tokenStore = new KeychainTokenStore();
-        const trackingService = new MixpanelTrackingService(tokenStore);
-        return {
-            cogitPushService: new HttpCogitPushService({
-                apiBaseUrl: envConfig.cogitApiBaseUrl,
-            }),
-            contextFileReader: new FileContextFileReader(),
-            contextTreeSnapshotService: new FileContextTreeSnapshotService(),
-            projectConfigStore: new ProjectConfigStore(),
-            tokenStore,
-            trackingService,
-        };
-    }
-    async run() {
-        const { flags } = await this.parse(Push);
-        try {
-            const { cogitPushService, contextFileReader, contextTreeSnapshotService, projectConfigStore, tokenStore, trackingService, } = this.createServices();
-            await trackingService.track('mem:push');
-            const token = await this.validateAuth(tokenStore);
-            const projectConfig = await this.checkProjectInit(projectConfigStore);
-            // Check for changes
-            ux.action.start('Checking for Context Tree changes');
-            const contextTreeChanges = await contextTreeSnapshotService.getChanges();
-            ux.action.stop();
-            if (contextTreeChanges.added.length === 0 &&
-                contextTreeChanges.modified.length === 0 &&
-                contextTreeChanges.deleted.length === 0) {
-                this.log('No context changes to push.');
-                return;
-            }
-            // Prompt for confirmation unless --yes flag is provided
-            if (!flags.yes) {
-                const confirmed = await this.confirmPush(projectConfig, flags.branch);
-                if (!confirmed) {
-                    this.log('Push cancelled.');
-                    return;
-                }
-            }
-            // Read and prepare files
-            ux.action.start('Reading context files');
-            const [addedFiles, modifiedFiles] = await Promise.all([
-                contextFileReader.readMany(contextTreeChanges.added),
-                contextFileReader.readMany(contextTreeChanges.modified),
-            ]);
-            ux.action.stop();
-            const pushContexts = mapToPushContexts({
-                addedFiles,
-                deletedPaths: contextTreeChanges.deleted,
-                modifiedFiles,
-            });
-            if (pushContexts.length === 0) {
-                this.log('\nNo valid context files to push.');
-                return;
-            }
-            // Push to CoGit (with two-request SHA flow)
-            this.log('Pushing to ByteRover...');
-            await cogitPushService.push({
-                accessToken: token.accessToken,
-                branch: flags.branch,
-                contexts: pushContexts,
-                sessionKey: token.sessionKey,
-                spaceId: projectConfig.spaceId,
-                teamId: projectConfig.teamId,
-            });
-            // Update snapshot ONLY after successful push
-            await contextTreeSnapshotService.saveSnapshot();
-            // Success message
-            this.log('\n✓ Successfully pushed context tree to ByteRover memory storage!');
-            this.log(`  Branch: ${flags.branch}`);
-            this.log(`  Added: ${addedFiles.length}, Edited: ${modifiedFiles.length}, Deleted: ${contextTreeChanges.deleted.length}`);
-            this.log(`  View: ${this.buildSpaceUrl(getCurrentConfig().webAppUrl, projectConfig.teamName, projectConfig.spaceName)}`);
-        }
-        catch (error) {
-            if (error instanceof WorkspaceNotInitializedError) {
-                exitWithCode(ExitCode.VALIDATION_ERROR, 'Project not initialized. Please run "brv init" to select your team and workspace.');
-            }
-            // For other errors, use exitWithCode to properly display error before exit
-            const message = error instanceof Error ? error.message : 'Push failed';
-            exitWithCode(ExitCode.RUNTIME_ERROR, `Failed to push: ${message}`);
-        }
-    }
-    async validateAuth(tokenStore) {
-        const token = await tokenStore.load();
-        if (token === undefined) {
-            this.error('Not authenticated. Run "brv login" first.');
-        }
-        if (!token.isValid()) {
-            this.error('Authentication token expired. Run "brv login" again.');
-        }
-        return token;
-    }
-}

package/dist/commands/space/list.d.ts

@@ -1,25 +0,0 @@
-import { Command } from '@oclif/core';
-import type { IProjectConfigStore } from '../../core/interfaces/i-project-config-store.js';
-import type { ISpaceService } from '../../core/interfaces/i-space-service.js';
-import type { ITokenStore } from '../../core/interfaces/i-token-store.js';
-export default class SpaceList extends Command {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
-        offset: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
-    };
-    catch(error: Error & {
-        oclif?: {
-            exit: number;
-        };
-    }): Promise<void>;
-    protected createServices(): {
-        projectConfigStore: IProjectConfigStore;
-        spaceService: ISpaceService;
-        tokenStore: ITokenStore;
-    };
-    run(): Promise<void>;
-}

package/dist/commands/space/list.js

@@ -1,114 +0,0 @@
-import { Command, Flags, ux } from '@oclif/core';
-import { getCurrentConfig } from '../../config/environment.js';
-import { ExitCode, ExitError, exitWithCode } from '../../infra/cipher/exit-codes.js';
-import { ProjectConfigStore } from '../../infra/config/file-config-store.js';
-import { HttpSpaceService } from '../../infra/space/http-space-service.js';
-import { KeychainTokenStore } from '../../infra/storage/keychain-token-store.js';
-const DEFAULT_LIMIT = 50;
-const DEFAULT_OFFSET = 0;
-export default class SpaceList extends Command {
-    static description = 'List all spaces for the current team (requires project initialization)';
-    static examples = [
-        '<%= config.bin %> <%= command.id %>',
-        '<%= config.bin %> <%= command.id %> --all',
-        '<%= config.bin %> <%= command.id %> --limit 10',
-        '<%= config.bin %> <%= command.id %> --limit 10 --offset 20',
-        '<%= config.bin %> <%= command.id %> --json',
-    ];
-    static flags = {
-        all: Flags.boolean({
-            char: 'a',
-            default: false,
-            description: 'Fetch all spaces (may be slow for large teams)',
-        }),
-        json: Flags.boolean({
-            char: 'j',
-            default: false,
-            description: 'Output in JSON format',
-        }),
-        limit: Flags.integer({
-            char: 'l',
-            default: DEFAULT_LIMIT,
-            description: 'Maximum number of spaces to fetch',
-        }),
-        offset: Flags.integer({
-            char: 'o',
-            default: DEFAULT_OFFSET,
-            description: 'Number of spaces to skip',
-        }),
-    };
-    async catch(error) {
-        // Check if error is ExitError (message already displayed)
-        if (error instanceof ExitError) {
-            return;
-        }
-        // Backwards compatibility: also check oclif.exit property
-        if (error.oclif?.exit !== undefined) {
-            return;
-        }
-        // For unexpected errors, show the message
-        this.error(error instanceof Error ? error.message : 'Failed to list spaces');
-    }
-    createServices() {
-        const envConfig = getCurrentConfig();
-        return {
-            projectConfigStore: new ProjectConfigStore(),
-            spaceService: new HttpSpaceService({ apiBaseUrl: envConfig.apiBaseUrl }),
-            tokenStore: new KeychainTokenStore(),
-        };
-    }
-    async run() {
-        const { flags } = await this.parse(SpaceList);
-        const { projectConfigStore, spaceService, tokenStore } = this.createServices();
-        // Check project initialization
-        const projectConfig = await projectConfigStore.read();
-        if (!projectConfig) {
-            exitWithCode(ExitCode.VALIDATION_ERROR, 'Project not initialized. Please run "brv init" first.');
-        }
-        const token = await tokenStore.load();
-        if (!token) {
-            exitWithCode(ExitCode.VALIDATION_ERROR, 'Not authenticated. Please run "brv login" first.');
-        }
-        if (!token.isValid()) {
-            exitWithCode(ExitCode.VALIDATION_ERROR, 'Authentication token expired. Please run "brv login" again.');
-        }
-        // Fetch spaces for the team from project config
-        ux.action.start(`Fetching spaces for ${projectConfig.teamName}`);
-        let result;
-        try {
-            result = await spaceService.getSpaces(token.accessToken, token.sessionKey, projectConfig.teamId, flags.all ? { fetchAll: true } : { limit: flags.limit, offset: flags.offset });
-        }
-        finally {
-            ux.action.stop();
-        }
-        // Handle empty results
-        if (result.spaces.length === 0) {
-            this.log(`No spaces found in team "${projectConfig.teamName}".`);
-            return;
-        }
-        // Display results based on format
-        if (flags.json) {
-            this.log(JSON.stringify({
-                showing: result.spaces.length,
-                spaces: result.spaces.map((s) => s.toJson()),
-                team: { id: projectConfig.teamId, name: projectConfig.teamName },
-                total: result.total,
-            }, null, 2));
-            return;
-        }
-        // Human-readable format
-        this.log(`\nSpaces in team "${projectConfig.teamName}":\n`);
-        this.log(`Found ${result.spaces.length} space(s):\n`);
-        for (const [index, space] of result.spaces.entries()) {
-            this.log(`  ${index + 1}. ${space.getDisplayName()}`);
-        }
-        // Pagination warning
-        if (!flags.all && result.spaces.length < result.total) {
-            const remaining = result.total - result.spaces.length - flags.offset;
-            this.log(`\nShowing ${result.spaces.length} of ${result.total} spaces.`);
-            if (remaining > 0) {
-                this.log('Use --all to fetch all spaces, or use --limit and --offset for pagination.');
-            }
-        }
-    }
-}

package/dist/commands/space/switch.d.ts

@@ -1,36 +0,0 @@
-import { Command } from '@oclif/core';
-import type { Space } from '../../core/domain/entities/space.js';
-import type { Team } from '../../core/domain/entities/team.js';
-import type { IProjectConfigStore } from '../../core/interfaces/i-project-config-store.js';
-import type { ISpaceService } from '../../core/interfaces/i-space-service.js';
-import type { ITeamService } from '../../core/interfaces/i-team-service.js';
-import type { ITokenStore } from '../../core/interfaces/i-token-store.js';
-import { Agent } from '../../core/domain/entities/agent.js';
-export default class SpaceSwitch extends Command {
-    static description: string;
-    static examples: string[];
-    catch(error: Error & {
-        oclif?: {
-            exit: number;
-        };
-    }): Promise<void>;
-    protected createServices(): {
-        projectConfigStore: IProjectConfigStore;
-        spaceService: ISpaceService;
-        teamService: ITeamService;
-        tokenStore: ITokenStore;
-    };
-    protected detectWorkspacesForAgent(agent: Agent): {
-        chatLogPath: string;
-        cwd: string;
-    };
-    /**
-     * Prompts the user to select an agent.
-     * This method is protected to allow test overrides.
-     * @returns The selected agent
-     */
-    protected promptForAgentSelection(): Promise<Agent>;
-    protected promptForSpaceSelection(spaces: Space[]): Promise<Space>;
-    protected promptForTeamSelection(teams: Team[]): Promise<Team>;
-    run(): Promise<void>;
-}

package/dist/commands/space/switch.js

@@ -1,160 +0,0 @@
-import { search, select } from '@inquirer/prompts';
-import { Command, ux } from '@oclif/core';
-import { getCurrentConfig } from '../../config/environment.js';
-import { BRV_DIR, PROJECT_CONFIG_FILE } from '../../constants.js';
-import { AGENT_VALUES } from '../../core/domain/entities/agent.js';
-import { BrvConfig } from '../../core/domain/entities/brv-config.js';
-import { ExitCode, ExitError, exitWithCode } from '../../infra/cipher/exit-codes.js';
-import { ProjectConfigStore } from '../../infra/config/file-config-store.js';
-import { HttpSpaceService } from '../../infra/space/http-space-service.js';
-import { KeychainTokenStore } from '../../infra/storage/keychain-token-store.js';
-import { HttpTeamService } from '../../infra/team/http-team-service.js';
-import { WorkspaceDetectorService } from '../../infra/workspace/workspace-detector-service.js';
-export default class SpaceSwitch extends Command {
-    static description = `Switch to a different team or space (updates ${BRV_DIR}/${PROJECT_CONFIG_FILE})`;
-    static examples = [
-        '<%= config.bin %> <%= command.id %>',
-        '# Shows current configuration, then prompts for new team/space selection',
-    ];
-    async catch(error) {
-        // Check if error is ExitError (message already displayed)
-        if (error instanceof ExitError) {
-            return;
-        }
-        // Backwards compatibility: also check oclif.exit property
-        if (error.oclif?.exit !== undefined) {
-            return;
-        }
-        // For unexpected errors, show the message
-        this.error(error instanceof Error ? error.message : 'Switch failed');
-    }
-    createServices() {
-        const envConfig = getCurrentConfig();
-        return {
-            projectConfigStore: new ProjectConfigStore(),
-            spaceService: new HttpSpaceService({
-                apiBaseUrl: envConfig.apiBaseUrl,
-            }),
-            teamService: new HttpTeamService({
-                apiBaseUrl: envConfig.apiBaseUrl,
-            }),
-            tokenStore: new KeychainTokenStore(),
-        };
-    }
-    detectWorkspacesForAgent(agent) {
-        const detector = new WorkspaceDetectorService();
-        const result = detector.detectWorkspaces(agent);
-        return {
-            chatLogPath: result.chatLogPath,
-            cwd: result.cwd,
-        };
-    }
-    /**
-     * Prompts the user to select an agent.
-     * This method is protected to allow test overrides.
-     * @returns The selected agent
-     */
-    async promptForAgentSelection() {
-        const AGENTS = AGENT_VALUES.map((agent) => ({
-            name: agent,
-            value: agent,
-        }));
-        const answer = await search({
-            message: 'Which agent you are using (type to search):',
-            async source(input) {
-                if (!input)
-                    return AGENTS;
-                return AGENTS.filter((agent) => agent.name.toLowerCase().includes(input.toLowerCase()) ||
-                    agent.value.toLowerCase().includes(input.toLowerCase()));
-            },
-        });
-        return answer;
-    }
-    async promptForSpaceSelection(spaces) {
-        const selectedSpaceId = await select({
-            choices: spaces.map((space) => ({
-                name: space.getDisplayName(),
-                value: space.id,
-            })),
-            message: 'Select a space',
-        });
-        const selectedSpace = spaces.find((space) => space.id === selectedSpaceId);
-        if (!selectedSpace) {
-            exitWithCode(ExitCode.VALIDATION_ERROR, 'Space selection failed');
-        }
-        return selectedSpace;
-    }
-    async promptForTeamSelection(teams) {
-        const selectedTeamId = await select({
-            choices: teams.map((team) => ({
-                name: team.name,
-                value: team.id,
-            })),
-            message: 'Select a team',
-        });
-        const selectedTeam = teams.find((team) => team.id === selectedTeamId);
-        if (!selectedTeam) {
-            exitWithCode(ExitCode.VALIDATION_ERROR, 'Team selection failed');
-        }
-        return selectedTeam;
-    }
-    async run() {
-        const { projectConfigStore, spaceService, teamService, tokenStore } = this.createServices();
-        // Check project initialization (MUST exist for switch)
-        const currentConfig = await projectConfigStore.read();
-        if (!currentConfig) {
-            exitWithCode(ExitCode.VALIDATION_ERROR, 'Project not initialized. Please run "brv init" first.');
-        }
-        // Show current configuration
-        this.log('Current configuration:');
-        this.log(`  Team: ${currentConfig.teamName}`);
-        this.log(`  Space: ${currentConfig.spaceName}`);
-        this.log();
-        // Validate authentication
-        const token = await tokenStore.load();
-        if (!token) {
-            exitWithCode(ExitCode.VALIDATION_ERROR, 'Not authenticated. Please run "brv login" first.');
-        }
-        if (!token.isValid()) {
-            exitWithCode(ExitCode.VALIDATION_ERROR, 'Authentication token expired. Please run "brv login" again.');
-        }
-        // Fetch all teams
-        ux.action.start('Fetching all teams');
-        const teamResult = await teamService.getTeams(token.accessToken, token.sessionKey, { fetchAll: true });
-        ux.action.stop();
-        if (teamResult.teams.length === 0) {
-            exitWithCode(ExitCode.VALIDATION_ERROR, 'No teams found. Please create a team in the ByteRover dashboard first.');
-        }
-        // Prompt for team selection
-        this.log();
-        const selectedTeam = await this.promptForTeamSelection(teamResult.teams);
-        // Fetch spaces for selected team
-        ux.action.start('Fetching all spaces');
-        const spaceResult = await spaceService.getSpaces(token.accessToken, token.sessionKey, selectedTeam.id, {
-            fetchAll: true,
-        });
-        ux.action.stop();
-        if (spaceResult.spaces.length === 0) {
-            exitWithCode(ExitCode.VALIDATION_ERROR, `No spaces found in team "${selectedTeam.getDisplayName()}". Please create a space in the ByteRover dashboard first.`);
-        }
-        // Prompt for space selection
-        this.log();
-        const selectedSpace = await this.promptForSpaceSelection(spaceResult.spaces);
-        // Prompt for agent selection
-        this.log();
-        const selectedAgent = await this.promptForAgentSelection();
-        this.log();
-        const { chatLogPath, cwd } = this.detectWorkspacesForAgent(selectedAgent);
-        // Update configuration
-        const newConfig = BrvConfig.fromSpace({
-            chatLogPath,
-            cwd,
-            ide: selectedAgent,
-            space: selectedSpace,
-        });
-        await projectConfigStore.write(newConfig);
-        // Display success
-        this.log(`\n✓ Successfully switched to space: ${selectedSpace.getDisplayName()}`);
-        this.log(`✓ Configuration updated in: ${BRV_DIR}/${PROJECT_CONFIG_FILE}`);
-    }
-}

package/dist/infra/cipher/grpc/internal-llm-grpc-service.d.ts

@@ -1,149 +0,0 @@
-import type { RequestOptions } from '@anthropic-ai/sdk/internal/request-options';
-import type { MessageCreateParamsNonStreaming } from '@anthropic-ai/sdk/resources/messages.js';
-import type { Content, GenerateContentConfig, GenerateContentResponse } from '@google/genai';
-/**
- * ByteRover gRPC LLM provider configuration.
- */
-export interface ByteRoverGrpcConfig {
-    accessToken: string;
-    grpcEndpoint: string;
-    projectId?: string;
-    region?: string;
-    sessionKey: string;
-    spaceId: string;
-    teamId: string;
-    timeout?: number;
-}
-/**
- * ByteRover gRPC LLM API client.
- *
- * Simple wrapper around ByteRover gRPC LLM service.
- * Delegates prompt building and formatting to service layer.
- *
- * Responsibilities:
- * - Call the remote gRPC service
- * - Stream and collect responses
- * - Convert to GenerateContentResponse format
- *
- * Does NOT:
- * - Build prompts or format inputs
- * - Parse or manipulate response content
- * - Handle tool call parsing from text
- */
-export declare class ByteRoverLlmGrpcService {
-    private client;
-    private readonly config;
-    private credentials;
-    /**
-     * Initialize a new ByteRover gRPC LLM service client.
-     *
-     * Sets up configuration with sensible defaults:
-     * - projectId defaults to 'byterover'
-     * - region defaults to 'us-east1' (can be overridden per request)
-     * - timeout defaults to 30 seconds
-     *
-     * Determines whether to use secure (TLS) or insecure connections based on
-     * the endpoint hostname. The actual gRPC client is lazily initialized on first use.
-     *
-     * @param config - gRPC client configuration (accessToken, grpcEndpoint, sessionKey, optional: projectId, region, timeout)
-     */
-    constructor(config: ByteRoverGrpcConfig);
-    /**
-     * Close the gRPC connection and cleanup resources.
-     *
-     * Safely closes the underlying gRPC client connection if it exists.
-     * Can be called multiple times without error.
-     */
-    close(): void;
-    /**
-     * Call ByteRover gRPC LLM service to generate content.
-     *
-     * Simple forward to remote gRPC service - delegates all formatting to backend.
-     * Supports both Gemini and Claude formats - the correct format is determined
-     * automatically based on the model name.
-     *
-     * Parameter structure differs by provider:
-     * - Gemini: contents = Content[], config = GenerateContentConfig
-     * - Claude: contents = MessageCreateParamsNonStreaming (complete body), config = RequestOptions (HTTP options)
-     *
-     * @param contents - For Gemini: Content[]. For Claude: MessageCreateParamsNonStreaming (complete body)
-     * @param config - For Gemini: GenerateContentConfig. For Claude: RequestOptions (optional HTTP options)
-     * @param model - Model to use (detects provider from model name)
-     * @param executionMetadata - Optional execution metadata (mode, executionContext)
-     * @returns Response in GenerateContentResponse format
-     */
-    generateContent(contents: Content[] | MessageCreateParamsNonStreaming, config: GenerateContentConfig | RequestOptions, model: string, executionMetadata?: Record<string, unknown>): Promise<GenerateContentResponse>;
-    /**
-     * Call the ByteRover gRPC Generate endpoint and collect streaming response.
-     *
-     * Handles authentication headers, streaming response collection, timeouts,
-     * and error handling. Uses a timeout mechanism to prevent hanging when the
-     * server closes the connection without proper cleanup.
-     *
-     * @param request - The gRPC generate request with model, provider, region, and params
-     * @returns Promise resolving to the complete LLM response
-     * @throws Error if client is not initialized, timeout occurs, or stream error happens
-     */
-    private callGrpcGenerate;
-    /**
-     * Check if error message contains any of the given keywords
-     */
-    private containsAny;
-    /**
-     * Detect LLM provider from model identifier.
-     *
-     * Determines which provider (Claude or Gemini) to use based on the model name.
-     * Defaults to Gemini if the model doesn't match Claude patterns.
-     *
-     * @param model - Model identifier (e.g., 'claude-3-5-sonnet', 'gemini-2.5-flash')
-     * @returns Provider name: 'claude' or 'gemini'
-     */
-    private detectProviderFromModel;
-    /**
-     * Detect appropriate GCP region from model identifier.
-     *
-     * Routes Claude models to us-east5 and Gemini models to us-east1.
-     * This ensures compatibility with the provider's available regions on Vertex AI.
-     *
-     * @param model - Model identifier (e.g., 'claude-3-5-sonnet', 'gemini-2.5-flash')
-     * @returns GCP region identifier ('us-east5' or 'us-east1')
-     */
-    private detectRegionFromModel;
-    /**
-     * Initialize the gRPC client on first use (lazy loading).
-     *
-     * Loads the protobuf definition, constructs the gRPC service client,
-     * and caches it for reuse. Only called once - subsequent calls return immediately.
-     *
-     * Uses the proto file at runtime to support dynamic loading and avoid bundling
-     * proto files into the compiled JavaScript.
-     *
-     * @throws Error if proto file cannot be found or parsed
-     */
-    private initializeClient;
-    /**
-     * Parse gRPC error to extract user-friendly error message.
-     *
-     * Handles common gRPC error patterns and extracts meaningful messages:
-     * - RESOURCE_EXHAUSTED: Billing/quota issues
-     * - UNAUTHENTICATED: Authentication failures
-     * - PERMISSION_DENIED: Authorization issues
-     * - UNAVAILABLE: Service unavailability
-     * - Other errors: Generic failure message
-     *
-     * @param error - gRPC error object
-     * @returns User-friendly error message
-     */
-    private parseGrpcError;
-    /**
-     * Parse gRPC status error to extract user-friendly error message.
-     *
-     * @param status - gRPC status object
-     * @returns User-friendly error message
-     */
-    private parseGrpcStatusError;
-    /**
-     * Parse resource exhausted errors (billing/quota)
-     */
-    private parseResourceExhaustedError;
-}