lemura 1.0.0 → 1.2.0

package/dist/agent-D6uhF-CZ.d.mts

@@ -0,0 +1,248 @@
+import { I as IToolDefinition, a as IProviderAdapter, b as IContextStrategy, S as ShortTermMemoryRegistry } from './storage-CG3nTa6o.mjs';
+import { I as ILogger } from './logger-DxvKliuk.mjs';
+import { I as ISkill } from './skills-wc8S-OvC.mjs';
+import { I as IRAGAdapter } from './rag-La_Bo-J8.mjs';
+
+/**
+ * MCP (Model Context Protocol) transport and configuration types for lemura.
+ */
+/** Supported MCP server transport modes */
+type MCPTransportType = 'stdio' | 'http' | 'sse';
+/**
+ * Configuration for a single MCP server connection.
+ *
+ * @example
+ * // stdio server
+ * const config: MCPServerConfig = {
+ *   name: 'my_server',
+ *   transport: 'stdio',
+ *   command: 'npx',
+ *   args: ['@modelcontextprotocol/server-github'],
+ *   env: { GITHUB_TOKEN: process.env.GITHUB_TOKEN! }
+ * };
+ *
+ * @example
+ * // HTTP server
+ * const config: MCPServerConfig = {
+ *   name: 'remote_tools',
+ *   transport: 'http',
+ *   url: 'http://localhost:3001'
+ * };
+ */
+interface MCPServerConfig {
+    /** Unique name for this server (used to namespace tools) */
+    name: string;
+    /** Transport mechanism to communicate with the server */
+    transport: MCPTransportType;
+    /**
+     * For `stdio`: the executable to spawn (e.g. `'npx'`, `'python'`).
+     * For `http`/`sse`: leave undefined — use `url` instead.
+     */
+    command?: string;
+    /**
+     * For `stdio`: additional arguments passed to the spawned command.
+     * @example ['@modelcontextprotocol/server-github']
+     */
+    args?: string[];
+    /**
+     * For `http`/`sse`: base URL of the MCP server.
+     * @example 'http://localhost:3001'
+     */
+    url?: string;
+    /**
+     * Environment variables injected into the spawned process (stdio only).
+     * Runtime env variables can be referenced before passing, e.g.:
+     * `{ GITHUB_TOKEN: process.env.GITHUB_TOKEN! }`
+     */
+    env?: Record<string, string>;
+    /**
+     * Per-call timeout in milliseconds. Defaults to `30_000`.
+     */
+    timeoutMs?: number;
+}
+/**
+ * A tool definition as returned by an MCP server's `tools/list` response.
+ * @internal Used by `MCPClient`; developers interact with `IToolDefinition` instead.
+ */
+interface MCPToolDefinition {
+    /** Tool name as declared by the MCP server */
+    name: string;
+    /** Human-readable description of what the tool does */
+    description: string;
+    /** JSON Schema for the tool's input parameters */
+    inputSchema: Record<string, unknown>;
+}
+/**
+ * Raw JSON-RPC 2.0 request envelope sent to an MCP server.
+ * @internal
+ */
+interface MCPJsonRpcRequest {
+    jsonrpc: '2.0';
+    id: number | string;
+    method: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * Raw JSON-RPC 2.0 response envelope received from an MCP server.
+ * @internal
+ */
+interface MCPJsonRpcResponse {
+    jsonrpc: '2.0';
+    id: number | string;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+
+interface ToolResponseEvaluation {
+    relevanceScore: number;
+    sizeClass: 'small' | 'medium' | 'large' | 'oversized';
+    shouldCompress: boolean;
+    suggestedMaxTokens: number;
+    answered: boolean;
+    answeredPartially: boolean;
+    errorDetected: boolean;
+    suggestedAction: 'continue' | 'retry' | 'retry_with_params' | 'skip' | 'escalate';
+}
+interface IToolResponseProcessor {
+    evaluate(response: string, tool: IToolDefinition, context: unknown): ToolResponseEvaluation;
+    compress(response: string, evaluation: ToolResponseEvaluation): string;
+}
+interface MediaConfig {
+    enableTools?: boolean;
+    toolPrefix?: string;
+}
+type ToolDecision = 'accept' | 'deny' | 'ask';
+interface ToolFirewallRule {
+    /** Regex pattern matched against the tool name */
+    name?: string;
+    /** Regex pattern matched against the serialised arguments JSON */
+    arguments?: string;
+    /** Decision to apply when this rule matches */
+    decision: ToolDecision;
+    /** Human-readable reason surfaced to the agent when blocked */
+    reason?: string;
+}
+interface ToolFirewallConfig {
+    /** Decision applied when no rule matches. Defaults to 'ask'. */
+    defaultDecision?: ToolDecision;
+    /** Ordered list of firewall rules — first match wins */
+    rules?: ToolFirewallRule[];
+    /**
+     * Called when a tool hits the 'ask' decision.
+     * Return 'accept' or 'deny'. If omitted, 'ask' behaves like 'deny'.
+     */
+    onAsk?: (toolName: string, argsJson: string) => Promise<'accept' | 'deny'> | 'accept' | 'deny';
+}
+/**
+ * Execution budget constraints for tool calls within a session.
+ *
+ * @example
+ * toolExecutionBudget: {
+ *   maxCallsPerSession: 50,
+ *   maxCallsPerTool: { search_web: 10 },
+ *   maxConcurrentCalls: 4,
+ * }
+ */
+interface ToolExecutionBudget {
+    /** Maximum total tool calls allowed for the entire session */
+    maxCallsPerSession?: number;
+    /** Maximum calls per named tool within the session */
+    maxCallsPerTool?: Record<string, number>;
+    /** Maximum simultaneous parallel tool executions (default: unlimited) */
+    maxConcurrentCalls?: number;
+}
+/** Configuration for a lemura Session */
+interface SessionConfig {
+    /** The provider adapter to use */
+    adapter: IProviderAdapter;
+    /** Model string */
+    model: string;
+    /** Max context tokens */
+    maxTokens: number;
+    /** Max ReAct cycles */
+    maxIterations?: number;
+    /** Explicit tools */
+    tools?: IToolDefinition[];
+    /** Explicit skills */
+    skills?: ISkill[];
+    /** RAG adapter */
+    ragAdapter?: IRAGAdapter;
+    /** Context compression strategies */
+    compressionStrategies?: IContextStrategy[];
+    /** System prompt base */
+    systemPrompt?: string;
+    /** Logger */
+    logger?: ILogger;
+    /** Media bridge config */
+    media?: MediaConfig;
+    /** Tool firewall config */
+    toolFirewall?: ToolFirewallConfig;
+    /** Budget for tool responses before compression */
+    toolResponseTokenBudget?: number;
+    /** Processor for tool responses */
+    toolResponseProcessor?: IToolResponseProcessor;
+    /** Max single steps (tool calls) */
+    maxSteps?: number;
+    /** Enable tool continuation planning */
+    enableContinuationPlanning?: boolean;
+    continuationStrategy?: 'sequential' | 'parallel' | 'conditional';
+    /** Enable goal planning */
+    enableGoalPlanning?: boolean;
+    goalInjectionFrequency?: 'always' | 'every_N_turns' | 'on_compression';
+    goalInjectionPosition?: 'system_prompt' | 'pre_turn';
+    /** Skill budget */
+    skillTokenBudget?: number;
+    /** Callback for each turn in the session */
+    onTurn?: (turn: any) => void;
+    /** Short Term Memory Registry */
+    stmRegistry?: ShortTermMemoryRegistry;
+    /** Max tokens allowed for a single tool response */
+    maxTokensPerTool?: number;
+    /**
+     * Execution budget constraints: call quotas and concurrency cap.
+     * Enforced in the ReAct loop before each tool call.
+     */
+    toolExecutionBudget?: ToolExecutionBudget;
+    /**
+     * When true, independent tool calls within a single assistant response are
+     * executed in parallel using `Promise.all`. Defaults to false (sequential).
+     */
+    parallelToolCalls?: boolean;
+    /**
+     * Default timeout in ms for each tool execution.
+     * Passed to `ToolRegistry`. Defaults to 30 000.
+     */
+    toolRegistryTimeoutMs?: number;
+    /** Callback for granular trace events (planning, budgets, tools, etc.) */
+    onTrace?: (event: TraceEvent) => void;
+    /**
+     * MCP (Model Context Protocol) server configurations.
+     * Each server is connected at session construction, its tools are discovered
+     * and registered alongside native tools — fully transparent to the ReAct loop.
+     *
+     * @example
+     * mcpServers: [
+     *   { name: 'github', transport: 'stdio', command: 'npx', args: ['@modelcontextprotocol/server-github'] },
+     *   { name: 'db_tools', transport: 'http', url: 'http://localhost:3001' }
+     * ]
+     */
+    mcpServers?: MCPServerConfig[];
+}
+/** Rich trace event for observability */
+interface TraceEvent {
+    sessionId?: string;
+    type: 'planning' | 'budget' | 'tool_call' | 'tool_result' | 'thinking' | 'system' | 'compression' | 'error';
+    name: string;
+    input?: any;
+    output?: any;
+    durationMs?: number;
+    startedAt?: number;
+    status?: 'running' | 'done' | 'error';
+    metadata?: Record<string, any>;
+}
+
+export type { IToolResponseProcessor as I, MCPServerConfig as M, SessionConfig as S, ToolResponseEvaluation as T, MCPToolDefinition as a, MCPJsonRpcRequest as b, MCPJsonRpcResponse as c, MCPTransportType as d, MediaConfig as e, ToolDecision as f, ToolExecutionBudget as g, ToolFirewallConfig as h, ToolFirewallRule as i, TraceEvent as j };

package/dist/agent-DxRd93wl.d.ts

@@ -0,0 +1,248 @@
+import { I as IToolDefinition, a as IProviderAdapter, b as IContextStrategy, S as ShortTermMemoryRegistry } from './storage-DBt_q0wO.js';
+import { I as ILogger } from './logger-DxvKliuk.js';
+import { I as ISkill } from './skills-wc8S-OvC.js';
+import { I as IRAGAdapter } from './rag-La_Bo-J8.js';
+
+/**
+ * MCP (Model Context Protocol) transport and configuration types for lemura.
+ */
+/** Supported MCP server transport modes */
+type MCPTransportType = 'stdio' | 'http' | 'sse';
+/**
+ * Configuration for a single MCP server connection.
+ *
+ * @example
+ * // stdio server
+ * const config: MCPServerConfig = {
+ *   name: 'my_server',
+ *   transport: 'stdio',
+ *   command: 'npx',
+ *   args: ['@modelcontextprotocol/server-github'],
+ *   env: { GITHUB_TOKEN: process.env.GITHUB_TOKEN! }
+ * };
+ *
+ * @example
+ * // HTTP server
+ * const config: MCPServerConfig = {
+ *   name: 'remote_tools',
+ *   transport: 'http',
+ *   url: 'http://localhost:3001'
+ * };
+ */
+interface MCPServerConfig {
+    /** Unique name for this server (used to namespace tools) */
+    name: string;
+    /** Transport mechanism to communicate with the server */
+    transport: MCPTransportType;
+    /**
+     * For `stdio`: the executable to spawn (e.g. `'npx'`, `'python'`).
+     * For `http`/`sse`: leave undefined — use `url` instead.
+     */
+    command?: string;
+    /**
+     * For `stdio`: additional arguments passed to the spawned command.
+     * @example ['@modelcontextprotocol/server-github']
+     */
+    args?: string[];
+    /**
+     * For `http`/`sse`: base URL of the MCP server.
+     * @example 'http://localhost:3001'
+     */
+    url?: string;
+    /**
+     * Environment variables injected into the spawned process (stdio only).
+     * Runtime env variables can be referenced before passing, e.g.:
+     * `{ GITHUB_TOKEN: process.env.GITHUB_TOKEN! }`
+     */
+    env?: Record<string, string>;
+    /**
+     * Per-call timeout in milliseconds. Defaults to `30_000`.
+     */
+    timeoutMs?: number;
+}
+/**
+ * A tool definition as returned by an MCP server's `tools/list` response.
+ * @internal Used by `MCPClient`; developers interact with `IToolDefinition` instead.
+ */
+interface MCPToolDefinition {
+    /** Tool name as declared by the MCP server */
+    name: string;
+    /** Human-readable description of what the tool does */
+    description: string;
+    /** JSON Schema for the tool's input parameters */
+    inputSchema: Record<string, unknown>;
+}
+/**
+ * Raw JSON-RPC 2.0 request envelope sent to an MCP server.
+ * @internal
+ */
+interface MCPJsonRpcRequest {
+    jsonrpc: '2.0';
+    id: number | string;
+    method: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * Raw JSON-RPC 2.0 response envelope received from an MCP server.
+ * @internal
+ */
+interface MCPJsonRpcResponse {
+    jsonrpc: '2.0';
+    id: number | string;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+
+interface ToolResponseEvaluation {
+    relevanceScore: number;
+    sizeClass: 'small' | 'medium' | 'large' | 'oversized';
+    shouldCompress: boolean;
+    suggestedMaxTokens: number;
+    answered: boolean;
+    answeredPartially: boolean;
+    errorDetected: boolean;
+    suggestedAction: 'continue' | 'retry' | 'retry_with_params' | 'skip' | 'escalate';
+}
+interface IToolResponseProcessor {
+    evaluate(response: string, tool: IToolDefinition, context: unknown): ToolResponseEvaluation;
+    compress(response: string, evaluation: ToolResponseEvaluation): string;
+}
+interface MediaConfig {
+    enableTools?: boolean;
+    toolPrefix?: string;
+}
+type ToolDecision = 'accept' | 'deny' | 'ask';
+interface ToolFirewallRule {
+    /** Regex pattern matched against the tool name */
+    name?: string;
+    /** Regex pattern matched against the serialised arguments JSON */
+    arguments?: string;
+    /** Decision to apply when this rule matches */
+    decision: ToolDecision;
+    /** Human-readable reason surfaced to the agent when blocked */
+    reason?: string;
+}
+interface ToolFirewallConfig {
+    /** Decision applied when no rule matches. Defaults to 'ask'. */
+    defaultDecision?: ToolDecision;
+    /** Ordered list of firewall rules — first match wins */
+    rules?: ToolFirewallRule[];
+    /**
+     * Called when a tool hits the 'ask' decision.
+     * Return 'accept' or 'deny'. If omitted, 'ask' behaves like 'deny'.
+     */
+    onAsk?: (toolName: string, argsJson: string) => Promise<'accept' | 'deny'> | 'accept' | 'deny';
+}
+/**
+ * Execution budget constraints for tool calls within a session.
+ *
+ * @example
+ * toolExecutionBudget: {
+ *   maxCallsPerSession: 50,
+ *   maxCallsPerTool: { search_web: 10 },
+ *   maxConcurrentCalls: 4,
+ * }
+ */
+interface ToolExecutionBudget {
+    /** Maximum total tool calls allowed for the entire session */
+    maxCallsPerSession?: number;
+    /** Maximum calls per named tool within the session */
+    maxCallsPerTool?: Record<string, number>;
+    /** Maximum simultaneous parallel tool executions (default: unlimited) */
+    maxConcurrentCalls?: number;
+}
+/** Configuration for a lemura Session */
+interface SessionConfig {
+    /** The provider adapter to use */
+    adapter: IProviderAdapter;
+    /** Model string */
+    model: string;
+    /** Max context tokens */
+    maxTokens: number;
+    /** Max ReAct cycles */
+    maxIterations?: number;
+    /** Explicit tools */
+    tools?: IToolDefinition[];
+    /** Explicit skills */
+    skills?: ISkill[];
+    /** RAG adapter */
+    ragAdapter?: IRAGAdapter;
+    /** Context compression strategies */
+    compressionStrategies?: IContextStrategy[];
+    /** System prompt base */
+    systemPrompt?: string;
+    /** Logger */
+    logger?: ILogger;
+    /** Media bridge config */
+    media?: MediaConfig;
+    /** Tool firewall config */
+    toolFirewall?: ToolFirewallConfig;
+    /** Budget for tool responses before compression */
+    toolResponseTokenBudget?: number;
+    /** Processor for tool responses */
+    toolResponseProcessor?: IToolResponseProcessor;
+    /** Max single steps (tool calls) */
+    maxSteps?: number;
+    /** Enable tool continuation planning */
+    enableContinuationPlanning?: boolean;
+    continuationStrategy?: 'sequential' | 'parallel' | 'conditional';
+    /** Enable goal planning */
+    enableGoalPlanning?: boolean;
+    goalInjectionFrequency?: 'always' | 'every_N_turns' | 'on_compression';
+    goalInjectionPosition?: 'system_prompt' | 'pre_turn';
+    /** Skill budget */
+    skillTokenBudget?: number;
+    /** Callback for each turn in the session */
+    onTurn?: (turn: any) => void;
+    /** Short Term Memory Registry */
+    stmRegistry?: ShortTermMemoryRegistry;
+    /** Max tokens allowed for a single tool response */
+    maxTokensPerTool?: number;
+    /**
+     * Execution budget constraints: call quotas and concurrency cap.
+     * Enforced in the ReAct loop before each tool call.
+     */
+    toolExecutionBudget?: ToolExecutionBudget;
+    /**
+     * When true, independent tool calls within a single assistant response are
+     * executed in parallel using `Promise.all`. Defaults to false (sequential).
+     */
+    parallelToolCalls?: boolean;
+    /**
+     * Default timeout in ms for each tool execution.
+     * Passed to `ToolRegistry`. Defaults to 30 000.
+     */
+    toolRegistryTimeoutMs?: number;
+    /** Callback for granular trace events (planning, budgets, tools, etc.) */
+    onTrace?: (event: TraceEvent) => void;
+    /**
+     * MCP (Model Context Protocol) server configurations.
+     * Each server is connected at session construction, its tools are discovered
+     * and registered alongside native tools — fully transparent to the ReAct loop.
+     *
+     * @example
+     * mcpServers: [
+     *   { name: 'github', transport: 'stdio', command: 'npx', args: ['@modelcontextprotocol/server-github'] },
+     *   { name: 'db_tools', transport: 'http', url: 'http://localhost:3001' }
+     * ]
+     */
+    mcpServers?: MCPServerConfig[];
+}
+/** Rich trace event for observability */
+interface TraceEvent {
+    sessionId?: string;
+    type: 'planning' | 'budget' | 'tool_call' | 'tool_result' | 'thinking' | 'system' | 'compression' | 'error';
+    name: string;
+    input?: any;
+    output?: any;
+    durationMs?: number;
+    startedAt?: number;
+    status?: 'running' | 'done' | 'error';
+    metadata?: Record<string, any>;
+}
+
+export type { IToolResponseProcessor as I, MCPServerConfig as M, SessionConfig as S, ToolResponseEvaluation as T, MCPToolDefinition as a, MCPJsonRpcRequest as b, MCPJsonRpcResponse as c, MCPTransportType as d, MediaConfig as e, ToolDecision as f, ToolExecutionBudget as g, ToolFirewallConfig as h, ToolFirewallRule as i, TraceEvent as j };

package/dist/context/index.d.mts

@@ -1,6 +1,5 @@
-import { I as IContextStrategy, C as ContextWindow, e as IProviderAdapter } from '../adapters-BnG0LEYD.mjs';
-import { a as IStorageAdapter } from '../storage-DMcliVVj.mjs';
-export { b as STMRegistryConfig, c as ShortTermMemoryRegistry } from '../storage-DMcliVVj.mjs';
+import { b as IContextStrategy, C as ContextWindow, a as IProviderAdapter, m as IStorageAdapter } from '../storage-CG3nTa6o.mjs';
+export { o as STMRegistryConfig, S as ShortTermMemoryRegistry } from '../storage-CG3nTa6o.mjs';
 import '../rag-La_Bo-J8.mjs';
 import '../logger-DxvKliuk.mjs';
 

package/dist/context/index.d.ts

@@ -1,6 +1,5 @@
-import { I as IContextStrategy, C as ContextWindow, e as IProviderAdapter } from '../adapters-BSkhv5ac.js';
-import { a as IStorageAdapter } from '../storage-BGu4Loao.js';
-export { b as STMRegistryConfig, c as ShortTermMemoryRegistry } from '../storage-BGu4Loao.js';
+import { b as IContextStrategy, C as ContextWindow, a as IProviderAdapter, m as IStorageAdapter } from '../storage-DBt_q0wO.js';
+export { o as STMRegistryConfig, S as ShortTermMemoryRegistry } from '../storage-DBt_q0wO.js';
 import '../rag-La_Bo-J8.js';
 import '../logger-DxvKliuk.js';
 

package/dist/context/index.js.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":";;;;;AAMO,IAAM,WAAA,GAAN,cAA0B,KAAA,CAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOnC,YACI,OAAA,EACgB,IAAA,EACA,OAAA,EACA,KAAA,GAAkB,EAAC,EACrC;AACE,IAAA,KAAA,CAAM,OAAO,CAAA;AAJG,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AACA,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AACA,IAAA,IAAA,CAAA,KAAA,GAAA,KAAA;AAGhB,IAAA,IAAA,CAAK,IAAA,GAAO,aAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,GAAA,CAAA,MAAA,CAAW,SAAS,CAAA;AAAA,EACpD;AACJ,CAAA;AAGO,IAAM,0BAAA,GAAN,cAAyC,WAAA,CAAY;AAAA,EACxD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,SAAS,kBAAkB,CAAA;AACjC,IAAA,IAAA,CAAK,IAAA,GAAO,4BAAA;AAAA,EAChB;AACJ,CAAA;;;ACzBO,IAAM,iBAAN,MAAqB;AAAA,EAChB,aAAiC,EAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO1C,iBAAiB,QAAA,EAAkC;AAC/C,IAAA,IAAA,CAAK,UAAA,CAAW,KAAK,QAAQ,CAAA;AAC7B,IAAA,IAAA,CAAK,UAAA,CAAW,KAAK,CAAC,CAAA,EAAG,MAAM,CAAA,CAAE,QAAA,GAAW,EAAE,QAAQ,CAAA;AAAA,EAC1D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,OAAA,CAAQ,OAAA,EAAwB,YAAA,GAAe,IAAA,EAA8B;AAC/E,IAAA,IAAI,UAAA,GAAa,EAAE,GAAG,OAAA,EAAS,OAAO,CAAC,GAAG,OAAA,CAAQ,KAAK,CAAA,EAAE;AACzD,IAAyB,WAAW,SAAA,GAAY;AAEhD,IAAA,KAAA,MAAW,QAAA,IAAY,KAAK,UAAA,EAAY;AAIpC,MAAA,IAAI,QAAA,CAAS,WAAA,CAAY,UAAU,CAAA,EAAG;AAClC,QAAA,UAAA,GAAa,MAAM,QAAA,CAAS,KAAA,CAAM,UAAU,CAAA;AAAA,MAChD;AAAA,IACJ;AAEA,IAAA,IAAI,UAAA,CAAW,UAAA,GAAa,UAAA,CAAW,SAAA,EAAW;AAC9C,MAAA,MAAM,IAAI,0BAAA;AAAA,QACN,CAAA,oBAAA,EAAuB,UAAA,CAAW,UAAU,CAAA,UAAA,EAAa,WAAW,SAAS,CAAA;AAAA,OACjF;AAAA,IACJ;AAEA,IAAA,OAAO,UAAA;AAAA,EACX;AACJ;;;ACrCO,IAAM,8BAAN,MAA8D;AAAA,EAIjE,WAAA,CACY,SACA,MAAA,EACV;AAFU,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AACA,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EACR;AAAA,EANK,IAAA,GAAO,sBAAA;AAAA,EACP,QAAA,GAAW,EAAA;AAAA,EAOpB,YAAY,GAAA,EAA6B;AACrC,IAAA,OACI,GAAA,CAAI,UAAA,IAAc,GAAA,CAAI,SAAA,GAAY,KAAK,MAAA,CAAO,gBAAA,IAC9C,GAAA,CAAI,KAAA,CAAM,MAAA,GAAS,IAAA,CAAK,MAAA,CAAO,aAAA,GAAgB,KAAK,MAAA,CAAO,YAAA;AAAA,EAEnE;AAAA,EAEA,MAAM,MAAM,GAAA,EAA4C;AACpD,IAAA,MAAM,EAAE,aAAA,EAAe,YAAA,EAAa,GAAI,IAAA,CAAK,MAAA;AAE7C,IAAA,MAAM,IAAA,GAAO,GAAA,CAAI,KAAA,CAAM,KAAA,CAAM,GAAG,aAAa,CAAA;AAC7C,IAAA,MAAM,OAAO,GAAA,CAAI,KAAA,CAAM,MAAM,GAAA,CAAI,KAAA,CAAM,SAAS,YAAY,CAAA;AAC5D,IAAA,MAAM,MAAA,GAAS,IAAI,KAAA,CAAM,KAAA,CAAM,eAAe,GAAA,CAAI,KAAA,CAAM,SAAS,YAAY,CAAA;AAE7E,IAAA,MAAM,aAAa,MAAA,CAAO,GAAA,CAAI,CAAA,CAAA,KAAK,CAAA,EAAG,EAAE,IAAI,CAAA,EAAA,EAAK,IAAA,CAAK,SAAA,CAAU,EAAE,OAAO,CAAC,CAAA,CAAE,CAAA,CAAE,KAAK,IAAI,CAAA;AAEvF,IAAA,MAAM,eAAA,GAAkB,MAAM,IAAA,CAAK,OAAA,CAAQ,QAAA,CAAS;AAAA,MAChD,KAAA,EAAO,EAAA;AAAA,MACP,UAAU,CAAC;AAAA,QACP,IAAA,EAAM,MAAA;AAAA,QACN,OAAA,EAAS,CAAA;AAAA,EAA0D,UAAU,CAAA;AAAA,OAChF;AAAA,KACJ,CAAA;AAED,IAAA,MAAM,aAAa,eAAA,CAAgB,OAAA;AAEnC,IAAA,MAAM,qBAAA,GAAwB,GAAA,CAAI,kBAAA,GAC5B,CAAA,EAAG,IAAI,kBAAkB;AAAA,EAAK,UAAU,CAAA,CAAA,GACxC,UAAA;AAEN,IAAA,MAAM,WAAA,GAAoB;AAAA,MACtB,IAAA,EAAM,QAAA;AAAA,MACN,OAAA,EAAS,CAAA;AAAA,EAAiC,qBAAqB,CAAA,CAAA;AAAA,MAC/D,UAAA,EAAY,IAAA,CAAK,OAAA,CAAQ,cAAA,CAAe,qBAAqB,CAAA;AAAA,MAC7D,SAAA,EAAW,EAAA;AAAA,MACX,UAAA,EAAY;AAAA,KAChB;AAEA,IAAA,MAAM,WAAW,CAAC,GAAG,IAAA,EAAM,WAAA,EAAa,GAAG,IAAI,CAAA;AAC/C,IAAA,MAAM,aAAA,GAAgB,SAAS,MAAA,CAAO,CAAC,KAAK,CAAA,KAAM,GAAA,GAAM,EAAE,UAAA,EAAY,CAAC,IACnE,IAAA,CAAK,OAAA,CAAQ,eAAe,GAAA,CAAI,YAAY,IAC5C,IAAA,CAAK,OAAA,CAAQ,cAAA,CAAe,GAAA,CAAI,UAAU,CAAA;AAE9C,IAAA,OAAO;AAAA,MACH,GAAG,GAAA;AAAA,MACH,KAAA,EAAO,QAAA;AAAA,MACP,UAAA,EAAY,aAAA;AAAA,MACZ,kBAAA,EAAoB;AAAA,KACxB;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,kBAAA,CAAmB,OAAA,EAAiB,YAAA,GAAuB,6BAAA,EAI9D;AAGC,IAAA,MAAM,eAAA,GAAkB,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,IAAA,CAAK,IAAA,CAAK,IAAA,CAAK,OAAA,CAAQ,cAAA,CAAe,OAAO,CAAA,GAAI,GAAI,CAAC,CAAA;AAC1F,IAAA,MAAM,QAAA,GAAW,uBAAuB,eAAe,CAAA,iBAAA,CAAA;AAKvD,IAAA,MAAM,eAAA,GAAkB,MAAM,IAAA,CAAK,OAAA,CAAQ,QAAA,CAAS;AAAA,MAChD,KAAA,EAAO,EAAA;AAAA,MACP,UAAU,CAAC;AAAA,QACP,IAAA,EAAM,MAAA;AAAA,QACN,OAAA,EAAS,CAAA;AAAA,EAAyB,YAAY;;AAAA;AAAA,EAAwB,OAAO;;AAAA;AAAA,EAA6B,YAAY,CAAA;AAAA,OACzH;AAAA,KACJ,CAAA;AACD,IAAA,MAAM,YAAY,eAAA,CAAgB,OAAA;AAIlC,IAAA,MAAM,SAAA,GAAY,CAAA,+FAAA,CAAA;AAElB,IAAA,OAAO,EAAE,QAAA,EAAU,SAAA,EAAW,SAAA,EAAU;AAAA,EAC5C;AACJ;;;ACrGO,IAAM,qBAAN,MAAqD;AAAA,EAC/C,IAAA,GAAO,qBAAA;AAAA,EACP,QAAA,GAAW,EAAA;AAAA,EAEpB,YAAY,GAAA,EAA6B;AAErC,IAAA,OAAO,GAAA,CAAI,WAAW,MAAA,GAAS,CAAA;AAAA,EACnC;AAAA,EAEA,MAAM,MAAM,GAAA,EAA4C;AAEpD,IAAA,OAAO,GAAA;AAAA,EACX;AACJ;AAUO,IAAM,6BAAN,MAA6D;AAAA,EAIhE,WAAA,CACY,SACA,MAAA,EACV;AAFU,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AACA,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EACR;AAAA,EANK,IAAA,GAAO,qBAAA;AAAA,EACP,QAAA,GAAW,EAAA;AAAA,EAOpB,YAAY,GAAA,EAA6B;AACrC,IAAA,MAAM,aAAA,GAAgB,GAAA,CAAI,SAAA,GAAY,IAAA,CAAK,MAAA,CAAO,gBAAA;AAGlD,IAAA,MAAM,iBAAA,GAAoB,GAAA,CAAI,KAAA,CAAM,MAAA,CAAO,CAAA,CAAA,KAAK,EAAE,IAAA,KAAS,QAAA,IAAY,CAAC,CAAA,CAAE,UAAU,CAAA;AACpF,IAAA,OAAO,IAAI,UAAA,IAAc,aAAA,IAAiB,iBAAA,CAAkB,MAAA,GAAS,KAAK,MAAA,CAAO,UAAA;AAAA,EACrF;AAAA,EAEA,MAAM,MAAM,GAAA,EAA4C;AAEpD,IAAA,MAAM,mBAAA,GAAsB,GAAA,CAAI,KAAA,CAC3B,GAAA,CAAI,CAAC,CAAA,EAAG,CAAA,MAAO,EAAE,CAAA,EAAG,CAAA,EAAE,CAAE,CAAA,CACxB,MAAA,CAAO,CAAC,EAAE,CAAA,EAAE,KAAM,CAAA,CAAE,IAAA,KAAS,QAAA,IAAY,CAAC,CAAA,CAAE,UAAU,CAAA,CACtD,KAAA,CAAM,CAAA,EAAG,IAAA,CAAK,MAAA,CAAO,UAAU,CAAA;AAEpC,IAAA,MAAM,WAAA,GAAc,mBAAA,CAAoB,GAAA,CAAI,CAAA,CAAA,KAAK,EAAE,CAAC,CAAA;AACpD,IAAA,MAAM,aAAa,WAAA,CAAY,GAAA,CAAI,CAAA,CAAA,KAAK,CAAA,EAAG,EAAE,IAAI,CAAA,EAAA,EAAK,IAAA,CAAK,SAAA,CAAU,EAAE,OAAO,CAAC,CAAA,CAAE,CAAA,CAAE,KAAK,IAAI,CAAA;AAE5F,IAAA,MAAM,eAAA,GAAkB,MAAM,IAAA,CAAK,OAAA,CAAQ,QAAA,CAAS;AAAA,MAChD,KAAA,EAAO,EAAA;AAAA,MACP,UAAU,CAAC;AAAA,QACP,IAAA,EAAM,MAAA;AAAA,QACN,OAAA,EAAS,CAAA;AAAA,EAAoD,UAAU,CAAA;AAAA,OAC1E;AAAA,KACJ,CAAA;AAED,IAAA,MAAM,aAAa,eAAA,CAAgB,OAAA;AACnC,IAAA,MAAM,qBAAA,GAAwB,GAAA,CAAI,kBAAA,GAC5B,CAAA,EAAG,IAAI,kBAAkB;AAAA,EAAK,UAAU,CAAA,CAAA,GACxC,UAAA;AAGN,IAAA,MAAM,eAAA,GAAkB,IAAI,GAAA,CAAI,mBAAA,CAAoB,IAAI,CAAA,CAAA,KAAK,CAAA,CAAE,CAAC,CAAC,CAAA;AACjE,IAAA,MAAM,QAAA,GAAW,GAAA,CAAI,KAAA,CAAM,MAAA,CAAO,CAAC,CAAA,EAAG,CAAA,KAAM,CAAC,eAAA,CAAgB,GAAA,CAAI,CAAC,CAAC,CAAA;AAEnE,IAAA,MAAM,UAAA,GAAa,SAAS,MAAA,CAAO,CAAC,KAAK,CAAA,KAAM,GAAA,GAAM,EAAE,UAAA,EAAY,CAAC,IAChE,IAAA,CAAK,OAAA,CAAQ,eAAe,GAAA,CAAI,YAAY,IAC5C,IAAA,CAAK,OAAA,CAAQ,cAAA,CAAe,GAAA,CAAI,UAAU,CAAA;AAE9C,IAAA,OAAO;AAAA,MACH,GAAG,GAAA;AAAA,MACH,KAAA,EAAO,QAAA;AAAA,MACP,UAAA,EAAY,UAAA;AAAA,MACZ,kBAAA,EAAoB;AAAA,KACxB;AAAA,EACJ;AACJ;AC/DO,IAAM,0BAAN,MAA8B;AAAA,EACzB,OAAA;AAAA,EACA,aAAA;AAAA,EAER,YAAY,MAAA,EAA2B;AACnC,IAAA,IAAA,CAAK,UAAU,MAAA,CAAO,OAAA;AACtB,IAAA,IAAA,CAAK,aAAA,GAAgB,OAAO,aAAA,IAAiB,GAAA;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,QAAA,CACF,OAAA,EACA,IAAA,EACA,UACA,cAAA,EACe;AACf,IAAA,IAAI,SAAS,MAAA,EAAQ;AACjB,MAAA,MAAM,UAAA,GAAa,cAAA,GAAiB,cAAA,CAAe,OAAO,CAAA,GAAI,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,OAAO,CAAA,CAAE,MAAA,GAAS,CAAC,CAAA;AAClG,MAAA,IAAI,UAAA,GAAa,KAAK,aAAA,EAAe;AACjC,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,yCAAA,EAA4C,KAAK,aAAa,CAAA,YAAA,EAAe,UAAU,CAAA,CAAA,CAAG,CAAA;AAAA,MAC9G;AAAA,IACJ;AAEA,IAAA,MAAM,KAAKA,iBAAA,EAAW;AACtB,IAAA,MAAM,IAAA,GAAgB;AAAA,MAClB,EAAA;AAAA,MACA,OAAA;AAAA,MACA,IAAA;AAAA,MACA,GAAI,QAAA,KAAa,MAAA,GAAY,EAAE,QAAA,KAAa;AAAC,KACjD;AAEA,IAAA,MAAM,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,EAAA,EAAI,IAAI,CAAA;AAC/B,IAAA,OAAO,QAAQ,EAAE,CAAA,CAAA,CAAA;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,MAAA,CAAO,EAAA,EAAY,OAAA,EAA+E;AACpG,IAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,OAAA,CAAQ,IAAI,EAAE,CAAA;AACtC,IAAA,IAAI,CAAC,IAAA,EAAM,MAAM,IAAI,KAAA,CAAM,CAAA,+BAAA,EAAkC,EAAE,CAAA,CAAE,CAAA;AAEjE,IAAA,MAAM,WAAA,GAAuB;AAAA,MACzB,GAAG,IAAA;AAAA,MACH,GAAI,QAAQ,OAAA,KAAY,MAAA,GAAY,EAAE,OAAA,EAAS,OAAA,CAAQ,OAAA,EAAQ,GAAI,EAAC;AAAA,MACpE,GAAI,OAAA,CAAQ,QAAA,KAAa,MAAA,GAAY,EAAE,QAAA,EAAU,EAAE,GAAG,IAAA,CAAK,UAAU,GAAG,OAAA,CAAQ,QAAA,EAAS,KAAM;AAAC,KACpG;AAEA,IAAA,MAAM,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,EAAA,EAAI,WAAW,CAAA;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,SAAS,GAAA,EAA2C;AACtD,IAAA,MAAM,KAAA,GAAQ,GAAA,CAAI,KAAA,CAAM,gBAAgB,CAAA;AACxC,IAAA,IAAI,CAAC,KAAA,IAAS,CAAC,KAAA,CAAM,CAAC,GAAG,OAAO,MAAA;AAChC,IAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,KAAA,CAAM,CAAC,CAAC,CAAA;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,OAAO,EAAA,EAA2B;AACpC,IAAA,MAAM,IAAA,CAAK,OAAA,CAAQ,MAAA,CAAO,EAAE,CAAA;AAAA,EAChC;AACJ;AC9FO,IAAM,yBAAN,MAAwD;AAAA,EACnD,KAAA,uBAAY,GAAA,EAAkE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQtF,MAAM,IAAI,EAAA,EAAsC;AAC5C,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,EAAE,CAAA,EAAG,OAAA;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,QAAQ,EAAA,EAAuF;AACjG,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,EAAE,CAAA;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,GAAA,CAAI,EAAA,EAAwB,OAAA,EAAc,QAAA,EAAqD;AACjG,IAAA,MAAM,UAAA,GAAa,MAAMA,iBAAAA,EAAW;AACpC,IAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,UAAA,EAAY,QAAA,KAAa,MAAA,GAAY,EAAE,OAAA,EAAS,QAAA,EAAS,GAAI,EAAE,OAAA,EAAS,CAAA;AACvF,IAAA,OAAO,UAAA;AAAA,EACX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,OAAO,EAAA,EAA2B;AACpC,IAAA,IAAA,CAAK,KAAA,CAAM,OAAO,EAAE,CAAA;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,WAAA,GAAgC;AAClC,IAAA,OAAO,IAAA;AAAA,EACX;AACJ","file":"index.js","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.js","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"]}