byterover-cli 0.4.0 → 1.0.0

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

@@ -1,317 +0,0 @@
-import { createCipherAgentServices } from './agent-service-factory.js';
-import { CipherAgentStateManager } from './cipher-agent-state-manager.js';
-import { SessionManager } from './session/session-manager.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 class CipherAgent {
-    // Shared services (exposed publicly for external access)
-    // Made optional to avoid definite assignment assertions
-    agentEventBus;
-    fileSystemService;
-    historyStorage;
-    memoryManager;
-    processService;
-    promptFactory;
-    toolManager;
-    toolProvider;
-    _brvConfig;
-    _isStarted = false;
-    currentDefaultSessionId = 'default';
-    defaultSession = null;
-    llmConfig;
-    sessionManager;
-    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, brvConfig) {
-        this.llmConfig = llmConfig;
-        this._brvConfig = brvConfig;
-        this.stateManager = new CipherAgentStateManager();
-    }
-    /**
-     * Create a new session.
-     *
-     * @param sessionId - Optional session ID (generates UUID if not provided)
-     * @returns New or existing chat session
-     */
-    async createSession(sessionId) {
-        this.ensureStarted();
-        return this.getSessionManager().createSession(sessionId);
-    }
-    /**
-     * Delete a session completely (memory + history).
-     *
-     * @param sessionId - Session ID to delete
-     * @returns True if session existed and was deleted
-     */
-    async deleteSession(sessionId) {
-        this.ensureStarted();
-        return this.getSessionManager().deleteSession(sessionId);
-    }
-    /**
-     * 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
-     */
-    async execute(input, sessionId, options) {
-        // Ensure agent is started
-        this.ensureStarted();
-        // Determine target session (backward compatible: defaults to 'default')
-        const targetSessionId = sessionId ?? this.currentDefaultSessionId;
-        // Get or create session (lazy loading pattern from Dexto)
-        const sessionMgr = this.getSessionManager();
-        const existingSession = sessionMgr.getSession(targetSessionId);
-        const session = existingSession ?? (await sessionMgr.createSession(targetSessionId));
-        // Cache default session for faster access
-        if (targetSessionId === this.currentDefaultSessionId && !this.defaultSession) {
-            this.defaultSession = session;
-        }
-        // Increment iteration counter (agent-level state) - kept for internal tracking only
-        this.stateManager.incrementIteration();
-        // Note: Execution records removed to reduce log noise
-        // DELEGATE TO SESSION
-        // The ChatSession will:
-        // 1. Call llmService.completeTask()
-        // 2. LLM service handles agentic loop (tools, prompts, iterations)
-        // 3. Events forwarded from session bus to agent bus
-        const response = await session.run(input, options);
-        return response;
-    }
-    /**
-     * 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
-     */
-    async getOrCreateSession(sessionId) {
-        this.ensureStarted();
-        const sessionMgr = this.getSessionManager();
-        const existingSession = sessionMgr.getSession(sessionId);
-        return existingSession ?? sessionMgr.createSession(sessionId);
-    }
-    /**
-     * Get a session by ID.
-     *
-     * @param sessionId - Session ID
-     * @returns Session instance or undefined if not found
-     */
-    getSession(sessionId) {
-        this.ensureStarted();
-        return this.getSessionManager().getSession(sessionId);
-    }
-    /**
-     * Get session metadata without loading full history.
-     *
-     * @param sessionId - Session ID
-     * @returns Session metadata or undefined if not found
-     */
-    async getSessionMetadata(sessionId) {
-        this.ensureStarted();
-        return this.getHistoryStorage().getSessionMetadata(sessionId);
-    }
-    /**
-     * Get current agent state
-     *
-     * @returns Current state information
-     */
-    getState() {
-        return this.stateManager.getState();
-    }
-    /**
-     * Get the current system prompt from SimplePromptFactory
-     * Useful for debugging and inspection
-     *
-     * @returns Current system prompt (built dynamically)
-     */
-    async getSystemPrompt() {
-        this.ensureStarted();
-        return this.getPromptFactory().buildSystemPrompt({});
-    }
-    /**
-     * List all persisted session IDs from history storage.
-     *
-     * @returns Array of session IDs
-     */
-    async listPersistedSessions() {
-        this.ensureStarted();
-        return this.getHistoryStorage().listSessions();
-    }
-    /**
-     * List all session IDs (in-memory only).
-     *
-     * @returns Array of session IDs
-     */
-    listSessions() {
-        this.ensureStarted();
-        return this.getSessionManager().listSessions();
-    }
-    /**
-     * Reset the agent to initial state.
-     * Clears execution history, resets iteration counter, and resets default session.
-     */
-    reset() {
-        this.stateManager.reset();
-        // Reset default session if it exists
-        if (this.defaultSession) {
-            this.defaultSession.reset();
-        }
-        // Emit conversation reset event (only if agent is started)
-        if (this._isStarted) {
-            this.getAgentEventBus().emit('cipher:conversationReset', {
-                sessionId: this.currentDefaultSessionId,
-            });
-        }
-    }
-    /**
-     * Start the agent - initializes all services asynchronously
-     * Must be called before execute()
-     *
-     * @throws Error if agent is already started
-     */
-    async start() {
-        if (this._isStarted) {
-            throw new Error('CipherAgent is already started');
-        }
-        // Services will create necessary directories during their initialization
-        // No need for upfront validation - let services handle their own setup
-        // Create SHARED services only (following Dexto's pattern)
-        const sharedServices = await createCipherAgentServices(this.llmConfig);
-        // Extract HTTP config from llmConfig
-        const httpConfig = {
-            accessToken: this.llmConfig.accessToken,
-            apiBaseUrl: this.llmConfig.apiBaseUrl,
-            projectId: this.llmConfig.projectId,
-            region: this.llmConfig.region,
-            sessionKey: this.llmConfig.sessionKey,
-            spaceId: this._brvConfig?.spaceId ?? '',
-            teamId: this._brvConfig?.teamId ?? '',
-        };
-        // Extract LLM config for sessions
-        const sessionLLMConfig = {
-            httpReferer: this.llmConfig.httpReferer,
-            maxIterations: this.llmConfig.maxIterations,
-            maxTokens: this.llmConfig.maxTokens,
-            model: this.llmConfig.model,
-            openRouterApiKey: this.llmConfig.openRouterApiKey,
-            siteName: this.llmConfig.siteName,
-            temperature: this.llmConfig.temperature,
-            verbose: this.llmConfig.verbose,
-        };
-        // Create SessionManager with shared services
-        const sessionManager = new SessionManager(sharedServices, httpConfig, sessionLLMConfig, {
-            config: {
-                maxSessions: 100,
-                sessionTTL: 3_600_000, // 1 hour
-            },
-        });
-        // Assign services using Object.assign for readonly properties
-        Object.assign(this, {
-            ...sharedServices,
-            sessionManager,
-        });
-        this._isStarted = true;
-    }
-    /**
-     * Ensure the agent has been started and all services are initialized
-     *
-     * @throws Error if agent is not started or services are not initialized
-     */
-    ensureStarted() {
-        if (!this._isStarted) {
-            throw new Error('CipherAgent must be started before use. Call start() first.');
-        }
-        // Runtime validation to ensure services were properly initialized
-        if (!this.agentEventBus ||
-            !this.fileSystemService ||
-            !this.historyStorage ||
-            !this.memoryManager ||
-            !this.processService ||
-            !this.promptFactory ||
-            !this.toolManager ||
-            !this.toolProvider ||
-            !this.sessionManager) {
-            throw new Error('CipherAgent services not properly initialized. This is a bug.');
-        }
-    }
-    /**
-     * Get initialized agent event bus (guaranteed to be defined after start())
-     *
-     * @returns AgentEventBus instance
-     * @throws Error if not initialized
-     */
-    getAgentEventBus() {
-        if (!this.agentEventBus) {
-            throw new Error('AgentEventBus not initialized. This is a bug.');
-        }
-        return this.agentEventBus;
-    }
-    /**
-     * Get initialized history storage (guaranteed to be defined after start())
-     *
-     * @returns IHistoryStorage instance
-     * @throws Error if not initialized
-     */
-    getHistoryStorage() {
-        if (!this.historyStorage) {
-            throw new Error('HistoryStorage not initialized. This is a bug.');
-        }
-        return this.historyStorage;
-    }
-    /**
-     * Get initialized prompt factory (guaranteed to be defined after start())
-     *
-     * @returns SimplePromptFactory instance
-     * @throws Error if not initialized
-     */
-    getPromptFactory() {
-        if (!this.promptFactory) {
-            throw new Error('SimplePromptFactory not initialized. This is a bug.');
-        }
-        return this.promptFactory;
-    }
-    /**
-     * Get initialized session manager (guaranteed to be defined after start())
-     *
-     * @returns SessionManager instance
-     * @throws Error if not initialized
-     */
-    getSessionManager() {
-        if (!this.sessionManager) {
-            throw new Error('SessionManager not initialized. This is a bug.');
-        }
-        return this.sessionManager;
-    }
-}

