lemura 1.0.0 → 1.2.0

package/dist/context/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/errors.ts","../../src/context/ContextManager.ts","../../src/context/SandwichCompressionStrategy.ts","../../src/context/HistoryCompressionStrategy.ts","../../src/context/ShortTermMemoryRegistry.ts","../../src/context/InMemoryStorageAdapter.ts"],"names":["randomUUID"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Base class for all custom errors thrown by lemura.\n *\n * @example\n * throw new LemuraError('Something went wrong', 'UNKNOWN_ERROR');\n */\nexport class LemuraError extends Error {\n    /**\n     * @param message - The error message\n     * @param code - The error code for programmatic handling\n     * @param problem - A clear description of the problem for the end user\n     * @param hints - A list of suggestions to resolve the issue\n     */\n    constructor(\n        message: string,\n        public readonly code: string,\n        public readonly problem?: string,\n        public readonly hints: string[] = []\n    ) {\n        super(message);\n        this.name = 'LemuraError';\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/** Error thrown when context exceeds max tokens and cannot be compressed further */\nexport class LemuraContextOverflowError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'CONTEXT_OVERFLOW');\n        this.name = 'LemuraContextOverflowError';\n    }\n}\n\n/** Error thrown when a requested tool is not found in the registry */\nexport class LemuraToolNotFoundError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'TOOL_NOT_FOUND');\n        this.name = 'LemuraToolNotFoundError';\n    }\n}\n\n/** Error thrown when an adapter encounters an API or formatting issue */\nexport class LemuraAdapterError extends LemuraError {\n    constructor(\n        message: string,\n        code = 'ADAPTER_ERROR',\n        public cause?: any,\n        problem?: string,\n        hints: string[] = []\n    ) {\n        super(message, code, problem, hints);\n        this.name = 'LemuraAdapterError';\n    }\n}\n\n/** Error thrown when a skill cannot be parsed or injected */\nexport class LemuraSkillInjectionError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'SKILL_INJECTION_FAILED');\n        this.name = 'LemuraSkillInjectionError';\n    }\n}\n\n/** Error thrown when the ReAct loop exceeds the configured max iterations */\nexport class LemuraMaxIterationsError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'MAX_ITERATIONS_EXCEEDED');\n        this.name = 'LemuraMaxIterationsError';\n    }\n}\n\n/** Error thrown when tool parameters fail JSON schema validation */\nexport class LemuraToolValidationError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'TOOL_VALIDATION_FAILED');\n        this.name = 'LemuraToolValidationError';\n    }\n}\n\n/** Error thrown when a tool execute function exceeds its timeout */\nexport class LemuraToolTimeoutError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'TOOL_TIMEOUT');\n        this.name = 'LemuraToolTimeoutError';\n    }\n}\n","import { ContextWindow, IContextStrategy, LemuraContextOverflowError } from '../types/index.js';\n\n/**\n * Orchestrates a stack of IContextStrategy implementations to keep the\n * token count within the maxTokens limit.\n */\nexport class ContextManager {\n    private strategies: IContextStrategy[] = [];\n\n    /**\n     * Registers a new compression or pre-turn strategy and sorts the stack by priority.\n     *\n     * @param strategy - The strategy implementation to register\n     */\n    registerStrategy(strategy: IContextStrategy): void {\n        this.strategies.push(strategy);\n        this.strategies.sort((a, b) => a.priority - b.priority);\n    }\n\n    /**\n     * Applies all registered strategies that return true for `shouldApply()`\n     * until the context token count is safely below the maximum budget.\n     *\n     * @param context - The context window to prepare\n     * @param safetyMargin - Modifier applied to maxTokens (default: 0.95 -> 95%)\n     * @returns A new ContextWindow object potentially compressed\n     * @throws {LemuraContextOverflowError} If the context is still over maxTokens after all strategies\n     */\n    async prepare(context: ContextWindow, safetyMargin = 0.95): Promise<ContextWindow> {\n        let currentCtx = { ...context, turns: [...context.turns] };\n        const targetTokenCount = currentCtx.maxTokens * safetyMargin;\n\n        for (const strategy of this.strategies) {\n            // If we are below the limit and it's not a pre-turn non-reducing strategy, skip it.\n            // E.g., SummaryInjectionStrategy might still want to run.\n            // But purely compression ones drop out early in our base architecture if they choose in `shouldApply`.\n            if (strategy.shouldApply(currentCtx)) {\n                currentCtx = await strategy.apply(currentCtx);\n            }\n        }\n\n        if (currentCtx.tokenCount > currentCtx.maxTokens) {\n            throw new LemuraContextOverflowError(\n                `Context overflowed: ${currentCtx.tokenCount} tokens > ${currentCtx.maxTokens}`\n            );\n        }\n\n        return currentCtx;\n    }\n}\n","import { ContextWindow, IContextStrategy, IProviderAdapter, Turn } from '../types/index.js';\n\nexport interface SandwichCompressionConfig {\n    preserveFirst: number;\n    preserveLast: number;\n    triggerThreshold: number; // e.g. 0.8\n}\n\n/**\n * Sandwich compression preserves the beginning and end of the conversation,\n * replacing the middle with a generated summary.\n */\nexport class SandwichCompressionStrategy implements IContextStrategy {\n    readonly name = 'sandwich_compression';\n    readonly priority = 20;\n\n    constructor(\n        private adapter: IProviderAdapter,\n        private config: SandwichCompressionConfig\n    ) { }\n\n    shouldApply(ctx: ContextWindow): boolean {\n        return (\n            ctx.tokenCount >= ctx.maxTokens * this.config.triggerThreshold &&\n            ctx.turns.length > this.config.preserveFirst + this.config.preserveLast\n        );\n    }\n\n    async apply(ctx: ContextWindow): Promise<ContextWindow> {\n        const { preserveFirst, preserveLast } = this.config;\n\n        const head = ctx.turns.slice(0, preserveFirst);\n        const tail = ctx.turns.slice(ctx.turns.length - preserveLast);\n        const middle = ctx.turns.slice(preserveFirst, ctx.turns.length - preserveLast);\n\n        const middleText = middle.map(t => `${t.role}: ${JSON.stringify(t.content)}`).join('\\n');\n\n        const summaryResponse = await this.adapter.complete({\n            model: '',\n            messages: [{\n                role: 'user',\n                content: `Summarize the following conversation history briefly:\\n${middleText}`\n            }]\n        });\n\n        const summaryStr = summaryResponse.content;\n\n        const newCompressionSummary = ctx.compressionSummary\n            ? `${ctx.compressionSummary}\\n${summaryStr}`\n            : summaryStr;\n\n        const summaryTurn: Turn = {\n            role: 'system',\n            content: `[COMPRESSED HISTORY SUMMARY]\\n${newCompressionSummary}`,\n            tokenCount: this.adapter.estimateTokens(newCompressionSummary),\n            turnIndex: -1,\n            compressed: true,\n        };\n\n        const newTurns = [...head, summaryTurn, ...tail];\n        const newTokenCount = newTurns.reduce((sum, t) => sum + t.tokenCount, 0) +\n            this.adapter.estimateTokens(ctx.systemPrompt) +\n            this.adapter.estimateTokens(ctx.scratchpad);\n\n        return {\n            ...ctx,\n            turns: newTurns,\n            tokenCount: newTokenCount,\n            compressionSummary: newCompressionSummary,\n        };\n    }\n\n    /**\n     * Applies sandwich compression specifically to a Short Term Memory item's content.\n     * Implements a 3-layer pipeline: Pre-Layer (encoding), Core Layer (dense summary), Post-Layer (refinement cues).\n     * \n     * @param content - The heavy text content to compress\n     * @param instructions - Guiding instructions for the core layer summary\n     * @returns The three-layer sandwich result\n     */\n    async compressMemoryItem(content: string, instructions: string = 'Extract the key information'): Promise<{\n        preLayer: string;\n        coreLayer: string;\n        postLayer: string;\n    }> {\n        // Pre-Layer: Chunking and initial encoding\n        // Here we do a naive encoding representation to signify the pre-processed chunks\n        const estimatedChunks = Math.max(1, Math.ceil(this.adapter.estimateTokens(content) / 2000));\n        const preLayer = `[PRE-LAYER ENCODED: ${estimatedChunks} internal chunks]`;\n\n        // Core Layer: Dense summary sandwich with instructions\n        // We sandwich the content between the instructions to guide extraction\n        // If content is extremely large, we might trim it here, but ideally the provider streaming handles it.\n        const summaryResponse = await this.adapter.complete({\n            model: '',\n            messages: [{\n                role: 'user',\n                content: `### INSTRUCTIONS ###\\n${instructions}\\n\\n### CONTENT ###\\n${content}\\n\\n### INSTRUCTIONS ###\\n${instructions}`\n            }]\n        });\n        const coreLayer = summaryResponse.content;\n\n        // Post-Layer: Decoding/Refinement hooks\n        // Indicates that the LLM can use tools to drill down into specific chunks\n        const postLayer = `[POST-LAYER DECODING: Use \\`refine_layer\\` or \\`read_chunk\\` tools to expand specific sections]`;\n\n        return { preLayer, coreLayer, postLayer };\n    }\n}\n","import { ContextWindow, IContextStrategy, IProviderAdapter, Turn } from '../types/index.js';\n\n/**\n * ScratchpadStrategy manages the thinking process separate from the turn history.\n * It is primarily a marker/pre-turn strategy that ensures scratchpad gets tokenized properly\n * but is not compressed.\n */\nexport class ScratchpadStrategy implements IContextStrategy {\n    readonly name = 'scratchpad_strategy';\n    readonly priority = 10;\n\n    shouldApply(ctx: ContextWindow): boolean {\n        // Only apply if there's actual scratchpad content to track\n        return ctx.scratchpad.length > 0;\n    }\n\n    async apply(ctx: ContextWindow): Promise<ContextWindow> {\n        // Basic implementation: we don't compress the scratchpad, we just ensure its tokens are counted\n        return ctx;\n    }\n}\n\nexport interface HistoryCompressionConfig {\n    windowSize: number;\n    triggerAtPercent: number; // e.g. 0.8\n}\n\n/**\n * Operates on a rolling window of the oldest N turns and summarizes them.\n */\nexport class HistoryCompressionStrategy implements IContextStrategy {\n    readonly name = 'history_compression';\n    readonly priority = 30;\n\n    constructor(\n        private adapter: IProviderAdapter,\n        private config: HistoryCompressionConfig\n    ) { }\n\n    shouldApply(ctx: ContextWindow): boolean {\n        const triggerTokens = ctx.maxTokens * this.config.triggerAtPercent;\n        // Apply if we are over the trigger threshold and have at least enough turns\n        // Ignore system prompts and already compressed turns\n        const uncompressedTurns = ctx.turns.filter(t => t.role !== 'system' && !t.compressed);\n        return ctx.tokenCount >= triggerTokens && uncompressedTurns.length > this.config.windowSize;\n    }\n\n    async apply(ctx: ContextWindow): Promise<ContextWindow> {\n        // Find the oldest N uncompressed turns that aren't the system prompt\n        const uncompressedIndices = ctx.turns\n            .map((t, i) => ({ t, i }))\n            .filter(({ t }) => t.role !== 'system' && !t.compressed)\n            .slice(0, this.config.windowSize);\n\n        const targetTurns = uncompressedIndices.map(u => u.t);\n        const middleText = targetTurns.map(t => `${t.role}: ${JSON.stringify(t.content)}`).join('\\n');\n\n        const summaryResponse = await this.adapter.complete({\n            model: '',\n            messages: [{\n                role: 'user',\n                content: `Summarize the oldest part of this conversation:\\n${middleText}`\n            }]\n        });\n\n        const summaryStr = summaryResponse.content;\n        const newCompressionSummary = ctx.compressionSummary\n            ? `${ctx.compressionSummary}\\n${summaryStr}`\n            : summaryStr;\n\n        // Filter out the summarized turns\n        const indicesToRemove = new Set(uncompressedIndices.map(u => u.i));\n        const newTurns = ctx.turns.filter((_, i) => !indicesToRemove.has(i));\n\n        const TokenCount = newTurns.reduce((sum, t) => sum + t.tokenCount, 0) +\n            this.adapter.estimateTokens(ctx.systemPrompt) +\n            this.adapter.estimateTokens(ctx.scratchpad);\n\n        return {\n            ...ctx,\n            turns: newTurns,\n            tokenCount: TokenCount,\n            compressionSummary: newCompressionSummary,\n        };\n    }\n}\n","import { IStorageAdapter, STMItem } from '../types/index.js';\nimport { randomUUID } from 'crypto';\n\nexport interface STMRegistryConfig {\n    /**\n     * The storage backend to use for Short Term Memory items.\n     */\n    storage: IStorageAdapter;\n\n    /**\n     * The maximum number of tokens allowed for a 'text' type STM item.\n     * If an item exceeds this, it may be rejected or truncated.\n     * Default: 100000\n     */\n    maxTextTokens?: number;\n}\n\n/**\n * Registry for Short Term Memory (STM).\n * Manages the storage and retrieval of large context variables like long texts or blobs.\n * Generates '[STM:uuid]' references to be used within the ReAct agent context.\n */\nexport class ShortTermMemoryRegistry {\n    private storage: IStorageAdapter;\n    private maxTextTokens: number;\n\n    constructor(config: STMRegistryConfig) {\n        this.storage = config.storage;\n        this.maxTextTokens = config.maxTextTokens ?? 100000;\n    }\n\n    /**\n     * Registers a new memory item and returns its reference string.\n     * \n     * @param content - The raw content to store\n     * @param type - The type of content ('text' or 'blob')\n     * @param metadata - Optional metadata (e.g. sandwich layers, original filename)\n     * @param estimateTokens - Optional function to estimate token count for 'text' type\n     * @returns A reference string formatted as '[STM:uuid]'\n     * @throws {Error} if a text item exceeds the maxTextTokens limit\n     */\n    async register(\n        content: any,\n        type: 'text' | 'blob',\n        metadata?: Record<string, unknown>,\n        estimateTokens?: (text: string) => number\n    ): Promise<string> {\n        if (type === 'text') {\n            const tokenCount = estimateTokens ? estimateTokens(content) : Math.ceil(String(content).length / 4);\n            if (tokenCount > this.maxTextTokens) {\n                throw new Error(`Text content exceeds max tokens limit of ${this.maxTextTokens} (estimated ${tokenCount})`);\n            }\n        }\n\n        const id = randomUUID();\n        const item: STMItem = {\n            id,\n            content,\n            type,\n            ...(metadata !== undefined ? { metadata } : {})\n        };\n\n        await this.storage.set(id, item);\n        return `[STM:${id}]`;\n    }\n\n    /**\n     * Updates an existing STM item's content or metadata.\n     * \n     * @param id - The UUID of the item to update\n     * @param updates - Partial updates to apply (content or metadata)\n     */\n    async update(id: string, updates: { content?: any; metadata?: Record<string, unknown> }): Promise<void> {\n        const item = await this.storage.get(id);\n        if (!item) throw new Error(`STM item not found for update: ${id}`);\n\n        const updatedItem: STMItem = {\n            ...item,\n            ...(updates.content !== undefined ? { content: updates.content } : {}),\n            ...(updates.metadata !== undefined ? { metadata: { ...item.metadata, ...updates.metadata } } : {})\n        };\n\n        await this.storage.set(id, updatedItem);\n    }\n\n\n    /**\n     * Retrieves an STM item by its full reference string (e.g., '[STM:uuid]').\n     * \n     * @param ref - The full reference string\n     * @returns The STMItem or undefined if not found\n     */\n    async getByRef(ref: string): Promise<STMItem | undefined> {\n        const match = ref.match(/^\\[STM:(.+)\\]$/);\n        if (!match || !match[1]) return undefined;\n        return this.storage.get(match[1]);\n    }\n\n    /**\n     * Deletes an STM item by its ID.\n     * \n     * @param id - The UUID of the item to delete\n     */\n    async delete(id: string): Promise<void> {\n        await this.storage.delete(id);\n    }\n}\n","import { IStorageAdapter } from '../types/index.js';\nimport { randomUUID } from 'crypto';\n\n/**\n * An in-memory implementation of IStorageAdapter for holding Short Term Memory.\n * Ideal for testing or single-process lightweight usage.\n *\n * @example\n * const storage = new InMemoryStorageAdapter();\n * const id = await storage.set(undefined, 'my content', { type: 'text' });\n * const retrieved = await storage.get(id);\n */\nexport class InMemoryStorageAdapter implements IStorageAdapter {\n    private store = new Map<string, { content: any; metadata?: Record<string, unknown> }>();\n\n    /**\n     * Retrieves stored content by ID.\n     *\n     * @param id - The identifier of the stored item\n     * @returns The stored content or undefined if not found\n     */\n    async get(id: string): Promise<any | undefined> {\n        return this.store.get(id)?.content;\n    }\n\n    /**\n     * Returns the full item including metadata.\n     *\n     * @param id - The identifier of the stored item\n     * @returns The complete item with content and metadata\n     * @internal\n     */\n    async getFull(id: string): Promise<{ content: any; metadata?: Record<string, unknown> } | undefined> {\n        return this.store.get(id);\n    }\n\n    /**\n     * Stores content, generating an ID if none is provided.\n     *\n     * @param id - Optional provided ID. If omitted, a UUID is generated.\n     * @param content - The content to store\n     * @param metadata - Optional metadata\n     * @returns The ID under which the content is stored\n     */\n    async set(id: string | undefined, content: any, metadata?: Record<string, unknown>): Promise<string> {\n        const resolvedId = id ?? randomUUID();\n        this.store.set(resolvedId, metadata !== undefined ? { content, metadata } : { content });\n        return resolvedId;\n    }\n\n    /**\n     * Deletes the content for the given ID.\n     *\n     * @param id - The identifier of the item to delete\n     */\n    async delete(id: string): Promise<void> {\n        this.store.delete(id);\n    }\n\n    /**\n     * Synchronous health check, always true for in-memory.\n     *\n     * @returns true\n     */\n    async healthCheck(): Promise<boolean> {\n        return true;\n    }\n}\n"]}
+{"version":3,"sources":["../../src/types/errors.ts","../../src/context/ContextManager.ts","../../src/context/SandwichCompressionStrategy.ts","../../src/context/HistoryCompressionStrategy.ts","../../src/context/ShortTermMemoryRegistry.ts","../../src/context/InMemoryStorageAdapter.ts"],"names":["randomUUID"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Base class for all custom errors thrown by lemura.\n *\n * @example\n * throw new LemuraError('Something went wrong', 'UNKNOWN_ERROR');\n */\nexport class LemuraError extends Error {\n    /**\n     * @param message - The error message\n     * @param code - The error code for programmatic handling\n     * @param problem - A clear description of the problem for the end user\n     * @param hints - A list of suggestions to resolve the issue\n     */\n    constructor(\n        message: string,\n        public readonly code: string,\n        public readonly problem?: string,\n        public readonly hints: string[] = []\n    ) {\n        super(message);\n        this.name = 'LemuraError';\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n}\n\n/** Error thrown when context exceeds max tokens and cannot be compressed further */\nexport class LemuraContextOverflowError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'CONTEXT_OVERFLOW');\n        this.name = 'LemuraContextOverflowError';\n    }\n}\n\n/** Error thrown when a requested tool is not found in the registry */\nexport class LemuraToolNotFoundError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'TOOL_NOT_FOUND');\n        this.name = 'LemuraToolNotFoundError';\n    }\n}\n\n/** Error thrown when an adapter encounters an API or formatting issue */\nexport class LemuraAdapterError extends LemuraError {\n    constructor(\n        message: string,\n        code = 'ADAPTER_ERROR',\n        public cause?: any,\n        problem?: string,\n        hints: string[] = []\n    ) {\n        super(message, code, problem, hints);\n        this.name = 'LemuraAdapterError';\n    }\n}\n\n/** Error thrown when a skill cannot be parsed or injected */\nexport class LemuraSkillInjectionError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'SKILL_INJECTION_FAILED');\n        this.name = 'LemuraSkillInjectionError';\n    }\n}\n\n/** Error thrown when the ReAct loop exceeds the configured max iterations */\nexport class LemuraMaxIterationsError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'MAX_ITERATIONS_EXCEEDED');\n        this.name = 'LemuraMaxIterationsError';\n    }\n}\n\n/** Error thrown when tool parameters fail JSON schema validation */\nexport class LemuraToolValidationError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'TOOL_VALIDATION_FAILED');\n        this.name = 'LemuraToolValidationError';\n    }\n}\n\n/** Error thrown when a tool execute function exceeds its timeout */\nexport class LemuraToolTimeoutError extends LemuraError {\n    constructor(message: string) {\n        super(message, 'TOOL_TIMEOUT');\n        this.name = 'LemuraToolTimeoutError';\n    }\n}\n\n/** Base error thrown for any MCP server communication failure */\nexport class LemuraMCPError extends LemuraError {\n    constructor(message: string, code = 'MCP_ERROR', problem?: string, hints: string[] = []) {\n        super(message, code, problem, hints);\n        this.name = 'LemuraMCPError';\n    }\n}\n\n/** Error thrown when an MCP server cannot be connected to (spawn failure, network error, init failure) */\nexport class LemuraMCPConnectionError extends LemuraMCPError {\n    constructor(message: string, problem?: string, hints: string[] = []) {\n        super(message, 'MCP_CONNECTION_FAILED', problem, hints);\n        this.name = 'LemuraMCPConnectionError';\n    }\n}\n\n/** Error thrown when a call to an MCP server tool exceeds the configured timeout */\nexport class LemuraMCPTimeoutError extends LemuraMCPError {\n    constructor(message: string) {\n        super(message, 'MCP_TOOL_TIMEOUT');\n        this.name = 'LemuraMCPTimeoutError';\n    }\n}\n","import { ContextWindow, IContextStrategy, LemuraContextOverflowError } from '../types/index.js';\n\n/**\n * Orchestrates a stack of IContextStrategy implementations to keep the\n * token count within the maxTokens limit.\n */\nexport class ContextManager {\n    private strategies: IContextStrategy[] = [];\n\n    /**\n     * Registers a new compression or pre-turn strategy and sorts the stack by priority.\n     *\n     * @param strategy - The strategy implementation to register\n     */\n    registerStrategy(strategy: IContextStrategy): void {\n        this.strategies.push(strategy);\n        this.strategies.sort((a, b) => a.priority - b.priority);\n    }\n\n    /**\n     * Applies all registered strategies that return true for `shouldApply()`\n     * until the context token count is safely below the maximum budget.\n     *\n     * @param context - The context window to prepare\n     * @param safetyMargin - Modifier applied to maxTokens (default: 0.95 -> 95%)\n     * @returns A new ContextWindow object potentially compressed\n     * @throws {LemuraContextOverflowError} If the context is still over maxTokens after all strategies\n     */\n    async prepare(context: ContextWindow, safetyMargin = 0.95): Promise<ContextWindow> {\n        let currentCtx = { ...context, turns: [...context.turns] };\n        const targetTokenCount = currentCtx.maxTokens * safetyMargin;\n\n        for (const strategy of this.strategies) {\n            // If we are below the limit and it's not a pre-turn non-reducing strategy, skip it.\n            // E.g., SummaryInjectionStrategy might still want to run.\n            // But purely compression ones drop out early in our base architecture if they choose in `shouldApply`.\n            if (strategy.shouldApply(currentCtx)) {\n                currentCtx = await strategy.apply(currentCtx);\n            }\n        }\n\n        if (currentCtx.tokenCount > currentCtx.maxTokens) {\n            throw new LemuraContextOverflowError(\n                `Context overflowed: ${currentCtx.tokenCount} tokens > ${currentCtx.maxTokens}`\n            );\n        }\n\n        return currentCtx;\n    }\n}\n","import { ContextWindow, IContextStrategy, IProviderAdapter, Turn } from '../types/index.js';\n\nexport interface SandwichCompressionConfig {\n    preserveFirst: number;\n    preserveLast: number;\n    triggerThreshold: number; // e.g. 0.8\n}\n\n/**\n * Sandwich compression preserves the beginning and end of the conversation,\n * replacing the middle with a generated summary.\n */\nexport class SandwichCompressionStrategy implements IContextStrategy {\n    readonly name = 'sandwich_compression';\n    readonly priority = 20;\n\n    constructor(\n        private adapter: IProviderAdapter,\n        private config: SandwichCompressionConfig\n    ) { }\n\n    shouldApply(ctx: ContextWindow): boolean {\n        return (\n            ctx.tokenCount >= ctx.maxTokens * this.config.triggerThreshold &&\n            ctx.turns.length > this.config.preserveFirst + this.config.preserveLast\n        );\n    }\n\n    async apply(ctx: ContextWindow): Promise<ContextWindow> {\n        const { preserveFirst, preserveLast } = this.config;\n\n        const head = ctx.turns.slice(0, preserveFirst);\n        const tail = ctx.turns.slice(ctx.turns.length - preserveLast);\n        const middle = ctx.turns.slice(preserveFirst, ctx.turns.length - preserveLast);\n\n        const middleText = middle.map(t => `${t.role}: ${JSON.stringify(t.content)}`).join('\\n');\n\n        const summaryResponse = await this.adapter.complete({\n            model: '',\n            messages: [{\n                role: 'user',\n                content: `Summarize the following conversation history briefly:\\n${middleText}`\n            }]\n        });\n\n        const summaryStr = summaryResponse.content;\n\n        const newCompressionSummary = ctx.compressionSummary\n            ? `${ctx.compressionSummary}\\n${summaryStr}`\n            : summaryStr;\n\n        const summaryTurn: Turn = {\n            role: 'system',\n            content: `[COMPRESSED HISTORY SUMMARY]\\n${newCompressionSummary}`,\n            tokenCount: this.adapter.estimateTokens(newCompressionSummary),\n            turnIndex: -1,\n            compressed: true,\n        };\n\n        const newTurns = [...head, summaryTurn, ...tail];\n        const newTokenCount = newTurns.reduce((sum, t) => sum + t.tokenCount, 0) +\n            this.adapter.estimateTokens(ctx.systemPrompt) +\n            this.adapter.estimateTokens(ctx.scratchpad);\n\n        return {\n            ...ctx,\n            turns: newTurns,\n            tokenCount: newTokenCount,\n            compressionSummary: newCompressionSummary,\n        };\n    }\n\n    /**\n     * Applies sandwich compression specifically to a Short Term Memory item's content.\n     * Implements a 3-layer pipeline: Pre-Layer (encoding), Core Layer (dense summary), Post-Layer (refinement cues).\n     * \n     * @param content - The heavy text content to compress\n     * @param instructions - Guiding instructions for the core layer summary\n     * @returns The three-layer sandwich result\n     */\n    async compressMemoryItem(content: string, instructions: string = 'Extract the key information'): Promise<{\n        preLayer: string;\n        coreLayer: string;\n        postLayer: string;\n    }> {\n        // Pre-Layer: Chunking and initial encoding\n        // Here we do a naive encoding representation to signify the pre-processed chunks\n        const estimatedChunks = Math.max(1, Math.ceil(this.adapter.estimateTokens(content) / 2000));\n        const preLayer = `[PRE-LAYER ENCODED: ${estimatedChunks} internal chunks]`;\n\n        // Core Layer: Dense summary sandwich with instructions\n        // We sandwich the content between the instructions to guide extraction\n        // If content is extremely large, we might trim it here, but ideally the provider streaming handles it.\n        const summaryResponse = await this.adapter.complete({\n            model: '',\n            messages: [{\n                role: 'user',\n                content: `### INSTRUCTIONS ###\\n${instructions}\\n\\n### CONTENT ###\\n${content}\\n\\n### INSTRUCTIONS ###\\n${instructions}`\n            }]\n        });\n        const coreLayer = summaryResponse.content;\n\n        // Post-Layer: Decoding/Refinement hooks\n        // Indicates that the LLM can use tools to drill down into specific chunks\n        const postLayer = `[POST-LAYER DECODING: Use \\`refine_layer\\` or \\`read_chunk\\` tools to expand specific sections]`;\n\n        return { preLayer, coreLayer, postLayer };\n    }\n}\n","import { ContextWindow, IContextStrategy, IProviderAdapter, Turn } from '../types/index.js';\n\n/**\n * ScratchpadStrategy manages the thinking process separate from the turn history.\n * It is primarily a marker/pre-turn strategy that ensures scratchpad gets tokenized properly\n * but is not compressed.\n */\nexport class ScratchpadStrategy implements IContextStrategy {\n    readonly name = 'scratchpad_strategy';\n    readonly priority = 10;\n\n    shouldApply(ctx: ContextWindow): boolean {\n        // Only apply if there's actual scratchpad content to track\n        return ctx.scratchpad.length > 0;\n    }\n\n    async apply(ctx: ContextWindow): Promise<ContextWindow> {\n        // Basic implementation: we don't compress the scratchpad, we just ensure its tokens are counted\n        return ctx;\n    }\n}\n\nexport interface HistoryCompressionConfig {\n    windowSize: number;\n    triggerAtPercent: number; // e.g. 0.8\n}\n\n/**\n * Operates on a rolling window of the oldest N turns and summarizes them.\n */\nexport class HistoryCompressionStrategy implements IContextStrategy {\n    readonly name = 'history_compression';\n    readonly priority = 30;\n\n    constructor(\n        private adapter: IProviderAdapter,\n        private config: HistoryCompressionConfig\n    ) { }\n\n    shouldApply(ctx: ContextWindow): boolean {\n        const triggerTokens = ctx.maxTokens * this.config.triggerAtPercent;\n        // Apply if we are over the trigger threshold and have at least enough turns\n        // Ignore system prompts and already compressed turns\n        const uncompressedTurns = ctx.turns.filter(t => t.role !== 'system' && !t.compressed);\n        return ctx.tokenCount >= triggerTokens && uncompressedTurns.length > this.config.windowSize;\n    }\n\n    async apply(ctx: ContextWindow): Promise<ContextWindow> {\n        // Find the oldest N uncompressed turns that aren't the system prompt\n        const uncompressedIndices = ctx.turns\n            .map((t, i) => ({ t, i }))\n            .filter(({ t }) => t.role !== 'system' && !t.compressed)\n            .slice(0, this.config.windowSize);\n\n        const targetTurns = uncompressedIndices.map(u => u.t);\n        const middleText = targetTurns.map(t => `${t.role}: ${JSON.stringify(t.content)}`).join('\\n');\n\n        const summaryResponse = await this.adapter.complete({\n            model: '',\n            messages: [{\n                role: 'user',\n                content: `Summarize the oldest part of this conversation:\\n${middleText}`\n            }]\n        });\n\n        const summaryStr = summaryResponse.content;\n        const newCompressionSummary = ctx.compressionSummary\n            ? `${ctx.compressionSummary}\\n${summaryStr}`\n            : summaryStr;\n\n        // Filter out the summarized turns\n        const indicesToRemove = new Set(uncompressedIndices.map(u => u.i));\n        const newTurns = ctx.turns.filter((_, i) => !indicesToRemove.has(i));\n\n        const TokenCount = newTurns.reduce((sum, t) => sum + t.tokenCount, 0) +\n            this.adapter.estimateTokens(ctx.systemPrompt) +\n            this.adapter.estimateTokens(ctx.scratchpad);\n\n        return {\n            ...ctx,\n            turns: newTurns,\n            tokenCount: TokenCount,\n            compressionSummary: newCompressionSummary,\n        };\n    }\n}\n","import { IStorageAdapter, STMItem } from '../types/index.js';\nimport { randomUUID } from 'crypto';\n\nexport interface STMRegistryConfig {\n    /**\n     * The storage backend to use for Short Term Memory items.\n     */\n    storage: IStorageAdapter;\n\n    /**\n     * The maximum number of tokens allowed for a 'text' type STM item.\n     * If an item exceeds this, it may be rejected or truncated.\n     * Default: 100000\n     */\n    maxTextTokens?: number;\n}\n\n/**\n * Registry for Short Term Memory (STM).\n * Manages the storage and retrieval of large context variables like long texts or blobs.\n * Generates '[STM:uuid]' references to be used within the ReAct agent context.\n */\nexport class ShortTermMemoryRegistry {\n    private storage: IStorageAdapter;\n    private maxTextTokens: number;\n\n    constructor(config: STMRegistryConfig) {\n        this.storage = config.storage;\n        this.maxTextTokens = config.maxTextTokens ?? 100000;\n    }\n\n    /**\n     * Registers a new memory item and returns its reference string.\n     * \n     * @param content - The raw content to store\n     * @param type - The type of content ('text' or 'blob')\n     * @param metadata - Optional metadata (e.g. sandwich layers, original filename)\n     * @param estimateTokens - Optional function to estimate token count for 'text' type\n     * @returns A reference string formatted as '[STM:uuid]'\n     * @throws {Error} if a text item exceeds the maxTextTokens limit\n     */\n    async register(\n        content: any,\n        type: 'text' | 'blob',\n        metadata?: Record<string, unknown>,\n        estimateTokens?: (text: string) => number\n    ): Promise<string> {\n        if (type === 'text') {\n            const tokenCount = estimateTokens ? estimateTokens(content) : Math.ceil(String(content).length / 4);\n            if (tokenCount > this.maxTextTokens) {\n                throw new Error(`Text content exceeds max tokens limit of ${this.maxTextTokens} (estimated ${tokenCount})`);\n            }\n        }\n\n        const id = randomUUID();\n        const item: STMItem = {\n            id,\n            content,\n            type,\n            ...(metadata !== undefined ? { metadata } : {})\n        };\n\n        await this.storage.set(id, item);\n        return `[STM:${id}]`;\n    }\n\n    /**\n     * Updates an existing STM item's content or metadata.\n     * \n     * @param id - The UUID of the item to update\n     * @param updates - Partial updates to apply (content or metadata)\n     */\n    async update(id: string, updates: { content?: any; metadata?: Record<string, unknown> }): Promise<void> {\n        const item = await this.storage.get(id);\n        if (!item) throw new Error(`STM item not found for update: ${id}`);\n\n        const updatedItem: STMItem = {\n            ...item,\n            ...(updates.content !== undefined ? { content: updates.content } : {}),\n            ...(updates.metadata !== undefined ? { metadata: { ...item.metadata, ...updates.metadata } } : {})\n        };\n\n        await this.storage.set(id, updatedItem);\n    }\n\n\n    /**\n     * Retrieves an STM item by its full reference string (e.g., '[STM:uuid]').\n     * \n     * @param ref - The full reference string\n     * @returns The STMItem or undefined if not found\n     */\n    async getByRef(ref: string): Promise<STMItem | undefined> {\n        const match = ref.match(/^\\[STM:(.+)\\]$/);\n        if (!match || !match[1]) return undefined;\n        return this.storage.get(match[1]);\n    }\n\n    /**\n     * Deletes an STM item by its ID.\n     * \n     * @param id - The UUID of the item to delete\n     */\n    async delete(id: string): Promise<void> {\n        await this.storage.delete(id);\n    }\n}\n","import { IStorageAdapter } from '../types/index.js';\nimport { randomUUID } from 'crypto';\n\n/**\n * An in-memory implementation of IStorageAdapter for holding Short Term Memory.\n * Ideal for testing or single-process lightweight usage.\n *\n * @example\n * const storage = new InMemoryStorageAdapter();\n * const id = await storage.set(undefined, 'my content', { type: 'text' });\n * const retrieved = await storage.get(id);\n */\nexport class InMemoryStorageAdapter implements IStorageAdapter {\n    private store = new Map<string, { content: any; metadata?: Record<string, unknown> }>();\n\n    /**\n     * Retrieves stored content by ID.\n     *\n     * @param id - The identifier of the stored item\n     * @returns The stored content or undefined if not found\n     */\n    async get(id: string): Promise<any | undefined> {\n        return this.store.get(id)?.content;\n    }\n\n    /**\n     * Returns the full item including metadata.\n     *\n     * @param id - The identifier of the stored item\n     * @returns The complete item with content and metadata\n     * @internal\n     */\n    async getFull(id: string): Promise<{ content: any; metadata?: Record<string, unknown> } | undefined> {\n        return this.store.get(id);\n    }\n\n    /**\n     * Stores content, generating an ID if none is provided.\n     *\n     * @param id - Optional provided ID. If omitted, a UUID is generated.\n     * @param content - The content to store\n     * @param metadata - Optional metadata\n     * @returns The ID under which the content is stored\n     */\n    async set(id: string | undefined, content: any, metadata?: Record<string, unknown>): Promise<string> {\n        const resolvedId = id ?? randomUUID();\n        this.store.set(resolvedId, metadata !== undefined ? { content, metadata } : { content });\n        return resolvedId;\n    }\n\n    /**\n     * Deletes the content for the given ID.\n     *\n     * @param id - The identifier of the item to delete\n     */\n    async delete(id: string): Promise<void> {\n        this.store.delete(id);\n    }\n\n    /**\n     * Synchronous health check, always true for in-memory.\n     *\n     * @returns true\n     */\n    async healthCheck(): Promise<boolean> {\n        return true;\n    }\n}\n"]}

package/dist/index.d.mts

@@ -1,19 +1,51 @@
-import { C as ContextWindow, T as Turn, a as ContentBlock } from './adapters-BnG0LEYD.mjs';
-export { A as AudioChunk, b as CompletionChunk, c as CompletionRequest, d as CompletionResponse, I as IContextStrategy, e as IProviderAdapter, f as ImageGenRequest, g as ImageGenResponse, M as ModelInfo, N as NormalizedMessage, S as SynthesisRequest, h as TokenUsage, i as ToolCall, j as ToolResult, k as TranscriptionRequest, l as TranscriptionResponse, V as VisionRequest, m as VisionResponse } from './adapters-BnG0LEYD.mjs';
-import { SessionConfig, IToolResponseProcessor, ToolResponseEvaluation } from './types/index.mjs';
-export { LemuraAdapterError, LemuraContextOverflowError, LemuraError, LemuraMaxIterationsError, LemuraSkillInjectionError, LemuraToolNotFoundError, LemuraToolTimeoutError, LemuraToolValidationError } from './types/index.mjs';
-export { I as ILogger, L as LogLevel, a as LogMetadata, S as Severity } from './logger-DxvKliuk.mjs';
+import { a as IProviderAdapter, T as TranscriptionRequest, c as TranscriptionResponse, d as SynthesisRequest, A as AudioChunk, V as VisionRequest, e as VisionResponse, f as ImageGenRequest, g as ImageGenResponse, M as ModelInfo, C as ContextWindow, h as Turn, i as ContentBlock, I as IToolDefinition } from './storage-CG3nTa6o.mjs';
+export { j as CompletionChunk, k as CompletionRequest, l as CompletionResponse, b as IContextStrategy, m as IStorageAdapter, N as NormalizedMessage, n as STMItem, o as STMRegistryConfig, S as ShortTermMemoryRegistry, p as TokenUsage, q as ToolCall, r as ToolContext, s as ToolResult } from './storage-CG3nTa6o.mjs';
+import { S as SessionConfig, I as IToolResponseProcessor, T as ToolResponseEvaluation, M as MCPServerConfig, a as MCPToolDefinition } from './agent-D6uhF-CZ.mjs';
+export { b as MCPJsonRpcRequest, c as MCPJsonRpcResponse, d as MCPTransportType, e as MediaConfig, f as ToolDecision, g as ToolExecutionBudget, h as ToolFirewallConfig, i as ToolFirewallRule, j as TraceEvent } from './agent-D6uhF-CZ.mjs';
+export { LemuraAdapterError, LemuraContextOverflowError, LemuraError, LemuraMCPConnectionError, LemuraMCPError, LemuraMCPTimeoutError, LemuraMaxIterationsError, LemuraSkillInjectionError, LemuraToolNotFoundError, LemuraToolTimeoutError, LemuraToolValidationError } from './types/index.mjs';
+import { I as ILogger } from './logger-DxvKliuk.mjs';
+export { L as LogLevel, a as LogMetadata, S as Severity } from './logger-DxvKliuk.mjs';
 export { I as IRAGAdapter, R as RAGDocument, a as RAGIngestOptions, b as RAGIngestRequest, c as RAGIngestResponse, d as RAGQueryRequest, e as RAGQueryResponse, f as RAGResult } from './rag-La_Bo-J8.mjs';
 export { I as ISkill } from './skills-wc8S-OvC.mjs';
-import { I as IToolDefinition } from './storage-DMcliVVj.mjs';
-export { a as IStorageAdapter, S as STMItem, b as STMRegistryConfig, c as ShortTermMemoryRegistry, T as ToolContext } from './storage-DMcliVVj.mjs';
 export { OpenAICompatibleAdapter, OpenAICompatibleAdapterConfig, RetryConfig } from './adapters/index.mjs';
 export { ContextManager, HistoryCompressionConfig, HistoryCompressionStrategy, InMemoryStorageAdapter, SandwichCompressionConfig, SandwichCompressionStrategy, ScratchpadStrategy } from './context/index.mjs';
-export { ToolRegistry } from './tools/index.mjs';
+export { SchemaValidationError, ToolFirewallResult, ToolRegistry, ToolRegistryOptions, evaluateToolFirewall, validateJsonSchema } from './tools/index.mjs';
 export { SkillInjector } from './skills/index.mjs';
 export { InMemoryRAGAdapter } from './rag/index.mjs';
 export { DefaultLogger } from './logger/index.mjs';
 
+/**
+ * MediaBridge provides a single, app-friendly entry point for audio/vision/image features.
+ */
+declare class MediaBridge {
+    private adapter;
+    constructor(adapter: IProviderAdapter);
+    transcribe(request: TranscriptionRequest): Promise<TranscriptionResponse>;
+    synthesize(request: SynthesisRequest): AsyncIterable<AudioChunk>;
+    synthesizeToArray(request: SynthesisRequest): Promise<AudioChunk[]>;
+    describeImage(request: VisionRequest): Promise<VisionResponse>;
+    generateImage(request: ImageGenRequest): Promise<ImageGenResponse>;
+    getModelInfo(): ModelInfo;
+    supportsVision(): boolean;
+}
+
+/**
+ * Core entry point for lemura agent sessions.
+ *
+ * `SessionManager` owns the full ReAct loop lifecycle:
+ * - Context window management and compression
+ * - Skill injection
+ * - Tool firewall + schema validation + timeout enforcement
+ * - Parallel tool execution (opt-in via `parallelToolCalls`)
+ * - maxSteps guard → forced graceful conclusion
+ * - Tool response compression (via `toolResponseProcessor`)
+ * - Goal injection (via `enableGoalPlanning`)
+ * - Streaming output (`stream()`)
+ *
+ * @example
+ * const session = new SessionManager({ adapter, model: 'gpt-4o', maxTokens: 16_000 });
+ * const answer = await session.run('What is the capital of France?');
+ */
 declare class SessionManager {
     private contextManager;
     private toolRegistry;
@@ -23,10 +55,97 @@ declare class SessionManager {
     private config;
     private iterations;
     private logger;
+    private media;
+    private stepCounter;
+    private toolResponseProcessor;
+    private goalInjector;
+    private continuationPlanner;
+    private mcpRegistry;
+    /** Resolves when all MCP servers are connected; used by run() and stream() */
+    private mcpReady;
+    private totalToolCallCount;
+    private perToolCallCount;
+    private totalTokens;
     constructor(config: SessionConfig);
+    private emitTrace;
+    /**
+     * Returns a shallow copy of the current context window.
+     */
     getContext(): ContextWindow;
+    /**
+     * Returns the current conversation history.
+     */
     getHistory(): Turn[];
+    /**
+     * Returns the `MediaBridge` for direct ASR / TTS / Vision / Image-gen calls.
+     */
+    getMedia(): MediaBridge;
+    /**
+     * Connects all configured MCP servers and registers their bridged tools.
+     * Called from the constructor as a fire-and-start async task; `run()` and
+     * `stream()` await `this.mcpReady` before executing.
+     */
+    private _initMCP;
+    /** Builds the system prompt, injecting skills and goal if configured. */
+    private buildSystemPrompt;
+    /** Builds the messages array for the provider from the current context */
+    private buildMessages;
+    /** Checks the tool execution budget and throws descriptively if exceeded */
+    private checkExecutionBudget;
+    /** Records a tool call in budget counters */
+    private recordToolCall;
+    /**
+     * Processes a firewall decision for a tool call.
+     * Returns true to proceed, false to block.
+     */
+    private passesFirewall;
+    /**
+     * Executes a single parsed tool call and returns the serialised result string.
+     */
+    private executeSingleToolCall;
+    /**
+     * Runs the full ReAct loop for a user message and returns the final assistant response.
+     *
+     * @param userMessage - The user's message (string or multimodal content blocks)
+     * @returns The assistant's final response string
+     * @throws {LemuraMaxIterationsError} When the loop exceeds `maxIterations`
+     */
     run(userMessage: string | ContentBlock[]): Promise<string>;
+    /**
+     * Runs the ReAct loop and streams the final assistant response token-by-token.
+     *
+     * Tool calls within the loop are still executed synchronously (they must complete
+     * before streaming the conclusion). Only the final LLM text output is streamed.
+     *
+     * @param userMessage - The user's message (string or multimodal content blocks)
+     * @returns An `AsyncIterable<string>` of delta tokens from the final response
+     *
+     * @example
+     * for await (const token of session.stream('Tell me a story')) {
+     *   process.stdout.write(token);
+     * }
+     */
+    stream(userMessage: string | ContentBlock[]): AsyncIterable<string>;
+    /**
+     * Resets the session: clears conversation history, resets iteration counters,
+     * and resets tool execution budgets. The adapter, config, and tools are retained.
+     */
+    reset(): void;
+    /**
+     * Closes the session and disconnects all MCP servers.
+     *
+     * Call this when you are done with the session and have registered MCP servers,
+     * to ensure child processes are terminated and HTTP connections are released.
+     *
+     * @example
+     * const session = new SessionManager({ ..., mcpServers: [...] });
+     * try {
+     *   await session.run('Hello');
+     * } finally {
+     *   await session.close();
+     * }
+     */
+    close(): Promise<void>;
 }
 
 /**
@@ -51,6 +170,7 @@ declare class GoalInjector {
     private goal;
     constructor(goal: Goal);
     injectInto(prompt: string): string;
+    getGoal(): Goal;
 }
 
 interface ContinuationStep {
@@ -88,4 +208,132 @@ declare class FinalResponseFormatter {
     static validateStructure(response: string): boolean;
 }
 
-export { ContentBlock, ContextWindow, type ContinuationPlan, ContinuationPlanner, type ContinuationStep, FinalResponseFormatter, type Goal, GoalInjector, IToolDefinition, IToolResponseProcessor, SessionConfig, SessionManager, StepCounter, ToolResponseEvaluation, ToolResponseProcessor, Turn };
+/**
+ * Low-level MCP server client.
+ *
+ * Supports two transports:
+ * - **stdio** — spawns a child process and communicates over stdin/stdout via newline-delimited JSON-RPC 2.0
+ * - **http** — sends JSON-RPC 2.0 `POST` requests using native `fetch` (Node >= 18 required)
+ *
+ * Lifecycle:
+ * 1. `connect()` — initialize the server and fetch its tool list
+ * 2. `callTool()` — invoke a tool by name
+ * 3. `disconnect()` — terminate the connection / child process
+ *
+ * @example
+ * const client = new MCPClient('github', {
+ *   name: 'github',
+ *   transport: 'stdio',
+ *   command: 'npx',
+ *   args: ['@modelcontextprotocol/server-github'],
+ *   env: { GITHUB_TOKEN: '...' }
+ * }, logger);
+ *
+ * await client.connect();
+ * const result = await client.callTool('create_issue', { title: 'bug' });
+ * await client.disconnect();
+ */
+declare class MCPClient {
+    private readonly config;
+    private readonly logger;
+    private readonly _serverName;
+    private readonly timeoutMs;
+    private _tools;
+    private _connected;
+    private process;
+    private pendingCallbacks;
+    private requestId;
+    private stdioBuffer;
+    constructor(name: string, config: MCPServerConfig, logger: ILogger);
+    get serverName(): string;
+    get tools(): MCPToolDefinition[];
+    get isConnected(): boolean;
+    /**
+     * Connects to the MCP server: sends `initialize` + `notifications/initialized`,
+     * then fetches the tool list via `tools/list`.
+     */
+    connect(): Promise<void>;
+    /**
+     * Calls a tool on this MCP server.
+     *
+     * @param toolName - The tool name as declared by the server
+     * @param args - Tool arguments (must match the tool's inputSchema)
+     * @returns The serialised result from the server
+     */
+    callTool(toolName: string, args: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Disconnects from the MCP server.
+     * For stdio: sends the `exit` notification then terminates the process.
+     */
+    disconnect(): Promise<void>;
+    private _connectStdio;
+    /** Parses newline-delimited JSON messages from the stdio buffer */
+    private _flushStdioBuffer;
+    private _nextId;
+    /** Sends a JSON-RPC request and returns the response, honouring the configured timeout. */
+    private _rpc;
+    private _rpcStdio;
+    private _rpcHttp;
+    /** Sends `initialize` then `notifications/initialized` per MCP spec */
+    private _initialize;
+    /** Fetches and caches the tool list from the server */
+    private _discoverTools;
+    private _assertNoError;
+}
+
+/**
+ * Manages the full lifecycle of multiple MCP server connections and routes
+ * tool calls to the correct server.
+ *
+ * Typical usage is handled automatically by `SessionManager` when `mcpServers`
+ * is set in `SessionConfig`. You can also use it standalone for advanced scenarios.
+ *
+ * @example
+ * const registry = new MCPClientRegistry(logger);
+ * await registry.register('github', { transport: 'stdio', command: 'npx', args: ['...'] });
+ * const tools = await registry.discoverTools(); // IToolDefinition[] ready for ToolRegistry
+ */
+declare class MCPClientRegistry {
+    private readonly clients;
+    /** toolName → serverName  */
+    private readonly toolRouter;
+    private readonly logger;
+    constructor(logger: ILogger);
+    /**
+     * Creates an `MCPClient` for the given config, connects to the server, and
+     * registers the server by name.
+     *
+     * @throws {LemuraMCPConnectionError} if connection / initialization fails
+     */
+    register(name: string, config: MCPServerConfig): Promise<void>;
+    /**
+     * Collects tools from all connected MCP servers and returns them as
+     * `IToolDefinition` adapters ready to be registered in `ToolRegistry`.
+     *
+     * Tool names are **not** namespaced — if two servers expose a tool with the
+     * same name, the last-registered server wins and a warning is emitted.
+     */
+    discoverTools(): Promise<IToolDefinition[]>;
+    /**
+     * Calls a tool on the correct MCP server.
+     *
+     * @param toolName - The tool name as registered via `discoverTools()`
+     * @param args - Parsed arguments object
+     * @throws {LemuraMCPConnectionError} if no server is registered for `toolName`
+     */
+    callTool(toolName: string, args: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Disconnects all registered MCP servers gracefully.
+     * Called automatically by `SessionManager.close()`.
+     */
+    disconnectAll(): Promise<void>;
+    /** Returns the names of all currently registered servers */
+    getRegisteredServers(): string[];
+    /**
+     * Bridges an `MCPToolDefinition` from the protocol into an `IToolDefinition`
+     * that the existing `ToolRegistry` can execute.
+     */
+    private _bridge;
+}
+
+export { AudioChunk, ContentBlock, ContextWindow, type ContinuationPlan, ContinuationPlanner, type ContinuationStep, FinalResponseFormatter, type Goal, GoalInjector, ILogger, IProviderAdapter, IToolDefinition, IToolResponseProcessor, ImageGenRequest, ImageGenResponse, MCPClient, MCPClientRegistry, MCPServerConfig, MCPToolDefinition, MediaBridge, ModelInfo, SessionConfig, SessionManager, StepCounter, SynthesisRequest, ToolResponseEvaluation, ToolResponseProcessor, TranscriptionRequest, TranscriptionResponse, Turn, VisionRequest, VisionResponse };