indusagi-coding-agent 0.1.58 → 0.1.60

package/dist/runtime/agent-session.d.ts

@@ -1,988 +0,0 @@
-/**
- * Agent Session - Core abstraction for agent lifecycle and session management
- *
- * @module core/agent-session
- * @description
- * Central controller for agent execution across all run modes (interactive, print, RPC).
- * Manages complete agent lifecycle including state, events, persistence, and tool execution.
- *
- * Based on session management patterns from Anthropic's Claude API SDK
- * and stateful execution frameworks. Refactored for multi-modal agent architecture.
- *
- * ## Responsibilities
- *
- * **Agent Lifecycle Management:**
- * - Session initialization and persistence
- * - Event subscription and publishing
- * - State transitions and message handling
- * - Model and thinking level selection
- *
- * **Tool Execution:**
- * - Bash command execution with streaming and cancellation
- * - Tool wrapping with extensions and hooks
- * - Result recording and context building
- *
- * **Session Persistence:**
- * - Automatic message persisting on completion
- * - Session compaction and summarization
- * - Branch navigation and forking
- * - Context overflow recovery
- *
- * **Advanced Features:**
- * - Auto-retry with exponential backoff for transient errors
- * - Auto-compaction at configurable thresholds
- * - Branch summarization for abandoned paths
- * - Extension system integration
- * - Skill and prompt template expansion
- *
- * ## Architecture
- *
- * This class is shared between all run modes (interactive, print, RPC).
- * Modes use this class and add their own I/O layer on top.
- *
- * **Core Dependencies:**
- * - EventBus: Event subscription system (internal only)
- * - SessionManager: Persistence layer for session files
- * - SettingsManager: User configuration
- * - ExtensionRunner: Plugin system with command registration
- * - HookRunner: Lifecycle hooks for advanced customization
- * - Tools: Bash, read, write, edit, find, grep, and more
- * - CompactionSystem: Automatic context compression
- *
- * **Event Flow:**
- * ```
- * Agent Events -> AgentSession._handleAgentEvent
- * -> Extensions (hooks + custom message emission)
- * -> User Listeners (via subscribe())
- * -> Persistence (session manager)
- * -> Auto-retry / Auto-compaction checks
- * ```
- *
- * **Tool Execution Flow:**
- * ```
- * Agent Tool Call
- * -> Extensions (before hooks)
- * -> Tool Implementation
- * -> Streaming via onChunk callback
- * -> Tool Result Recording
- * -> Extensions (after hooks)
- * -> Context Building
- * ```
- *
- * ## Usage Examples
- *
- * ### Initialize a session
- * ```typescript
- * const config: AgentSessionConfig = {
- *   agent: new Agent({ ... }),
- *   sessionManager: new SessionManager({ ... }),
- *   settingsManager: new SettingsManager({ ... }),
- *   cwd: process.cwd(),
- *   resourceLoader: new ResourceLoader({ ... }),
- *   modelRegistry: new ModelRegistry({ ... }),
- * };
- *
- * const session = new AgentSession(config);
- * ```
- *
- * ### Subscribe to events
- * ```typescript
- * const unsubscribe = session.subscribe((event) => {
- *   if (event.type === "message_end") {
- *     console.log("Message completed:", event.message);
- *   }
- * });
- * ```
- *
- * ### Send a prompt
- * ```typescript
- * // User prompt with model validation
- * await session.prompt("Help me refactor this code", {
- *   expandPromptTemplates: true,
- * });
- *
- * // Extension command (executed immediately)
- * await session.prompt("/login anthropic");
- *
- * // During streaming: interrupt with steering
- * await session.steer("Wait, try a different approach");
- *
- * // Or queue follow-up
- * await session.followUp("Please continue when done");
- * ```
- *
- * ### Execute bash
- * ```typescript
- * const result = await session.executeBash("npm test", (chunk) => {
- *   process.stdout.write(chunk);
- * });
- *
- * console.log("Exit code:", result.exitCode);
- * if (result.truncated) {
- *   console.log("Full output:", result.fullOutputPath);
- * }
- * ```
- *
- * ### Session management
- * ```typescript
- * // Create new session
- * await session.newSession();
- *
- * // Switch to existing session
- * await session.switchSession("/path/to/session.jsonl");
- *
- * // Fork at specific entry
- * const { selectedText, cancelled } = await session.fork(entryId);
- *
- * // Navigate tree with optional branch summarization
- * await session.navigateTree(targetId, { summarize: true });
- *
- * // Manually compact session
- * await session.compact("Focus on backend changes");
- * ```
- *
- * ### Model & thinking level
- * ```typescript
- * // Cycle through models (or scoped models if --models was used)
- * const result = await session.cycleModel("forward");
- * console.log("Switched to:", result?.model.id);
- *
- * // Set thinking level (automatically clamped to model capabilities)
- * session.setThinkingLevel("high");
- * const available = session.getAvailableThinkingLevels();
- * ```
- *
- * ## Lifecycle Hooks
- *
- * Extensions can listen to these session events:
- * - `session_start`: Session initialized or reloaded
- * - `session_switch`: Switched to different session file
- * - `session_fork`: Created fork from entry
- * - `session_tree`: Navigated within tree
- * - `session_before_switch`: Before switching (can cancel)
- * - `session_before_fork`: Before creating fork (can cancel)
- * - `session_before_tree`: Before tree navigation (can cancel)
- * - `session_before_compact`: Before compaction (can cancel or provide custom)
- * - `session_compact`: Completed compaction
- * - `session_shutdown`: Session cleanup
- *
- * ## Error Handling
- *
- * **Transient Errors (auto-retry):**
- * - Overloaded/rate limit errors
- * - Server 5xx errors
- * - Connection errors
- * - Automatic exponential backoff + retry
- *
- * **Context Overflow (auto-compaction):**
- * - Detected when LLM returns context limit error
- * - Automatic summary generation
- * - Old messages removed, new ones retry
- *
- * **Tool Errors:**
- * - Validation errors (invalid input)
- * - Execution errors (file not found, permission denied)
- * - Timeout errors (bash commands)
- * - Returned as tool results for LLM handling
- *
- * **Configuration Errors:**
- * - No model selected → error on prompt()
- * - No API key → error on prompt()
- * - Extensions disabled → ignored, execution continues
- *
- * ## Performance Considerations
- *
- * - Tool output truncation prevents runaway memory usage
- * - Bash output streamed via callbacks, not buffered
- * - Large output written to temp files for later retrieval
- * - Session messages indexed for fast lookup
- * - Lazy-loading of extensions and hooks
- *
- * ## Security Notes
- *
- * - All bash commands execute in isolated subprocess
- * - No shell injection: using spawn() not shell strings
- * - File operations limited to working directory
- * - Extensions loaded from trusted paths only
- * - User input validated before LLM submission
- *
- * ## Implementation Status
- *
- * Based on: https://github.com/varunisrani/indusagi-ts/vendor/indusagi-agent/src/agent-loop.ts
- * Modifications:
- * - Extended with session persistence layer
- * - Added extension system integration
- * - Added hook system for customization
- * - Added auto-compaction and auto-retry
- * - Added branch summarization
- * - Added command expansion and skill system
- */
-import type { Agent, AgentEvent, AgentMessage, AgentState, AgentTool, ThinkingLevel } from "indusagi/agent";
-import type { ImageContent, Model, TextContent } from "indusagi/ai";
-import type { AppObserveContext } from "./observe.js";
-import { type BashResult } from "./bash-executor.js";
-import { type CompactionResult } from "./context-compression/index.js";
-import { type ContextUsage, type ExtensionCommandContextActions, type ExtensionErrorListener, ExtensionRunner, type ExtensionUIContext, type InputSource, type ShutdownHandler, type ToolDefinition } from "./plugins/index.js";
-import type { CustomMessage } from "./messages.js";
-import type { ModelRegistry } from "./model-registry.js";
-import { type PromptTemplate } from "./prompt-templates.js";
-import type { ResourceLoader } from "./resource-loader.js";
-import type { BranchSummaryEntry, NewSessionOptions, SessionManager } from "./session-manager.js";
-import type { SettingsManager } from "./settings-manager.js";
-import { HookRunner, type HookErrorListener } from "./lifecycle/index.js";
-import type { BashOperations } from "indusagi/agent";
-import { ComposioService, type ComposioAgentTool, type ComposioAgentToolsOptions, type ComposioConnectResult } from "./tooling/index.js";
-import { type Memory } from "./tooling/memory.js";
-import type { ProviderService } from "./providers/provider-service.js";
-/** Parsed skill block from a user message */
-export interface ParsedSkillBlock {
-    name: string;
-    location: string;
-    content: string;
-    userMessage: string | undefined;
-}
-/**
- * Parse a skill block from message text.
- * Returns null if the text doesn't contain a skill block.
- */
-export declare function parseSkillBlock(text: string): ParsedSkillBlock | null;
-/** Session-specific events that extend the core AgentEvent */
-export type AgentSessionEvent = AgentEvent | {
-    type: "auto_compaction_start";
-    reason: "threshold" | "overflow";
-} | {
-    type: "auto_compaction_end";
-    result: CompactionResult | undefined;
-    aborted: boolean;
-    willRetry: boolean;
-    errorMessage?: string;
-} | {
-    type: "auto_retry_start";
-    attempt: number;
-    maxAttempts: number;
-    delayMs: number;
-    errorMessage: string;
-} | {
-    type: "auto_retry_end";
-    success: boolean;
-    attempt: number;
-    finalError?: string;
-} | {
-    type: "session_new";
-    sessionId: string;
-} | {
-    type: "session_branch";
-    targetId: string | null;
-} | {
-    type: "session_compact";
-    summary: string;
-} | {
-    type: "session_retry";
-    attempt: number;
-    maxAttempts: number;
-    errorMessage: string;
-};
-/** Listener function for agent session events */
-export type AgentSessionEventListener = (event: AgentSessionEvent) => void;
-export interface AgentSessionConfig {
-    agent: Agent;
-    sessionManager: SessionManager;
-    settingsManager: SettingsManager;
-    cwd: string;
-    /** Models to cycle through with Ctrl+P (from --models flag) */
-    scopedModels?: Array<{
-        model: Model<any>;
-        thinkingLevel: ThinkingLevel;
-    }>;
-    /** Resource loader for skills, prompts, themes, context files, system prompt */
-    resourceLoader: ResourceLoader;
-    /** SDK custom tools registered outside extensions */
-    customTools?: ToolDefinition[];
-    /** Model registry for API key resolution and model discovery */
-    modelRegistry: ModelRegistry;
-    /** Provider runtime orchestration for adapter-backed providers. */
-    providerService?: ProviderService;
-    /** Agent config directory (used for subagent discovery). */
-    agentDir?: string;
-    /** Initial active built-in tool names. Default: [read, bash, edit, write, task, todoread, todowrite] */
-    initialActiveToolNames?: string[];
-    /** Override base tools (useful for custom runtimes). */
-    baseToolsOverride?: Record<string, AgentTool>;
-    /** Mutable ref used by Agent to access the current ExtensionRunner */
-    extensionRunnerRef?: {
-        current?: ExtensionRunner;
-    };
-    /** Mutable ref used by Agent to access the current HookRunner */
-    hookRunnerRef?: {
-        current?: HookRunner;
-    };
-    /** Optional Observe runtime/client bindings */
-    observe?: AppObserveContext;
-}
-export interface ExtensionBindings {
-    uiContext?: ExtensionUIContext;
-    commandContextActions?: ExtensionCommandContextActions;
-    shutdownHandler?: ShutdownHandler;
-    onError?: ExtensionErrorListener;
-    onHookError?: HookErrorListener;
-}
-/** Options for AgentSession.prompt() */
-export interface PromptOptions {
-    /** Whether to expand file-based prompt templates (default: true) */
-    expandPromptTemplates?: boolean;
-    /** Image attachments */
-    images?: ImageContent[];
-    /** When streaming, how to queue the message: "steer" (interrupt) or "followUp" (wait). Required if streaming. */
-    streamingBehavior?: "steer" | "followUp";
-    /** Source of input for extension input event handlers. Defaults to "interactive". */
-    source?: InputSource;
-}
-/** Result from cycleModel() */
-export interface ModelCycleResult {
-    model: Model<any>;
-    thinkingLevel: ThinkingLevel;
-    /** Whether cycling through scoped models (--models flag) or all available */
-    isScoped: boolean;
-}
-/** Session statistics for /session command */
-export interface SessionStats {
-    sessionFile: string | undefined;
-    sessionId: string;
-    userMessages: number;
-    assistantMessages: number;
-    toolCalls: number;
-    toolResults: number;
-    totalMessages: number;
-    tokens: {
-        input: number;
-        output: number;
-        cacheRead: number;
-        cacheWrite: number;
-        total: number;
-    };
-    cost: number;
-}
-export declare class AgentSession {
-    readonly agent: Agent;
-    readonly sessionManager: SessionManager;
-    readonly settingsManager: SettingsManager;
-    private _scopedModels;
-    private _unsubscribeAgent?;
-    private _eventListeners;
-    /** Tracks pending steering messages for UI display. Removed when delivered. */
-    private _steeringMessages;
-    /** Tracks pending follow-up messages for UI display. Removed when delivered. */
-    private _followUpMessages;
-    /** Messages queued to be included with the next user prompt as context ("asides"). */
-    private _pendingNextTurnMessages;
-    private _compactionAbortController;
-    private _autoCompactionAbortController;
-    private _branchSummaryAbortController;
-    private _retryAbortController;
-    private _retryAttempt;
-    private _retryPromise;
-    private _retryResolve;
-    private _bashAbortController;
-    private _pendingBashMessages;
-    private _extensionRunner;
-    private _hookRunner;
-    private _turnIndex;
-    private _resourceLoader;
-    private _customTools;
-    private _baseToolRegistry;
-    private _cwd;
-    private _extensionRunnerRef?;
-    private _hookRunnerRef?;
-    private _observe?;
-    private _observeAgentEventsUnsubscribe?;
-    private _initialActiveToolNames?;
-    private _baseToolsOverride?;
-    private _extensionUIContext?;
-    private _extensionCommandContextActions?;
-    private _extensionShutdownHandler?;
-    private _extensionErrorListener?;
-    private _extensionErrorUnsubscriber?;
-    private _hookErrorListener?;
-    private _hookErrorUnsubscriber?;
-    private _modelRegistry;
-    private _providerService?;
-    private _todoStore;
-    private _agentDir;
-    private _subagentStore;
-    private _mcpPool;
-    private _mcpTools;
-    private _memory;
-    private _memoryTools;
-    private _memoryThreadId;
-    private _memoryResourceId;
-    private _composioService;
-    private _composioTools;
-    private _toolRegistry;
-    private _baseSystemPrompt;
-    constructor(config: AgentSessionConfig);
-    /** Model registry for API key resolution and model discovery */
-    get modelRegistry(): ModelRegistry;
-    initializeObserve(): Promise<void>;
-    /** Emit an event to all listeners */
-    private _emit;
-    private _wireAgentEventHandlers;
-    private _rebuildRuntimeState;
-    private _rebuildTodoStore;
-    private _getComposioService;
-    private _createComposioToolOptions;
-    private _lastAssistantMessage;
-    private _consumeQueuedUserMessage;
-    private _persistCompletedMessage;
-    private _handlePromptFlow;
-    private _handleRetryFlow;
-    private _handleCompactionFlow;
-    /** Internal handler for agent events - shared by subscribe and reconnect */
-    private _handleAgentEvent;
-    /** Resolve the pending retry promise */
-    private _resolveRetry;
-    private _getObserveSessionSnapshot;
-    private _refreshObserveSession;
-    private _endObserveSession;
-    private _logObserve;
-    private _runObserveOperation;
-    /** Extract text content from a message */
-    private _getUserMessageText;
-    /** Find the last assistant message in agent state (including aborted ones) */
-    private _findLastAssistantMessage;
-    /** Emit extension events based on agent events */
-    private _emitExtensionEvent;
-    /**
-     * Subscribe to agent events.
-     * Session persistence is handled internally (saves messages on message_end).
-     * Multiple listeners can be added. Returns unsubscribe function for this listener.
-     */
-    subscribe(listener: AgentSessionEventListener): () => void;
-    /**
-     * Temporarily disconnect from agent events.
-     * User listeners are preserved and will receive events again after resubscribe().
-     * Used internally during operations that need to pause event processing.
-     */
-    private _disconnectFromAgent;
-    /**
-     * Reconnect to agent events after _disconnectFromAgent().
-     * Preserves all existing listeners.
-     */
-    private _reconnectToAgent;
-    /**
-     * Remove all listeners and disconnect from agent.
-     * Call this when completely done with the session.
-     */
-    dispose(): void;
-    /** Full agent state */
-    get state(): AgentState;
-    /** Current model (may be undefined if not yet selected) */
-    get model(): Model<any> | undefined;
-    /** Current thinking level */
-    get thinkingLevel(): ThinkingLevel;
-    /** Whether agent is currently streaming a response */
-    get isStreaming(): boolean;
-    /** Current retry attempt (0 if not retrying) */
-    get retryAttempt(): number;
-    /**
-     * Get the names of currently active tools.
-     * Returns the names of tools currently set on the agent.
-     */
-    getActiveToolNames(): string[];
-    /**
-     * Get all configured tools with name and description.
-     */
-    getAllTools(): Array<{
-        name: string;
-        description: string;
-    }>;
-    /**
-     * Set active tools by name.
-     * Only tools in the registry can be enabled. Unknown tool names are ignored.
-     * Also rebuilds the system prompt to reflect the new tool set.
-     * Changes take effect on the next agent turn.
-     */
-    setActiveToolsByName(toolNames: string[]): void;
-    /** Whether auto-compaction is currently running */
-    get isCompacting(): boolean;
-    /** All messages including custom types like BashExecutionMessage */
-    get messages(): AgentMessage[];
-    /** Current steering mode */
-    get steeringMode(): "all" | "one-at-a-time";
-    /** Current follow-up mode */
-    get followUpMode(): "all" | "one-at-a-time";
-    /** Current session file path, or undefined if sessions are disabled */
-    get sessionFile(): string | undefined;
-    /** Current session ID */
-    get sessionId(): string;
-    getSessionId(): string;
-    getTree(): import("./session-manager.js").SessionTreeNode[];
-    /** Scoped models for cycling (from --models flag) */
-    get scopedModels(): ReadonlyArray<{
-        model: Model<any>;
-        thinkingLevel: ThinkingLevel;
-    }>;
-    /** Update scoped models for cycling */
-    setScopedModels(scopedModels: Array<{
-        model: Model<any>;
-        thinkingLevel: ThinkingLevel;
-    }>): void;
-    /** File-based prompt templates */
-    get promptTemplates(): ReadonlyArray<PromptTemplate>;
-    private _rebuildSystemPrompt;
-    /**
-     * Send a prompt to the agent.
-     * - Handles extension commands (registered via indusagi.registerCommand) immediately, even during streaming
-     * - Expands file-based prompt templates by default
-     * - During streaming, queues via steer() or followUp() based on streamingBehavior option
-     * - Validates model and API key before sending (when not streaming)
-     * @throws Error if streaming and no streamingBehavior specified
-     * @throws Error if no model selected or no API key available (when not streaming)
-     */
-    prompt(text: string, options?: PromptOptions): Promise<void>;
-    /**
-     * Try to execute an extension command. Returns true if command was found and executed.
-     */
-    private _tryExecuteExtensionCommand;
-    /**
-     * Expand skill commands (/skill:name args) to their full content.
-     * Returns the expanded text, or the original text if not a skill command or skill not found.
-     * Emits errors via extension runner if file read fails.
-     */
-    private _expandSkillCommand;
-    /**
-     * Queue a steering message to interrupt the agent mid-run.
-     * Delivered after current tool execution, skips remaining tools.
-     * Expands skill commands and prompt templates. Errors on extension commands.
-     * @throws Error if text is an extension command
-     */
-    steer(text: string): Promise<void>;
-    /**
-     * Queue a follow-up message to be processed after the agent finishes.
-     * Delivered only when agent has no more tool calls or steering messages.
-     * Expands skill commands and prompt templates. Errors on extension commands.
-     * @throws Error if text is an extension command
-     */
-    followUp(text: string): Promise<void>;
-    /**
-     * Internal: Queue a steering message (already expanded, no extension command check).
-     */
-    private _queueSteer;
-    /**
-     * Internal: Queue a follow-up message (already expanded, no extension command check).
-     */
-    private _queueFollowUp;
-    /**
-     * Throw an error if the text is an extension command.
-     */
-    private _throwIfExtensionCommand;
-    /**
-     * Send a custom message to the session. Creates a CustomMessageEntry.
-     *
-     * Handles three cases:
-     * - Streaming: queues message, processed when loop pulls from queue
-     * - Not streaming + triggerTurn: appends to state/session, starts new turn
-     * - Not streaming + no trigger: appends to state/session, no turn
-     *
-     * @param message Custom message with customType, content, display, details
-     * @param options.triggerTurn If true and not streaming, triggers a new LLM turn
-     * @param options.deliverAs Delivery mode: "steer", "followUp", or "nextTurn"
-     */
-    sendCustomMessage<T = unknown>(message: Pick<CustomMessage<T>, "customType" | "content" | "display" | "details">, options?: {
-        triggerTurn?: boolean;
-        deliverAs?: "steer" | "followUp" | "nextTurn";
-    }): Promise<void>;
-    /**
-     * Send a user message to the agent. Always triggers a turn.
-     * When the agent is streaming, use deliverAs to specify how to queue the message.
-     *
-     * @param content User message content (string or content array)
-     * @param options.deliverAs Delivery mode when streaming: "steer" or "followUp"
-     */
-    sendUserMessage(content: string | (TextContent | ImageContent)[], options?: {
-        deliverAs?: "steer" | "followUp";
-    }): Promise<void>;
-    /**
-     * Clear all queued messages and return them.
-     * Useful for restoring to editor when user aborts.
-     * @returns Object with steering and followUp arrays
-     */
-    clearQueue(): {
-        steering: string[];
-        followUp: string[];
-    };
-    /** Number of pending messages (includes both steering and follow-up) */
-    get pendingMessageCount(): number;
-    /** Get pending steering messages (read-only) */
-    getSteeringMessages(): readonly string[];
-    /** Get pending follow-up messages (read-only) */
-    getFollowUpMessages(): readonly string[];
-    get resourceLoader(): ResourceLoader;
-    /**
-     * Abort current operation and wait for agent to become idle.
-     */
-    abort(): Promise<void>;
-    /**
-     * Start a new session, optionally with initial messages and parent tracking.
-     * Clears all messages and starts a new session.
-     * Listeners are preserved and will continue receiving events.
-     * @param options - Optional initial messages and parent session path
-     * @returns true if completed, false if cancelled by extension
-     */
-    newSession(options?: NewSessionOptions): Promise<boolean>;
-    private _emitModelSelect;
-    /**
-     * Set model directly.
-     * Validates API key, saves to session and settings.
-     * @throws Error if no API key available for the model
-     */
-    setModel(model: Model<any>): Promise<void>;
-    /**
-     * Cycle to next/previous model.
-     * Uses scoped models (from --models flag) if available, otherwise all available models.
-     * @param direction - "forward" (default) or "backward"
-     * @returns The new model info, or undefined if only one model available
-     */
-    cycleModel(direction?: "forward" | "backward"): Promise<ModelCycleResult | undefined>;
-    private _cycleScopedModel;
-    private _cycleAvailableModel;
-    /**
-     * Set thinking level.
-     * Clamps to model capabilities based on available thinking levels.
-     * Saves to session and settings.
-     */
-    setThinkingLevel(level: ThinkingLevel): void;
-    /**
-     * Cycle to next thinking level.
-     * @returns New level, or undefined if model doesn't support thinking
-     */
-    cycleThinkingLevel(): ThinkingLevel | undefined;
-    /**
-     * Get available thinking levels for current model.
-     * The provider will clamp to what the specific model supports internally.
-     */
-    getAvailableThinkingLevels(): ThinkingLevel[];
-    /**
-     * Check if current model supports xhigh thinking level.
-     */
-    supportsXhighThinking(): boolean;
-    /**
-     * Check if current model supports thinking/reasoning.
-     */
-    supportsThinking(): boolean;
-    private _clampThinkingLevel;
-    /**
-     * Set steering message mode.
-     * Saves to settings.
-     */
-    setSteeringMode(mode: "all" | "one-at-a-time"): void;
-    /**
-     * Set follow-up message mode.
-     * Saves to settings.
-     */
-    setFollowUpMode(mode: "all" | "one-at-a-time"): void;
-    /**
-     * Manually compact the session context.
-     * Aborts current agent operation first.
-     * @param customInstructions Optional instructions for the compaction summary
-     */
-    compact(customInstructions?: string): Promise<CompactionResult>;
-    /**
-     * Cancel in-progress compaction (manual or auto).
-     */
-    abortCompaction(): void;
-    /**
-     * Cancel in-progress branch summarization.
-     */
-    abortBranchSummary(): void;
-    /**
-     * Check if compaction is needed and run it.
-     * Called after agent_end and before prompt submission.
-     *
-     * Two cases:
-     * 1. Overflow: LLM returned context overflow error, remove error message from agent state, compact, auto-retry
-     * 2. Threshold: Context over threshold, compact, NO auto-retry (user continues manually)
-     *
-     * @param assistantMessage The assistant message to check
-     * @param skipAbortedCheck If false, include aborted messages (for pre-prompt check). Default: true
-     */
-    private _checkCompaction;
-    /**
-     * Internal: Run auto-compaction with events.
-     */
-    private _runAutoCompaction;
-    /**
-     * Toggle auto-compaction setting.
-     */
-    setAutoCompactionEnabled(enabled: boolean): void;
-    /** Whether auto-compaction is enabled */
-    get autoCompactionEnabled(): boolean;
-    bindExtensions(bindings: ExtensionBindings): Promise<void>;
-    private _applyExtensionBindings;
-    private _applyHookBindings;
-    private _bindExtensionCore;
-    private _buildRuntime;
-    reload(): Promise<void>;
-    /**
-     * Check if an error is retryable (overloaded, rate limit, server errors).
-     * Context overflow errors are NOT retryable (handled by compaction instead).
-     */
-    private _isRetryableError;
-    /**
-     * Handle retryable errors with exponential backoff.
-     * @returns true if retry was initiated, false if max retries exceeded or disabled
-     */
-    private _handleRetryableError;
-    /**
-     * Cancel in-progress retry.
-     */
-    abortRetry(): void;
-    /**
-     * Wait for any in-progress retry to complete.
-     * Returns immediately if no retry is in progress.
-     */
-    private waitForRetry;
-    /** Whether auto-retry is currently in progress */
-    get isRetrying(): boolean;
-    /** Whether auto-retry is enabled */
-    get autoRetryEnabled(): boolean;
-    /**
-     * Toggle auto-retry setting.
-     */
-    setAutoRetryEnabled(enabled: boolean): void;
-    /**
-     * Execute a bash command.
-     * Adds result to agent context and session.
-     * @param command The bash command to execute
-     * @param onChunk Optional streaming callback for output
-     * @param options.excludeFromContext If true, command output won't be sent to LLM (!! prefix)
-     * @param options.operations Custom BashOperations for remote execution
-     */
-    executeBash(command: string, onChunk?: (chunk: string) => void, options?: {
-        excludeFromContext?: boolean;
-        operations?: BashOperations;
-    }): Promise<BashResult>;
-    /**
-     * Record a bash execution result in session history.
-     * Used by executeBash and by extensions that handle bash execution themselves.
-     */
-    recordBashResult(command: string, result: BashResult, options?: {
-        excludeFromContext?: boolean;
-    }): void;
-    /**
-     * Cancel running bash command.
-     */
-    abortBash(): void;
-    /** Whether a bash command is currently running */
-    get isBashRunning(): boolean;
-    /** Whether there are pending bash messages waiting to be flushed */
-    get hasPendingBashMessages(): boolean;
-    /**
-     * Flush pending bash messages to agent state and session.
-     * Called after agent turn completes to maintain proper message ordering.
-     */
-    private _flushPendingBashMessages;
-    /**
-     * Switch to a different session file.
-     * Aborts current operation, loads messages, restores model/thinking.
-     * Listeners are preserved and will continue receiving events.
-     * @returns true if switch completed, false if cancelled by extension
-     */
-    switchSession(sessionPath: string): Promise<boolean>;
-    /**
-     * Create a fork from a specific entry.
-     * Emits before_fork/fork session events to extensions.
-     *
-     * @param entryId ID of the entry to fork from
-     * @returns Object with:
-     *   - selectedText: The text of the selected user message (for editor pre-fill)
-     *   - cancelled: True if an extension cancelled the fork
-     */
-    fork(entryId: string): Promise<{
-        selectedText: string;
-        cancelled: boolean;
-    }>;
-    /**
-     * Navigate to a different node in the session tree.
-     * Unlike fork() which creates a new session file, this stays in the same file.
-     *
-     * @param targetId The entry ID to navigate to
-     * @param options.summarize Whether user wants to summarize abandoned branch
-     * @param options.customInstructions Custom instructions for summarizer
-     * @param options.replaceInstructions If true, customInstructions replaces the default prompt
-     * @param options.label Label to attach to the branch summary entry
-     * @returns Result with editorText (if user message) and cancelled status
-     */
-    navigateTree(targetId: string, options?: {
-        summarize?: boolean;
-        customInstructions?: string;
-        replaceInstructions?: boolean;
-        label?: string;
-    }): Promise<{
-        editorText?: string;
-        cancelled: boolean;
-        aborted?: boolean;
-        summaryEntry?: BranchSummaryEntry;
-    }>;
-    /**
-     * Get all user messages from session for fork selector.
-     */
-    getUserMessagesForForking(): Array<{
-        entryId: string;
-        text: string;
-    }>;
-    private _extractUserMessageText;
-    /**
-     * Get session statistics.
-     */
-    getSessionStats(): SessionStats;
-    getContextUsage(): ContextUsage | undefined;
-    /**
-     * Export session to HTML.
-     * @param outputPath Optional output path (defaults to session directory)
-     * @returns Path to exported file
-     */
-    exportToHtml(outputPath?: string): Promise<string>;
-    /**
-     * Get text content of last assistant message.
-     * Useful for /copy command.
-     * @returns Text content, or undefined if no assistant message exists
-     */
-    getLastAssistantText(): string | undefined;
-    /**
-     * Check if extensions have handlers for a specific event type.
-     */
-    hasExtensionHandlers(eventType: string): boolean;
-    /**
-     * Get the extension runner (for setting UI context and error handlers).
-     */
-    get extensionRunner(): ExtensionRunner | undefined;
-    /**
-     * Register MCP tools with the session.
-     * Called by createAgentSession after MCP servers are connected.
-     * @param tools - MCP tools wrapped as AgentTools
-     * @param pool - MCP client pool for lifecycle management
-     */
-    registerMCPTools(tools: AgentTool[], pool: import("indusagi/mcp").MCPClientPool): void;
-    /**
-     * Get MCP server status.
-     * @returns Status object for each connected server
-     */
-    getMCPStatus(): Promise<import("indusagi/mcp").MCPServerStatus[]>;
-    /**
-     * Get MCP tool names.
-     * @returns Array of MCP tool names
-     */
-    getMCPToolNames(): string[];
-    /**
-     * Get MCP tool definitions for UI rendering.
-     * @returns Array of MCP tools
-     */
-    getMCPTools(): AgentTool[];
-    /**
-     * Disconnect MCP servers.
-     * Should be called during session shutdown.
-     */
-    disconnectMCP(): Promise<void>;
-    /**
-     * Reconnect to MCP servers.
-     * @param configPath - Path to the MCP servers config file
-     * @returns Promise resolving to the number of tools loaded
-     */
-    reconnectMCP(configPath: string): Promise<number>;
-    /**
-     * Register Composio toolkit tools with the session.
-     * These are hydrated native agent tools produced by composio_enable or startup preload.
-     */
-    registerComposioTools(tools: ComposioAgentTool[]): void;
-    /**
-     * Enable Composio toolkit tools for the current session.
-     */
-    enableComposio(options?: ComposioAgentToolsOptions & {
-        persistSettings?: boolean;
-    }): Promise<ComposioAgentTool[]>;
-    /**
-     * Remove hydrated Composio toolkit tools from the current session.
-     */
-    clearComposioTools(options?: {
-        persistSettings?: boolean;
-    }): Promise<void>;
-    getComposioToolNames(): string[];
-    getComposioTools(): ComposioAgentTool[];
-    connectComposio(options: {
-        toolkit?: string;
-        connectedAccountId?: string;
-        authConfigId?: string;
-        callbackUrl?: string;
-    }): Promise<ComposioConnectResult>;
-    listComposioAccounts(filters?: {
-        toolkits?: string[];
-        statuses?: string[];
-        limit?: number;
-        cursor?: string;
-        authConfigIds?: string[];
-    }): Promise<Awaited<ReturnType<ComposioService["listAccounts"]>>>;
-    /**
-     * Register memory tools with the session.
-     * Called by createAgentSession after memory is initialized.
-     * @param tools - Memory tools wrapped as AgentTools
-     * @param memory - Memory instance for context enrichment
-     */
-    registerMemoryTools(tools: AgentTool[], memory: Memory): void;
-    /**
-     * Enable memory for the current and future sessions.
-     * Optionally persists an OpenAI API key before initializing memory.
-     */
-    enableMemory(options?: {
-        apiKey?: string;
-        persistSettings?: boolean;
-    }): Promise<void>;
-    /**
-     * Disable memory for the current and future sessions.
-     */
-    disableMemory(options?: {
-        persistSettings?: boolean;
-    }): Promise<void>;
-    /**
-     * Get the memory instance.
-     * @returns Memory instance or undefined if not enabled
-     */
-    getMemory(): Memory | undefined;
-    /**
-     * Get memory tool names.
-     * @returns Array of memory tool names
-     */
-    getMemoryToolNames(): string[];
-    /**
-     * Get memory tools.
-     * @returns Array of memory tools
-     */
-    getMemoryTools(): AgentTool[];
-    /**
-     * Check if memory is enabled.
-     * @returns True if memory is initialized
-     */
-    isMemoryEnabled(): boolean;
-    /**
-     * Get working memory for the current thread.
-     * @returns Working memory content or undefined
-     */
-    getWorkingMemory(): Promise<string | undefined>;
-    /**
-     * Clear memory for the current thread.
-     */
-    clearMemory(): Promise<void>;
-    /**
-     * Process input through memory (inject working memory + semantic recall).
-     * Called internally before agent.prompt() to enrich context.
-     * @param messages - Messages to process
-     * @returns Processed messages with memory context injected
-     */
-    private _processMemoryInput;
-    /**
-     * Process output through memory (extract observations).
-     * Called internally after turn_end to store conversation in memory.
-     * @param message - The message to process
-     */
-    private _processMemoryOutput;
-}
-//# sourceMappingURL=agent-session.d.ts.map