byterover-cli 0.4.0 → 1.0.0

package/dist/commands/cipher-agent/show-prompt.js

@@ -1,53 +0,0 @@
-import { Command } from '@oclif/core';
-import { isDevelopment } from '../../config/environment.js';
-import { ProjectConfigStore } from '../../infra/config/file-config-store.js';
-import { OclifTerminal } from '../../infra/terminal/oclif-terminal.js';
-import { getErrorMessage } from '../../utils/error-helpers.js';
-export default class CipherAgentShowPrompt extends Command {
-    static description = 'Show the current CipherAgent system prompt [Development only]';
-    static examples = ['<%= config.bin %> <%= command.id %>'];
-    static hidden = !isDevelopment();
-    terminal = {};
-    createServices() {
-        this.terminal = new OclifTerminal(this);
-        return {
-            projectConfigStore: new ProjectConfigStore(),
-        };
-    }
-    async run() {
-        const { projectConfigStore } = this.createServices();
-        if (!isDevelopment()) {
-            this.terminal.error('This command is only available in development environment');
-            return;
-        }
-        try {
-            // Check if config exists
-            const configExists = await projectConfigStore.exists();
-            if (!configExists) {
-                this.terminal.log('No ByteRover config found.');
-                this.terminal.log('CipherAgent will use the default system prompt.');
-                return;
-            }
-            // Read existing config
-            const config = await projectConfigStore.read();
-            if (!config) {
-                this.terminal.error('Failed to read config.');
-                return;
-            }
-            // Show system prompt
-            if (config.cipherAgentSystemPrompt) {
-                this.terminal.log('Current CipherAgent system prompt:');
-                this.terminal.log('─'.repeat(60));
-                this.terminal.log(config.cipherAgentSystemPrompt);
-                this.terminal.log('─'.repeat(60));
-            }
-            else {
-                this.terminal.log('No custom system prompt configured.');
-                this.terminal.log('CipherAgent is using the default system prompt.');
-            }
-        }
-        catch (error) {
-            this.terminal.error(`Failed to show system prompt: ${getErrorMessage(error)}`);
-        }
-    }
-}

package/dist/commands/foo.d.ts

@@ -1,14 +0,0 @@
-import { Command } from '@oclif/core';
-import type { ICodingAgentLogWatcher } from '../core/interfaces/cipher/i-coding-agent-log-watcher.js';
-import type { IProjectConfigStore } from '../core/interfaces/i-project-config-store.js';
-import type { ITerminal } from '../core/interfaces/i-terminal.js';
-export default class Foo extends Command {
-    static description: string;
-    static hidden: boolean;
-    protected terminal: ITerminal;
-    protected createServices(): Promise<{
-        codingAgentLogWatcher: ICodingAgentLogWatcher;
-        projectConfigStore: IProjectConfigStore;
-    }>;
-    run(): Promise<void>;
-}

package/dist/commands/foo.js