package/dist/infra/cipher/system-prompt/simple-prompt-factory.d.ts

@@ -1,106 +0,0 @@
-import type { MemoryManager } from '../memory/memory-manager.js';
-/**
- * Simple prompt configuration loaded from YAML
- */
-export interface PromptConfig {
-    description?: string;
-    excluded_tools?: string[];
-    prompt: string;
-    prompts?: Record<string, string>;
-}
-/**
- * Context for building system prompts
- */
-export interface BuildContext {
-    availableMarkers?: Record<string, string>;
-    availableTools?: string[];
-    commandType?: 'curate' | 'query';
-    conversationMetadata?: {
-        conversationId?: string;
-        title?: string;
-    };
-    fileReferenceInstructions?: string;
-    memoryManager?: MemoryManager;
-    mode?: 'autonomous' | 'default' | 'query';
-}
-/**
- * Simple prompt factory following Serena's design pattern.
- *
- * Key features:
- * - Loads simple YAML files with `prompt` field
- * - Uses basic {{variable}} template syntax
- * - No complex contributor pattern
- * - Direct concatenation of base + modes + dynamic content
- */
-export declare class SimplePromptFactory {
-    private readonly basePath;
-    private readonly cache;
-    private readonly verbose;
-    /**
-     * Creates a new simple prompt factory
-     *
-     * @param basePath - Base path for prompt files (defaults to dist/resources/prompts)
-     * @param verbose - Enable verbose debug output
-     */
-    constructor(basePath?: string, verbose?: boolean);
-    /**
-     * Build a reflection prompt for completion checking.
-     *
-     * @param context - Context with iteration information
-     * @param context.type - Type of reflection prompt to build
-     * @param context.currentIteration - Current iteration number (required for near_max_iterations and mid_point_check)
-     * @param context.maxIterations - Maximum iterations allowed (required for near_max_iterations and mid_point_check)
-     * @returns Formatted reflection prompt
-     */
-    buildReflectionPrompt(context: {
-        currentIteration?: number;
-        maxIterations?: number;
-        type: 'completion_check' | 'final_iteration' | 'mid_point_check' | 'near_max_iterations';
-    }): string;
-    /**
-     * Build the complete system prompt
-     *
-     * @param context - Runtime context with tools, markers, modes, etc.
-     * @returns Complete system prompt string
-     */
-    buildSystemPrompt(context?: BuildContext): Promise<string>;
-    /**
-     * Get tool-specific output guidance for a tool
-     *
-     * @param toolName - The name of the tool (e.g., 'write_memory')
-     * @returns The guidance text if available, null otherwise
-     */
-    getToolOutputGuidance(toolName: string): null | string;
-    /**
-     * Discover companion prompt files for a given mode.
-     * Looks for files matching the pattern: {mode}-*.yml
-     *
-     * @param mode - The mode name (e.g., 'autonomous', 'query')
-     * @returns Array of relative file paths to companion prompts
-     */
-    private discoverCompanionPrompts;
-    /**
-     * Format memories for inclusion in system prompt
-     *
-     * @param memoryManager - Memory manager instance
-     * @returns Formatted memories string
-     */
-    private formatMemories;
-    /**
-     * Load a prompt YAML file
-     *
-     * @param filepath - Relative path from basePath
-     * @returns Parsed prompt configuration
-     */
-    private loadPrompt;
-    /**
-     * Render a template string with variable substitution
-     *
-     * Uses simple {{variable}} syntax (same as current PromptRenderer.render())
-     *
-     * @param template - Template string with {{variable}} placeholders
-     * @param variables - Variables to substitute
-     * @returns Rendered string
-     */
-    private renderTemplate;
-}