@jungjaehoon/mama-os 0.1.1

package/dist/agent/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Agent Module for MAMA Standalone
+ *
+ * Exports:
+ * - AgentLoop - Main agent loop orchestrator
+ * - GatewayToolExecutor - Gateway tool executor (NOT MCP)
+ * - Types - All type definitions
+ */
+export { AgentLoop } from './agent-loop.js';
+export { GatewayToolExecutor } from './gateway-tool-executor.js';
+export type { MessageRole, ContentBlockType, TextBlock, ToolUseBlock, ToolResultBlock, ContentBlock, Message, StopReason, Usage, ClaudeResponse, ClaudeErrorResponse, ClaudeRequest, ToolInputSchema, ToolDefinition, SaveDecisionInput, SaveCheckpointInput, SaveInput, SearchInput, UpdateInput, LoadCheckpointInput, GatewayToolInput, GatewayToolName, SaveResult, SearchResultItem, SearchResult, UpdateResult, LoadCheckpointResult, GatewayToolResult, AgentLoopOptions, TurnInfo, AgentLoopResult, ClaudeClientOptions, ClaudeHeaders, GatewayToolExecutorOptions, MAMAApiInterface, AgentErrorCode, StreamCallbacks, } from './types.js';
+export { AgentError } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,YAAY,EAEV,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,OAAO,EACP,UAAU,EACV,KAAK,EACL,cAAc,EACd,mBAAmB,EACnB,aAAa,EAGb,eAAe,EACf,cAAc,EAGd,iBAAiB,EACjB,mBAAmB,EACnB,SAAS,EACT,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EAGf,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EAGjB,gBAAgB,EAChB,QAAQ,EACR,eAAe,EAGf,mBAAmB,EACnB,aAAa,EACb,0BAA0B,EAC1B,gBAAgB,EAGhB,cAAc,EAGd,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/agent/index.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Agent Module for MAMA Standalone
+ *
+ * Exports:
+ * - AgentLoop - Main agent loop orchestrator
+ * - GatewayToolExecutor - Gateway tool executor (NOT MCP)
+ * - Types - All type definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentError = exports.GatewayToolExecutor = exports.AgentLoop = void 0;
+var agent_loop_js_1 = require("./agent-loop.js");
+Object.defineProperty(exports, "AgentLoop", { enumerable: true, get: function () { return agent_loop_js_1.AgentLoop; } });
+var gateway_tool_executor_js_1 = require("./gateway-tool-executor.js");
+Object.defineProperty(exports, "GatewayToolExecutor", { enumerable: true, get: function () { return gateway_tool_executor_js_1.GatewayToolExecutor; } });
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "AgentError", { enumerable: true, get: function () { return types_js_1.AgentError; } });
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,iDAA4C;AAAnC,0GAAA,SAAS,OAAA;AAClB,uEAAiE;AAAxD,+HAAA,mBAAmB,OAAA;AA0D5B,uCAAwC;AAA/B,sGAAA,UAAU,OAAA"}

package/dist/agent/mcp-executor.d.ts

@@ -0,0 +1,75 @@
+/**
+ * MAMA Tool Executor for MAMA Standalone
+ *
+ * Executes MAMA gateway tools (mama_search, mama_save, mama_update, mama_load_checkpoint, Read, discord_send).
+ * NOT MCP - uses Claude Messages API tool definitions.
+ * Supports both direct API integration and mock API for testing.
+ */
+import type { GatewayToolName, MAMAApiInterface } from './types.js';
+/**
+ * Discord gateway interface for sending messages
+ */
+export interface DiscordGatewayInterface {
+    sendMessage(channelId: string, message: string): Promise<void>;
+    sendImage(channelId: string, imagePath: string, caption?: string): Promise<void>;
+}
+export declare class MCPExecutor {
+    private mamaApi;
+    private readonly dbPath?;
+    private discordGateway;
+    constructor(options?: {
+        dbPath?: string;
+        mamaApi?: MAMAApiInterface;
+    });
+    /**
+     * Set Discord gateway for discord_send tool
+     */
+    setDiscordGateway(gateway: DiscordGatewayInterface): void;
+    /**
+     * Initialize the MAMA API by importing from mcp-server package
+     * Called lazily on first tool execution if not provided in constructor
+     */
+    private initializeMAMAApi;
+    /**
+     * Execute an MCP tool
+     *
+     * @param toolName - Name of the tool to execute
+     * @param input - Tool input parameters
+     * @returns Tool execution result
+     * @throws AgentError on tool errors
+     */
+    execute(toolName: string, input: any): Promise<any>;
+    /**
+     * Execute save tool (decision or checkpoint)
+     */
+    private executeSave;
+    /**
+     * Execute search tool
+     */
+    private executeSearch;
+    /**
+     * Execute update tool
+     */
+    private executeUpdate;
+    /**
+     * Execute load_checkpoint tool
+     */
+    private executeLoadCheckpoint;
+    /**
+     * Execute read tool - Read file from filesystem
+     */
+    private executeRead;
+    /**
+     * Execute discord_send tool - Send message/image to Discord channel
+     */
+    private executeDiscordSend;
+    /**
+     * Get the list of valid tool names
+     */
+    static getValidTools(): GatewayToolName[];
+    /**
+     * Check if a tool name is valid
+     */
+    static isValidTool(toolName: string): toolName is GatewayToolName;
+}
+//# sourceMappingURL=mcp-executor.d.ts.map