@@ -1,66 +0,0 @@
-import { Command } from '@oclif/core';
-import { isDevelopment } from '../config/environment.js';
-import { CodingAgentLogParser } from '../infra/cipher/parsers/coding-agent-log-parser.js';
-import { CodingAgentLogWatcher } from '../infra/cipher/watcher/coding-agent-log-watcher.js';
-import { ProjectConfigStore } from '../infra/config/file-config-store.js';
-import { OclifTerminal } from '../infra/terminal/oclif-terminal.js';
-import { FileWatcherService } from '../infra/watcher/file-watcher-service.js';
-export default class Foo extends Command {
-    static description = 'Purely for testing CodingAgentLogWatcher [Development only]';
-    static hidden = !isDevelopment();
-    terminal = {};
-    async createServices() {
-        this.terminal = new OclifTerminal(this);
-        const projectConfigStore = new ProjectConfigStore();
-        const fileWatcherService = new FileWatcherService();
-        const codingAgentLogParser = new CodingAgentLogParser();
-        const codingAgentLogWatcher = new CodingAgentLogWatcher(fileWatcherService, codingAgentLogParser);
-        return {
-            codingAgentLogWatcher,
-            projectConfigStore,
-        };
-    }
-    async run() {
-        const { codingAgentLogWatcher, projectConfigStore } = await this.createServices();
-        if (!isDevelopment()) {
-            this.terminal.error('This command is only available in development environment');
-            return;
-        }
-        const projectConfig = await projectConfigStore.read();
-        if (projectConfig === undefined) {
-            this.terminal.error('No project config found. Run "brv init" first.');
-            return;
-        }
-        // Defensive checking nill
-        if (projectConfig.chatLogPath === undefined) {
-            this.terminal.error('No chat log path configured in project config. Run "brv init" first.');
-        }
-        if (projectConfig.ide === undefined) {
-            this.terminal.error('No coding agent selected. Run "brv init" first.');
-        }
-        this.terminal.log(`Watching ${projectConfig.ide} log files...`);
-        await codingAgentLogWatcher.start({
-            codingAgentInfo: {
-                chatLogPath: projectConfig.chatLogPath,
-                name: projectConfig.ide,
-            },
-            onCleanSession: (cleanSession) => new Promise((resolve) => {
-                this.terminal.log(`New Clean Session from ${cleanSession.type}:`);
-                this.terminal.log(`Clean Session title: ${cleanSession.title}`);
-                this.terminal.log('Clean Session messages:');
-                for (const message of cleanSession.messages) {
-                    this.terminal.log(`${JSON.stringify(message, undefined, 2)}]\n`);
-                }
-                this.terminal.log(`Clean Session ID: ${cleanSession.id}`);
-                this.terminal.log(`Clean Session Metadata: ${JSON.stringify(cleanSession.metadata, undefined, 2)}`);
-                resolve();
-                this.terminal.log(`Clean Session timestamp: ${cleanSession.timestamp}`);
-                this.terminal.log(`Clean Session workspace paths:`);
-                for (const workspacePath of cleanSession.workspacePaths) {
-                    this.terminal.log(`${workspacePath}`);
-                }
-                this.terminal.log('\n\n');
-            }),
-        });
-    }
-}

package/dist/infra/cipher/agent-service-factory.d.ts

@@ -1,93 +0,0 @@
-import type { BlobStorageConfig } from '../../core/domain/cipher/blob/types.js';
-import type { FileSystemConfig } from '../../core/domain/cipher/file-system/types.js';
-import type { CipherAgentServices, SessionServices } from '../../core/interfaces/cipher/cipher-services.js';
-/**
- * LLM configuration for CipherAgent
- */
-export interface CipherLLMConfig {
-    accessToken: string;
-    apiBaseUrl: string;
-    apiKey?: string;
-    blobStorageConfig?: Partial<BlobStorageConfig>;
-    fileSystemConfig?: Partial<FileSystemConfig>;
-    httpReferer?: string;
-    maxIterations?: number;
-    maxTokens?: number;
-    model: string;
-    openRouterApiKey?: string;
-    projectId: string;
-    region?: string;
-    sessionKey: string;
-    siteName?: string;
-    temperature?: number;
-    topK?: number;
-    topP?: number;
-    /**
-     * Enable granular history storage for new sessions.
-     * When enabled, new sessions use per-message storage with streaming support.
-     * Existing sessions continue using blob storage (no migration).
-     * Default: false (use blob storage for all sessions)
-     */
-    useGranularStorage?: boolean;
-    verbose?: boolean;
-}
-/**
- * HTTP configuration for ByteRover LLM service
- */
-export interface ByteRoverHttpConfig {
-    accessToken: string;
-    apiBaseUrl: string;
-    projectId: string;
-    region?: string;
-    sessionKey: string;
-    spaceId: string;
-    teamId: string;
-    timeout?: number;
-}
-export type { CipherAgentServices, SessionManagerConfig, SessionServices, } from '../../core/interfaces/cipher/cipher-services.js';
-/**
- * Creates shared services for CipherAgent.
- * These services are singletons shared across all sessions.
- *
- * Following Dexto's pattern: shared services are created once at agent level,
- * while session-specific services (LLM, EventBus) are created per session.
- *
- * @param llmConfig - LLM configuration
- * @returns Initialized shared services
- */
-export declare function createCipherAgentServices(llmConfig: CipherLLMConfig): Promise<CipherAgentServices>;
-/**
- * Creates session-specific services for a ChatSession.
- *
- * Following Dexto's pattern: each session gets its own LLM service and event bus
- * for conversation isolation, while using shared services for tools/prompts.
- *
- * Generator composition order (innermost to outermost):
- * 1. Base generator (ByteRoverContentGenerator or OpenRouterContentGenerator)
- * 2. RetryableContentGenerator - handles transient errors with backoff
- * 3. LoggingContentGenerator - debug logging (if verbose enabled)
- *
- * @param sessionId - Unique session identifier
- * @param sharedServices - Shared services from agent
- * @param httpConfig - HTTP configuration
- * @param llmConfig - LLM service configuration
- * @param llmConfig.openRouterApiKey - Optional OpenRouter API key for OpenRouter service
- * @param llmConfig.httpReferer - Optional HTTP Referer for OpenRouter rankings
- * @param llmConfig.siteName - Optional site name for OpenRouter rankings
- * @param llmConfig.maxIterations - Maximum iterations for agentic loop
- * @param llmConfig.maxTokens - Maximum output tokens
- * @param llmConfig.model - LLM model identifier
- * @param llmConfig.temperature - Temperature for generation
- * @param llmConfig.verbose - Enable verbose debug output
- * @returns Initialized session services
- */
-export declare function createSessionServices(sessionId: string, sharedServices: CipherAgentServices, httpConfig: ByteRoverHttpConfig, llmConfig: {
-    httpReferer?: string;
-    maxIterations?: number;
-    maxTokens?: number;
-    model: string;
-    openRouterApiKey?: string;
-    siteName?: string;
-    temperature?: number;
-    verbose?: boolean;
-}): SessionServices;

