byterover-cli 0.4.1 → 1.0.0

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

@@ -0,0 +1,165 @@
+import type { GenerateResponse, StreamingEvent, StreamOptions } from '../../../core/domain/cipher/streaming/types.js';
+import type { BrvConfig } from '../../../core/domain/entities/brv-config.js';
+import type { CipherAgentServices } from '../../../core/interfaces/cipher/cipher-services.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 { 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 { SystemPromptManager } from '../system-prompt/system-prompt-manager.js';
+import type { ToolManager } from '../tools/tool-manager.js';
+import type { ToolProvider } from '../tools/tool-provider.js';
+import type { AgentConfig } from './agent-schemas.js';
+import { AgentEventBus } from '../events/event-emitter.js';
+import { BaseAgent } from './base-agent.js';
+/**
+ * CipherAgent - Main agent implementation extending BaseAgent.
+ *
+ * Inherits from BaseAgent:
+ * - Two-phase initialization (constructor + start)
+ * - Lifecycle management (start, stop, restart)
+ * - State management with session overrides
+ * - Typed error handling
+ * - Configuration validation (Zod)
+ *
+ * Architecture (DextoAgent pattern):
+ * - Agent creates AgentEventBus in constructor (available before start)
+ * - Agent creates and owns shared services (ToolManager, SystemPromptManager, etc.)
+ * - SessionManager creates session-specific services (LLM, SessionEventBus)
+ * - Agent delegates execution to sessions via session.run()
+ *
+ * Usage:
+ * - execute(input) uses default session automatically
+ * - execute(input, sessionId) for multi-session support
+ */
+export declare class CipherAgent extends BaseAgent implements ICipherAgent {
+    private readonly _agentEventBus;
+    private readonly _brvConfig?;
+    /**
+     * Session ID - created once during start().
+     * Each agent has exactly 1 session (Single-Session pattern).
+     */
+    private _sessionId?;
+    private readonly activeStreamControllers;
+    private sessionManager?;
+    /**
+     * Creates a new CipherAgent instance.
+     * Does NOT initialize services - call start() for async initialization.
+     *
+     * @param config - Agent configuration (Zod-validated AgentConfig)
+     * @param brvConfig - Optional ByteRover config for spaceId/teamId
+     */
+    constructor(config: AgentConfig, brvConfig?: BrvConfig);
+    get agentEventBus(): AgentEventBus | undefined;
+    get fileSystemService(): FileSystemService | undefined;
+    get historyStorage(): IHistoryStorage | undefined;
+    get memoryManager(): MemoryManager | undefined;
+    get processService(): ProcessService | undefined;
+    /**
+     * Get the session ID (created during start()).
+     * Each agent has exactly 1 session (Single-Session pattern).
+     */
+    get sessionId(): string | undefined;
+    get systemPromptManager(): SystemPromptManager | undefined;
+    get toolManager(): ToolManager | undefined;
+    get toolProvider(): ToolProvider | undefined;
+    /**
+     * Cancels the currently running turn for the agent's default session.
+     * Safe to call even if no run is in progress.
+     *
+     * @returns true if a run was in progress and was signaled to abort; false otherwise
+     */
+    cancel(): Promise<boolean>;
+    protected cleanupServices(): Promise<void>;
+    /**
+     * Create a new session.
+     */
+    createSession(sessionId?: string): Promise<IChatSession>;
+    /**
+     * Delete a session completely (memory + history).
+     */
+    deleteSession(sessionId: string): Promise<boolean>;
+    /**
+     * Execute the agent with user input.
+     * Uses the agent's default session (created during start()).
+     * Internally uses generate() for single code path maintainability.
+     *
+     * @param input - User message
+     * @param options - Optional execution options
+     * @param options.executionContext - Optional execution context
+     * @param options.taskId - Optional task ID for concurrent task isolation
+     */
+    execute(input: string, options?: {
+        executionContext?: ExecutionContext;
+        taskId?: string;
+    }): Promise<string>;
+    /**
+     * Generate a complete response (waits for full completion).
+     * Wrapper around stream() that collects all events and returns final result.
+     * Uses the agent's default session (created during start()).
+     *
+     * @param input - User message
+     * @param options - Optional configuration (signal for cancellation, taskId for billing)
+     * @returns Complete response with content, usage, and tool calls
+     */
+    generate(input: string, options?: StreamOptions): Promise<GenerateResponse>;
+    /**
+     * Get an existing session or create a new one.
+     */
+    getOrCreateSession(sessionId: string): Promise<IChatSession>;
+    /**
+     * Get a session by ID.
+     */
+    getSession(sessionId: string): IChatSession | undefined;
+    /**
+     * Get session metadata without loading full history.
+     */
+    getSessionMetadata(sessionId: string): Promise<import('../../../core/domain/cipher/storage/history-types.js').SessionMetadata | undefined>;
+    /**
+     * Get current agent state.
+     * Returns default state if agent is not yet started.
+     */
+    getState(): AgentState;
+    /**
+     * Get the current system prompt.
+     */
+    getSystemPrompt(): Promise<string>;
+    protected initializeServices(): Promise<CipherAgentServices>;
+    /**
+     * List all persisted session IDs from history storage.
+     */
+    listPersistedSessions(): Promise<string[]>;
+    /**
+     * List all session IDs (in-memory only).
+     */
+    listSessions(): string[];
+    /**
+     * Reset the agent to initial state.
+     * Resets execution state only. To reset sessions, use resetSession(sessionId).
+     */
+    reset(): void;
+    /**
+     * Reset a specific session's conversation history.
+     * @param sessionId - The session ID to reset
+     */
+    resetSession(sessionId: string): void;
+    /**
+     * Start the agent - initializes all services asynchronously.
+     * Must be called before execute().
+     */
+    start(): Promise<void>;
+    /**
+     * Stream a response with real-time event emission.
+     * Uses the agent's default session (created during start()).
+     *
+     * @param input - User message
+     * @param options - Optional configuration (signal for cancellation, taskId for billing)
+     * @returns AsyncIterator that yields StreamingEvent objects
+     */
+    stream(input: string, options?: StreamOptions): Promise<AsyncIterableIterator<StreamingEvent>>;
+    private getHistoryStorageInternal;
+    private getSessionIdInternal;
+    private getSessionManagerInternal;
+    private getSystemPromptManagerInternal;
+}