package/dist/agent/mcp-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-executor.d.ts","sourceRoot":"","sources":["../../src/agent/mcp-executor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EACV,eAAe,EAWf,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClF;AAeD,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,cAAc,CAAwC;gBAElD,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,gBAAgB,CAAA;KAAO;IAQzE;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAIzD;;;OAGG;YACW,iBAAiB;IAgD/B;;;;;;;OAOG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IA2DzD;;OAEG;YACW,WAAW;IA6CzB;;OAEG;YACW,aAAa;IAyC3B;;OAEG;YACW,aAAa;IAkC3B;;OAEG;YACW,qBAAqB;IAOnC;;OAEG;YACW,WAAW;IA+BzB;;OAEG;YACW,kBAAkB;IA8BhC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,eAAe,EAAE;IAIzC;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,IAAI,eAAe;CAGlE"}

package/dist/agent/mcp-executor.js

@@ -0,0 +1,307 @@
+"use strict";
+/**
+ * MAMA Tool Executor for MAMA Standalone
+ *
+ * Executes MAMA gateway tools (mama_search, mama_save, mama_update, mama_load_checkpoint, Read, discord_send).
+ * NOT MCP - uses Claude Messages API tool definitions.
+ * Supports both direct API integration and mock API for testing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPExecutor = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const phase_7_integrations_js_1 = require("../onboarding/phase-7-integrations.js");
+const types_js_1 = require("./types.js");
+/**
+ * Valid MAMA tool names (Gateway tools, NOT MCP)
+ */
+const VALID_TOOLS = [
+    'mama_search',
+    'mama_save',
+    'mama_update',
+    'mama_load_checkpoint',
+    'Read',
+    'discord_send',
+    'save_integration_token',
+];
+class MCPExecutor {
+    mamaApi = null;
+    dbPath;
+    discordGateway = null;
+    constructor(options = {}) {
+        this.dbPath = options.dbPath;
+        if (options.mamaApi) {
+            this.mamaApi = options.mamaApi;
+        }
+    }
+    /**
+     * Set Discord gateway for discord_send tool
+     */
+    setDiscordGateway(gateway) {
+        this.discordGateway = gateway;
+    }
+    /**
+     * Initialize the MAMA API by importing from mcp-server package
+     * Called lazily on first tool execution if not provided in constructor
+     */
+    async initializeMAMAApi() {
+        if (this.mamaApi) {
+            return this.mamaApi;
+        }
+        try {
+            // Set database path if provided
+            if (this.dbPath) {
+                process.env.MAMA_DB_PATH = this.dbPath;
+            }
+            // Dynamic import of MAMA mcp-server modules
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            let mama, dbManager;
+            try {
+                mama = require('@jungjaehoon/mama-server/src/mama/mama-api');
+                dbManager = require('@jungjaehoon/mama-server/src/mama/db-manager');
+            }
+            catch {
+                // Fallback to direct path (for development)
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                mama = require('@jungjaehoon/mama-server/src/mama/mama-api.js');
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                dbManager = require('@jungjaehoon/mama-server/src/mama/db-manager.js');
+            }
+            // Initialize the database before using mama-api functions
+            await dbManager.initDB();
+            this.mamaApi = {
+                save: mama.save.bind(mama),
+                saveCheckpoint: mama.saveCheckpoint.bind(mama),
+                listDecisions: mama.list.bind(mama), // Note: mama exports listDecisions as 'list'
+                suggest: mama.suggest.bind(mama),
+                updateOutcome: mama.updateOutcome.bind(mama),
+                loadCheckpoint: mama.loadCheckpoint.bind(mama),
+            };
+            return this.mamaApi;
+        }
+        catch (error) {
+            throw new types_js_1.AgentError(`Failed to initialize MAMA API: ${error instanceof Error ? error.message : String(error)}`, 'TOOL_ERROR', error instanceof Error ? error : undefined, false);
+        }
+    }
+    /**
+     * Execute an MCP tool
+     *
+     * @param toolName - Name of the tool to execute
+     * @param input - Tool input parameters
+     * @returns Tool execution result
+     * @throws AgentError on tool errors
+     */
+    async execute(toolName, input) {
+        if (!VALID_TOOLS.includes(toolName)) {
+            throw new types_js_1.AgentError(`Unknown tool: ${toolName}. Valid tools: ${VALID_TOOLS.join(', ')}`, 'UNKNOWN_TOOL', undefined, false);
+        }
+        try {
+            // Handle non-MAMA tools first
+            switch (toolName) {
+                case 'Read':
+                    return await this.executeRead(input);
+                case 'discord_send':
+                    return await this.executeDiscordSend(input);
+                case 'save_integration_token':
+                    return await (0, phase_7_integrations_js_1.handleSaveIntegrationToken)(input);
+            }
+            // MAMA tools require API
+            const api = await this.initializeMAMAApi();
+            switch (toolName) {
+                case 'mama_save':
+                    return await this.executeSave(api, input);
+                case 'mama_search':
+                    return await this.executeSearch(api, input);
+                case 'mama_update':
+                    return await this.executeUpdate(api, input);
+                case 'mama_load_checkpoint':
+                    return await this.executeLoadCheckpoint(api, input);
+                default:
+                    throw new types_js_1.AgentError(`Unknown tool: ${toolName}`, 'UNKNOWN_TOOL', undefined, false);
+            }
+        }
+        catch (error) {
+            if (error instanceof types_js_1.AgentError) {
+                throw error;
+            }
+            throw new types_js_1.AgentError(`Tool execution failed (${toolName}): ${error instanceof Error ? error.message : String(error)}`, 'TOOL_ERROR', error instanceof Error ? error : undefined, false);
+        }
+    }
+    /**
+     * Execute save tool (decision or checkpoint)
+     */
+    async executeSave(api, input) {
+        if (input.type === 'decision') {
+            const decisionInput = input;
+            if (!decisionInput.topic || !decisionInput.decision || !decisionInput.reasoning) {
+                return {
+                    success: false,
+                    message: 'Decision requires: topic, decision, reasoning',
+                };
+            }
+            // Map MCP 'decision' type to mama-api 'user_decision' type
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return await api.save({
+                topic: decisionInput.topic,
+                decision: decisionInput.decision,
+                reasoning: decisionInput.reasoning,
+                confidence: decisionInput.confidence ?? 0.5,
+                type: 'user_decision', // mama-api expects 'user_decision' not 'decision'
+            });
+        }
+        if (input.type === 'checkpoint') {
+            const checkpointInput = input;
+            if (!checkpointInput.summary) {
+                return {
+                    success: false,
+                    message: 'Checkpoint requires: summary',
+                };
+            }
+            return await api.saveCheckpoint(checkpointInput.summary, checkpointInput.open_files ?? [], checkpointInput.next_steps ?? '');
+        }
+        return {
+            success: false,
+            message: `Invalid save type: ${input.type}. Must be 'decision' or 'checkpoint'`,
+        };
+    }
+    /**
+     * Execute search tool
+     */
+    async executeSearch(api, input) {
+        const { query, type, limit = 10 } = input;
+        // If no query provided, return recent items using listDecisions
+        if (!query) {
+            const decisions = await api.listDecisions({ limit });
+            const results = Array.isArray(decisions) ? decisions : [];
+            // Filter by type if specified
+            const filteredResults = type && type !== 'all'
+                ? results.filter((item) => {
+                    const typedItem = item;
+                    return typedItem.type === type;
+                })
+                : results;
+            return {
+                success: true,
+                results: filteredResults,
+                count: filteredResults.length,
+            };
+        }
+        // Semantic search using suggest
+        const result = await api.suggest(query, { limit });
+        // Filter by type if specified
+        let filteredResults = result.results ?? [];
+        if (type && type !== 'all') {
+            filteredResults = filteredResults.filter((item) => item.type === type);
+        }
+        return {
+            success: true,
+            results: filteredResults,
+            count: filteredResults.length,
+        };
+    }
+    /**
+     * Execute update tool
+     */
+    async executeUpdate(api, input) {
+        const { id, outcome, reason } = input;
+        if (!id) {
+            return {
+                success: false,
+                message: 'Update requires: id',
+            };
+        }
+        if (!outcome) {
+            return {
+                success: false,
+                message: 'Update requires: outcome',
+            };
+        }
+        // Normalize outcome to uppercase
+        const normalizedOutcome = outcome.toUpperCase();
+        const validOutcomes = ['SUCCESS', 'FAILED', 'PARTIAL'];
+        if (!validOutcomes.includes(normalizedOutcome)) {
+            return {
+                success: false,
+                message: `Invalid outcome: ${outcome}. Must be one of: success, failed, partial`,
+            };
+        }
+        return await api.updateOutcome(id, {
+            outcome: normalizedOutcome,
+            failure_reason: reason,
+        });
+    }
+    /**
+     * Execute load_checkpoint tool
+     */
+    async executeLoadCheckpoint(api, _input) {
+        return await api.loadCheckpoint();
+    }
+    /**
+     * Execute read tool - Read file from filesystem
+     */
+    async executeRead(input) {
+        const { path: filePath } = input;
+        if (!filePath) {
+            return { success: false, error: 'Path is required' };
+        }
+        // Expand ~ to home directory
+        const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+        const expandedPath = filePath.startsWith('~/') ? (0, path_1.join)(homeDir, filePath.slice(2)) : filePath;
+        // Security: Only allow reading from ~/.mama/ directory
+        const mamaDir = (0, path_1.join)(homeDir, '.mama');
+        if (!expandedPath.startsWith(mamaDir)) {
+            return { success: false, error: `Access denied: Can only read files from ${mamaDir}` };
+        }
+        if (!(0, fs_1.existsSync)(expandedPath)) {
+            return { success: false, error: `File not found: ${expandedPath}` };
+        }
+        try {
+            const content = (0, fs_1.readFileSync)(expandedPath, 'utf-8');
+            return { success: true, content };
+        }
+        catch (err) {
+            return { success: false, error: `Failed to read file: ${err}` };
+        }
+    }
+    /**
+     * Execute discord_send tool - Send message/image to Discord channel
+     */
+    async executeDiscordSend(input) {
+        const { channel_id, message, image_path } = input;
+        if (!channel_id) {
+            return { success: false, error: 'channel_id is required' };
+        }
+        if (!this.discordGateway) {
+            return { success: false, error: 'Discord gateway not configured' };
+        }
+        try {
+            if (image_path) {
+                await this.discordGateway.sendImage(channel_id, image_path, message);
+            }
+            else if (message) {
+                await this.discordGateway.sendMessage(channel_id, message);
+            }
+            else {
+                return { success: false, error: 'Either message or image_path is required' };
+            }
+            return { success: true };
+        }
+        catch (err) {
+            return { success: false, error: `Failed to send to Discord: ${err}` };
+        }
+    }
+    /**
+     * Get the list of valid tool names
+     */
+    static getValidTools() {
+        return [...VALID_TOOLS];
+    }
+    /**
+     * Check if a tool name is valid
+     */
+    static isValidTool(toolName) {
+        return VALID_TOOLS.includes(toolName);
+    }
+}
+exports.MCPExecutor = MCPExecutor;
+//# sourceMappingURL=mcp-executor.js.map