package/dist/infra/cipher/cipher-agent-state-manager.d.ts

@@ -1,63 +0,0 @@
-import type { TerminationReason } from '../../core/domain/cipher/agent/agent-state.js';
-import type { AgentExecutionState, AgentState } from '../../core/interfaces/cipher/i-cipher-agent.js';
-/**
- * Manages the runtime state of the CipherAgent.
- *
- * Enhanced to track execution state, termination reasons, timing,
- * and tool metrics following gemini-cli patterns. Maintains backward
- * compatibility with legacy fields (executionHistory).
- */
-export declare class CipherAgentStateManager {
-    private currentIteration;
-    private durationMs?;
-    private endTime?;
-    private executionHistory;
-    private executionState;
-    private startTime?;
-    private terminationReason?;
-    private toolCallsExecuted;
-    /**
-     * Add an execution record to history (legacy method).
-     * @param record - Execution record to add
-     */
-    addExecutionRecord(record: string): void;
-    /**
-     * Mark execution as complete with reason.
-     * @param reason - Why execution terminated
-     */
-    complete(reason: TerminationReason): void;
-    /**
-     * Mark execution as errored.
-     * @param reason - Error termination reason
-     */
-    fail(reason: TerminationReason): void;
-    /**
-     * Get the current state.
-     * @returns Current agent state with all enhanced fields
-     */
-    getState(): AgentState;
-    /**
-     * Increment the iteration counter.
-     * @returns The new iteration count
-     */
-    incrementIteration(): number;
-    /**
-     * Increment the tool calls counter.
-     * @returns The new tool calls count
-     */
-    incrementToolCalls(): number;
-    /**
-     * Reset the state to initial values.
-     */
-    reset(): void;
-    /**
-     * Set the current execution state.
-     * @param state - New execution state
-     */
-    setExecutionState(state: AgentExecutionState): void;
-    /**
-     * Start execution tracking.
-     * Sets startTime and transitions to executing state.
-     */
-    startExecution(): void;
-}

package/dist/infra/cipher/cipher-agent-state-manager.js

@@ -1,108 +0,0 @@
-/**
- * Manages the runtime state of the CipherAgent.
- *
- * Enhanced to track execution state, termination reasons, timing,
- * and tool metrics following gemini-cli patterns. Maintains backward
- * compatibility with legacy fields (executionHistory).
- */
-export class CipherAgentStateManager {
-    currentIteration = 0;
-    durationMs;
-    endTime;
-    executionHistory = [];
-    executionState = 'idle';
-    startTime;
-    terminationReason;
-    toolCallsExecuted = 0;
-    /**
-     * Add an execution record to history (legacy method).
-     * @param record - Execution record to add
-     */
-    addExecutionRecord(record) {
-        this.executionHistory.push(record);
-    }
-    /**
-     * Mark execution as complete with reason.
-     * @param reason - Why execution terminated
-     */
-    complete(reason) {
-        this.executionState = 'complete';
-        this.terminationReason = reason;
-        this.endTime = new Date();
-        if (this.startTime) {
-            this.durationMs = this.endTime.getTime() - this.startTime.getTime();
-        }
-    }
-    /**
-     * Mark execution as errored.
-     * @param reason - Error termination reason
-     */
-    fail(reason) {
-        this.executionState = 'error';
-        this.terminationReason = reason;
-        this.endTime = new Date();
-        if (this.startTime) {
-            this.durationMs = this.endTime.getTime() - this.startTime.getTime();
-        }
-    }
-    /**
-     * Get the current state.
-     * @returns Current agent state with all enhanced fields
-     */
-    getState() {
-        return {
-            currentIteration: this.currentIteration,
-            durationMs: this.durationMs,
-            endTime: this.endTime,
-            executionHistory: [...this.executionHistory],
-            executionState: this.executionState,
-            startTime: this.startTime,
-            terminationReason: this.terminationReason,
-            toolCallsExecuted: this.toolCallsExecuted,
-        };
-    }
-    /**
-     * Increment the iteration counter.
-     * @returns The new iteration count
-     */
-    incrementIteration() {
-        this.currentIteration++;
-        return this.currentIteration;
-    }
-    /**
-     * Increment the tool calls counter.
-     * @returns The new tool calls count
-     */
-    incrementToolCalls() {
-        this.toolCallsExecuted++;
-        return this.toolCallsExecuted;
-    }
-    /**
-     * Reset the state to initial values.
-     */
-    reset() {
-        this.currentIteration = 0;
-        this.durationMs = undefined;
-        this.endTime = undefined;
-        this.executionHistory = [];
-        this.executionState = 'idle';
-        this.startTime = undefined;
-        this.terminationReason = undefined;
-        this.toolCallsExecuted = 0;
-    }
-    /**
-     * Set the current execution state.
-     * @param state - New execution state
-     */
-    setExecutionState(state) {
-        this.executionState = state;
-    }
-    /**
-     * Start execution tracking.
-     * Sets startTime and transitions to executing state.
-     */
-    startExecution() {
-        this.startTime = new Date();
-        this.executionState = 'executing';
-    }
-}

package/dist/infra/cipher/cipher-agent.d.ts