package/dist/agent/mcp-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-executor.js","sourceRoot":"","sources":["../../src/agent/mcp-executor.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,148 @@
+/**
+ * Session Pool - Claude CLI Session Reuse Manager
+ *
+ * Manages Claude CLI session IDs per channel to enable conversation continuity.
+ * Instead of creating new sessions for each message, reuses existing sessions
+ * so Claude CLI maintains its own conversation history.
+ *
+ * Benefits:
+ * - 6x token reduction (no manual history injection needed)
+ * - Natural conversation flow (Claude remembers context)
+ * - Automatic summarization by Claude when context fills up
+ */
+/**
+ * Session entry with metadata
+ */
+interface SessionEntry {
+    /** Claude CLI session ID */
+    sessionId: string;
+    /** Last activity timestamp */
+    lastActive: number;
+    /** Message count in this session */
+    messageCount: number;
+    /** Creation timestamp */
+    createdAt: number;
+    /** Whether session is currently in use (locked) */
+    inUse: boolean;
+    /** Cumulative input tokens for this session */
+    totalInputTokens: number;
+}
+/**
+ * Session Pool configuration
+ */
+export interface SessionPoolConfig {
+    /** Session timeout in milliseconds (default: 30 minutes) */
+    sessionTimeoutMs?: number;
+    /** Maximum sessions to keep in pool (default: 100) */
+    maxSessions?: number;
+    /** Cleanup interval in milliseconds (default: 5 minutes) */
+    cleanupIntervalMs?: number;
+}
+/**
+ * Session Pool for Claude CLI session management
+ *
+ * Key design:
+ * - Channel key format: "{source}:{channelId}" (e.g., "discord:123456")
+ * - Sessions expire after timeout (default 30 min)
+ * - Automatic cleanup of stale sessions
+ */
+export declare class SessionPool {
+    private sessions;
+    private config;
+    private cleanupTimer;
+    constructor(config?: SessionPoolConfig);
+    /**
+     * Get or create session ID for a channel
+     *
+     * With --no-session-persistence flag, Claude CLI doesn't lock session IDs.
+     * This allows session reuse for conversation continuity.
+     *
+     * Auto-resets session when context window reaches 80% (160K tokens).
+     *
+     * @param channelKey - Channel identifier (format: "{source}:{channelId}")
+     * @returns Object with sessionId and isNew flag
+     */
+    getSession(channelKey: string): {
+        sessionId: string;
+        isNew: boolean;
+    };
+    /**
+     * Update token usage for a session
+     * Called after each Claude CLI response
+     *
+     * @param channelKey - Channel identifier
+     * @param inputTokens - Input tokens from this request
+     * @returns Current total tokens and whether threshold is approaching
+     */
+    updateTokens(channelKey: string, inputTokens: number): {
+        totalTokens: number;
+        nearThreshold: boolean;
+    };
+    /**
+     * Get current token usage for a session
+     */
+    getTokenUsage(channelKey: string): number;
+    /**
+     * Legacy method for backward compatibility
+     * @deprecated Use getSession() instead
+     */
+    getSessionId(channelKey: string): string;
+    /**
+     * Release a session after use (no-op since we use fresh sessions)
+     */
+    releaseSession(_channelKey: string): void;
+    /**
+     * Create a new session for a channel
+     */
+    private createSession;
+    /**
+     * Force create a new session (for /clear command)
+     */
+    resetSession(channelKey: string): string;
+    /**
+     * Check if a session exists and is active
+     */
+    hasActiveSession(channelKey: string): boolean;
+    /**
+     * Get session info for a channel
+     */
+    getSessionInfo(channelKey: string): SessionEntry | null;
+    /**
+     * Get all active sessions (for debugging/monitoring)
+     */
+    listSessions(): Map<string, SessionEntry>;
+    /**
+     * Get active session count
+     */
+    getActiveSessionCount(): number;
+    /**
+     * Evict the oldest (least recently used) session
+     */
+    private evictOldestSession;
+    /**
+     * Clean up expired sessions
+     */
+    cleanup(): number;
+    /**
+     * Start periodic cleanup timer
+     */
+    private startCleanupTimer;
+    /**
+     * Stop cleanup timer and clear all sessions
+     */
+    dispose(): void;
+}
+/**
+ * Get global session pool instance
+ */
+export declare function getSessionPool(): SessionPool;
+/**
+ * Set global session pool instance (for testing)
+ */
+export declare function setSessionPool(pool: SessionPool): void;
+/**
+ * Build channel key from source and channel ID
+ */
+export declare function buildChannelKey(source: string, channelId: string): string;
+export {};
+//# sourceMappingURL=session-pool.d.ts.map

package/dist/agent/session-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-pool.d.ts","sourceRoot":"","sources":["../../src/agent/session-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;GAEG;AACH,UAAU,YAAY;IACpB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,KAAK,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAQD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAMD;;;;;;;GAOG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,YAAY,CAA+B;gBAEvC,MAAM,GAAE,iBAAsB;IAW1C;;;;;;;;;;OAUG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE;IAkCrE;;;;;;;OAOG;IACH,YAAY,CACV,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE;IAqBlD;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAKzC;;;OAGG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAIxC;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKzC;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAKxC;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAQ7C;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAIvD;;OAEG;IACH,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAIzC;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAI/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;OAEG;IACH,OAAO,IAAI,MAAM;IAkBjB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB;AAOD;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAK5C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAEtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzE"}