@@ -1,182 +0,0 @@
-import type { BrvConfig } from '../../core/domain/entities/brv-config.js';
-import type { IChatSession } from '../../core/interfaces/cipher/i-chat-session.js';
-import type { AgentState, ExecutionContext, ICipherAgent } from '../../core/interfaces/cipher/i-cipher-agent.js';
-import type { IHistoryStorage } from '../../core/interfaces/cipher/i-history-storage.js';
-import type { CipherLLMConfig } from './agent-service-factory.js';
-import type { AgentEventBus } from './events/event-emitter.js';
-import type { FileSystemService } from './file-system/file-system-service.js';
-import type { MemoryManager } from './memory/memory-manager.js';
-import type { ProcessService } from './process/process-service.js';
-import type { SimplePromptFactory } from './system-prompt/simple-prompt-factory.js';
-import type { ToolManager } from './tools/tool-manager.js';
-import type { ToolProvider } from './tools/tool-provider.js';
-/**
- * CipherAgent - Main agent implementation
- *
- * Following Dexto's pattern: CipherAgent orchestrates sessions and delegates
- * execution to ChatSession instances. Each session maintains isolated conversation
- * context while sharing global services (tools, prompts, file system, etc.).
- *
- * Architecture:
- * - Agent creates and owns shared services (ToolManager, SystemPromptManager, etc.)
- * - SessionManager creates session-specific services (LLM, EventBus)
- * - Agent delegates execution to sessions via session.run()
- *
- * Follows two-phase initialization:
- * 1. Constructor: validates and stores config
- * 2. start(): asynchronously creates all services and SessionManager
- *
- * Backward compatible:
- * - execute(input) uses default session automatically
- * - New: execute(input, sessionId) for multi-session support
- */
-export declare class CipherAgent implements ICipherAgent {
-    readonly agentEventBus?: AgentEventBus;
-    readonly fileSystemService?: FileSystemService;
-    readonly historyStorage?: IHistoryStorage;
-    readonly memoryManager?: MemoryManager;
-    readonly processService?: ProcessService;
-    readonly promptFactory?: SimplePromptFactory;
-    readonly toolManager?: ToolManager;
-    readonly toolProvider?: ToolProvider;
-    private readonly _brvConfig?;
-    private _isStarted;
-    private readonly currentDefaultSessionId;
-    private defaultSession;
-    private readonly llmConfig;
-    private sessionManager?;
-    private readonly stateManager;
-    /**
-     * Creates a new CipherAgent instance
-     * Does NOT initialize services - call start() for async initialization
-     *
-     * @param llmConfig - LLM configuration (API key, model settings)
-     * @param brvConfig - Optional ByteRover config (for custom system prompt)
-     */
-    constructor(llmConfig: CipherLLMConfig, brvConfig?: BrvConfig);
-    /**
-     * Create a new session.
-     *
-     * @param sessionId - Optional session ID (generates UUID if not provided)
-     * @returns New or existing chat session
-     */
-    createSession(sessionId?: string): Promise<IChatSession>;
-    /**
-     * Delete a session completely (memory + history).
-     *
-     * @param sessionId - Session ID to delete
-     * @returns True if session existed and was deleted
-     */
-    deleteSession(sessionId: string): Promise<boolean>;
-    /**
-     * Execute the agent with user input.
-     *
-     * Following Dexto's pattern: determine target session, get or create it,
-     * then delegate to session.run().
-     *
-     * @param input - User input string
-     * @param sessionId - Optional session ID (uses 'default' if not provided)
-     * @param options - Optional execution options
-     * @param options.mode - Optional mode for system prompt ('autonomous' enables autonomous mode)
-     * @param options.executionContext - Optional execution context
-     * @returns Agent response from LLM
-     * @throws Error if agent is not started
-     */
-    execute(input: string, sessionId?: string, options?: {
-        executionContext?: ExecutionContext;
-        mode?: 'autonomous' | 'default' | 'query';
-    }): Promise<string>;
-    /**
-     * Get an existing session or create a new one.
-     * Useful for ensuring a session exists before pre-loading history.
-     *
-     * @param sessionId - Session ID to get or create
-     * @returns Existing or newly created chat session
-     */
-    getOrCreateSession(sessionId: string): Promise<IChatSession>;
-    /**
-     * Get a session by ID.
-     *
-     * @param sessionId - Session ID
-     * @returns Session instance or undefined if not found
-     */
-    getSession(sessionId: string): IChatSession | undefined;
-    /**
-     * Get session metadata without loading full history.
-     *
-     * @param sessionId - Session ID
-     * @returns Session metadata or undefined if not found
-     */
-    getSessionMetadata(sessionId: string): Promise<import('../../core/domain/cipher/storage/history-types.js').SessionMetadata | undefined>;
-    /**
-     * Get current agent state
-     *
-     * @returns Current state information
-     */
-    getState(): AgentState;
-    /**
-     * Get the current system prompt from SimplePromptFactory
-     * Useful for debugging and inspection
-     *
-     * @returns Current system prompt (built dynamically)
-     */
-    getSystemPrompt(): Promise<string>;
-    /**
-     * List all persisted session IDs from history storage.
-     *
-     * @returns Array of session IDs
-     */
-    listPersistedSessions(): Promise<string[]>;
-    /**
-     * List all session IDs (in-memory only).
-     *
-     * @returns Array of session IDs
-     */
-    listSessions(): string[];
-    /**
-     * Reset the agent to initial state.
-     * Clears execution history, resets iteration counter, and resets default session.
-     */
-    reset(): void;
-    /**
-     * Start the agent - initializes all services asynchronously
-     * Must be called before execute()
-     *
-     * @throws Error if agent is already started
-     */
-    start(): Promise<void>;
-    /**
-     * Ensure the agent has been started and all services are initialized
-     *
-     * @throws Error if agent is not started or services are not initialized
-     */
-    private ensureStarted;
-    /**
-     * Get initialized agent event bus (guaranteed to be defined after start())
-     *
-     * @returns AgentEventBus instance
-     * @throws Error if not initialized
-     */
-    private getAgentEventBus;
-    /**
-     * Get initialized history storage (guaranteed to be defined after start())
-     *
-     * @returns IHistoryStorage instance
-     * @throws Error if not initialized
-     */
-    private getHistoryStorage;
-    /**
-     * Get initialized prompt factory (guaranteed to be defined after start())
-     *
-     * @returns SimplePromptFactory instance
-     * @throws Error if not initialized
-     */
-    private getPromptFactory;
-    /**
-     * Get initialized session manager (guaranteed to be defined after start())
-     *
-     * @returns SessionManager instance
-     * @throws Error if not initialized
-     */
-    private getSessionManager;
-}