@animus-labs/cortex 0.2.0

package/dist/mcp-client.js

@@ -0,0 +1,474 @@
+/**
+ * McpClientManager: connects to MCP servers and wraps discovered tools
+ * as AgentTool objects for registration with pi-agent-core.
+ *
+ * Handles two transport types:
+ * - Stdio: spawns a subprocess, communicates via stdin/stdout
+ * - HTTP: connects to an already-running Streamable HTTP server
+ *
+ * Tool discovery via tools/list, tool execution via tools/call.
+ * Connections are persistent (kept alive between ticks) with health monitoring.
+ * Reconnect on subprocess crash (3 attempts before deregistering).
+ *
+ * References:
+ *   - docs/cortex/mcp-integration.md
+ *   - docs/cortex/plans/phase-3-plugin-tools.md
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { Type } from 'typebox';
+import { NOOP_LOGGER } from './noop-logger.js';
+import { buildSafeEnv } from './tools/shared/safe-env.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const MAX_RECONNECT_ATTEMPTS = 3;
+// ---------------------------------------------------------------------------
+// McpClientManager
+// ---------------------------------------------------------------------------
+export class McpClientManager {
+    connections = new Map();
+    /**
+     * Callback invoked whenever the aggregate tool set changes.
+     * CortexAgent uses this to resync live tools after connect/disconnect/reconnect.
+     */
+    onToolsChanged;
+    /**
+     * Callback invoked when a subprocess is spawned (for PID tracking).
+     * The consumer (CortexAgent) uses this to track PIDs for exit cleanup.
+     */
+    onSubprocessSpawned;
+    /**
+     * Callback invoked when a subprocess exits (for PID tracking).
+     */
+    onSubprocessExited;
+    /**
+     * Consumer-set environment variable overrides that bypass the security blocklist.
+     * Merged ON TOP of the sanitized environment for all stdio subprocesses.
+     * Used for macOS dock icon suppression vars (DYLD_INSERT_LIBRARIES, etc.).
+     */
+    envOverrides;
+    /** Logger for MCP diagnostics. Set by CortexAgent after construction. */
+    logger = NOOP_LOGGER;
+    /**
+     * Connect to an MCP server and discover its tools.
+     *
+     * Spawns a subprocess (stdio) or connects to a URL (http), performs
+     * the MCP handshake, calls tools/list, and wraps each discovered
+     * tool as an AgentTool with namespaced name.
+     *
+     * @param serverName - Unique name for this server (used for tool namespacing)
+     * @param config - Transport configuration
+     * @throws Error if connection or tool discovery fails
+     */
+    async connect(serverName, config) {
+        // Disconnect existing connection with this name first
+        if (this.connections.has(serverName)) {
+            await this.disconnect(serverName);
+        }
+        this.logger.info('[MCP] connecting', { serverName, transport: config.transport });
+        const transport = this.createTransport(config);
+        const client = new Client({ name: `cortex-${serverName}`, version: '1.0.0' }, { capabilities: {} });
+        try {
+            await client.connect(transport);
+        }
+        catch (err) {
+            this.logger.error('[MCP] connection failed', { serverName, error: err instanceof Error ? err.message : String(err) });
+            throw new Error(`MCP connection failed for "${serverName}": ${err instanceof Error ? err.message : String(err)}`);
+        }
+        // Track subprocess PID for stdio transports
+        let pid = null;
+        if (transport instanceof StdioClientTransport) {
+            pid = transport.pid;
+            if (pid != null) {
+                this.onSubprocessSpawned?.(pid);
+            }
+        }
+        // Discover tools
+        let tools;
+        try {
+            tools = await this.discoverTools(serverName, client);
+        }
+        catch (err) {
+            this.logger.error('[MCP] tool discovery failed', { serverName, error: err instanceof Error ? err.message : String(err) });
+            // Close the connection since tool discovery failed
+            try {
+                await client.close();
+            }
+            catch {
+                // Best-effort cleanup
+            }
+            if (pid != null) {
+                this.onSubprocessExited?.(pid);
+            }
+            throw new Error(`MCP tool discovery failed for "${serverName}": ${err instanceof Error ? err.message : String(err)}`);
+        }
+        const connection = {
+            serverName,
+            config,
+            client,
+            transport,
+            tools,
+            connected: true,
+            reconnectAttempts: 0,
+            pid,
+        };
+        // Wire close handler for reconnect on unexpected disconnect
+        transport.onclose = () => {
+            this.handleDisconnect(serverName);
+        };
+        this.connections.set(serverName, connection);
+        this.logger.info('[MCP] connected', { serverName, toolCount: tools.length, tools: tools.map(t => t.name) });
+        this.onToolsChanged?.();
+    }
+    /**
+     * Disconnect from a specific MCP server.
+     * Closes the transport and removes all tools from that server.
+     *
+     * @param serverName - The server name to disconnect
+     */
+    async disconnect(serverName) {
+        const conn = this.connections.get(serverName);
+        if (!conn)
+            return;
+        this.logger.info('[MCP] disconnecting', { serverName });
+        conn.connected = false;
+        try {
+            await conn.client.close();
+        }
+        catch (err) {
+            this.logger.warn('[MCP] error closing client', { serverName, error: err instanceof Error ? err.message : String(err) });
+        }
+        if (conn.pid != null) {
+            this.onSubprocessExited?.(conn.pid);
+        }
+        this.connections.delete(serverName);
+        this.onToolsChanged?.();
+    }
+    /**
+     * Close all MCP connections.
+     * Kills all stdio subprocesses and closes HTTP connections.
+     */
+    async closeAll() {
+        const names = [...this.connections.keys()];
+        const results = await Promise.allSettled(names.map(name => this.disconnect(name)));
+        for (let i = 0; i < results.length; i++) {
+            const result = results[i];
+            if (result.status === 'rejected') {
+                this.logger.warn('[MCP] failed to disconnect', { serverName: names[i], error: String(result.reason) });
+            }
+        }
+    }
+    /**
+     * Get all AgentTool objects from all connected MCP servers.
+     * Returns tools namespaced as serverName__toolName.
+     */
+    getTools() {
+        const allTools = [];
+        for (const conn of this.connections.values()) {
+            if (conn.connected) {
+                allTools.push(...conn.tools);
+            }
+        }
+        return allTools;
+    }
+    /**
+     * Get tool names from a specific server.
+     */
+    getServerToolNames(serverName) {
+        const conn = this.connections.get(serverName);
+        if (!conn || !conn.connected)
+            return [];
+        return conn.tools.map(t => t.name);
+    }
+    /**
+     * Get the connection state for all servers.
+     */
+    getConnectionStates() {
+        const states = [];
+        for (const conn of this.connections.values()) {
+            states.push({
+                serverName: conn.serverName,
+                config: conn.config,
+                connected: conn.connected,
+                reconnectAttempts: conn.reconnectAttempts,
+                toolNames: conn.tools.map(t => t.name),
+            });
+        }
+        return states;
+    }
+    /**
+     * Check if a specific server is connected.
+     */
+    isConnected(serverName) {
+        const conn = this.connections.get(serverName);
+        return conn?.connected ?? false;
+    }
+    /**
+     * Get the number of active connections.
+     */
+    get connectionCount() {
+        let count = 0;
+        for (const conn of this.connections.values()) {
+            if (conn.connected)
+                count++;
+        }
+        return count;
+    }
+    // -----------------------------------------------------------------------
+    // Private: Transport creation
+    // -----------------------------------------------------------------------
+    createTransport(config) {
+        if (config.transport === 'stdio') {
+            return this.createStdioTransport(config);
+        }
+        return this.createHttpTransport(config);
+    }
+    createStdioTransport(config) {
+        // Sanitize environment variables for the subprocess.
+        // Strip dangerous vars (LD_PRELOAD, NODE_OPTIONS, etc.) to prevent
+        // injection via environment. Uses the same blocklist as the Bash tool.
+        // envOverrides are merged ON TOP, bypassing the blocklist for
+        // consumer-specified variables (e.g., macOS dock icon suppression).
+        const baseEnv = config.env ?? process.env;
+        const safeEnv = buildSafeEnv(baseEnv, undefined, this.envOverrides);
+        // Build params object, only including defined optional fields to satisfy
+        // exactOptionalPropertyTypes
+        const params = {
+            command: config.command,
+            args: config.args ?? [],
+            env: safeEnv,
+            stderr: 'pipe',
+        };
+        if (config.cwd !== undefined)
+            params.cwd = config.cwd;
+        return new StdioClientTransport(params);
+    }
+    createHttpTransport(config) {
+        const url = new URL(config.url);
+        if (config.headers && Object.keys(config.headers).length > 0) {
+            return new StreamableHTTPClientTransport(url, {
+                requestInit: {
+                    headers: config.headers,
+                },
+            });
+        }
+        return new StreamableHTTPClientTransport(url);
+    }
+    // -----------------------------------------------------------------------
+    // Private: Tool discovery and wrapping
+    // -----------------------------------------------------------------------
+    /**
+     * Discover tools from a connected MCP server and wrap them as AgentTools.
+     */
+    async discoverTools(serverName, client) {
+        const response = await client.listTools();
+        const tools = [];
+        for (const mcpTool of response.tools) {
+            tools.push(this.wrapMcpTool(serverName, {
+                name: mcpTool.name,
+                description: mcpTool.description,
+                inputSchema: mcpTool.inputSchema,
+            }, client));
+        }
+        return tools;
+    }
+    /**
+     * Wrap a single MCP tool definition as an AgentTool.
+     *
+     * Key details:
+     * - Name is prefixed with serverName__ for namespacing
+     * - JSON Schema from MCP is wrapped via Type.Unsafe() for TypeBox
+     * - execute() calls tools/call on the MCP connection using the original name
+     * - Errors are caught and returned as error results (not thrown)
+     */
+    wrapMcpTool(serverName, mcpTool, client) {
+        const namespacedName = `${serverName}__${mcpTool.name}`;
+        // Wrap the MCP JSON Schema as a TypeBox type via Type.Unsafe()
+        const inputSchema = mcpTool.inputSchema ?? { type: 'object', properties: {} };
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const parameters = Type.Unsafe(inputSchema);
+        return {
+            name: namespacedName,
+            description: mcpTool.description ?? '',
+            parameters,
+            // Marks this tool as MCP-sourced so CortexAgent's deferred-tool
+            // partitioning can identify it without rechecking by name prefix.
+            isMcp: true,
+            execute: async (args) => {
+                try {
+                    const result = await client.callTool({
+                        name: mcpTool.name, // Original name (no prefix)
+                        arguments: (args ?? {}),
+                    });
+                    // Return text content from MCP result
+                    if (result.isError) {
+                        const errorText = Array.isArray(result.content)
+                            ? result.content
+                                .filter((c) => typeof c === 'object' && c !== null && 'type' in c && c.type === 'text')
+                                .map(c => c.text)
+                                .join('\n')
+                            : String(result.content);
+                        throw new Error(errorText || 'MCP tool call failed');
+                    }
+                    const normalizedContent = [];
+                    if (Array.isArray(result.content)) {
+                        for (const item of result.content) {
+                            if (!item || typeof item !== 'object') {
+                                normalizedContent.push({ type: 'text', text: String(item) });
+                                continue;
+                            }
+                            const block = item;
+                            const type = block['type'];
+                            if (type === 'text' && typeof block['text'] === 'string') {
+                                normalizedContent.push({ type: 'text', text: block['text'] });
+                                continue;
+                            }
+                            if (type === 'image' &&
+                                typeof block['data'] === 'string' &&
+                                typeof block['mimeType'] === 'string') {
+                                normalizedContent.push({
+                                    type: 'image',
+                                    data: block['data'],
+                                    mimeType: block['mimeType'],
+                                });
+                                continue;
+                            }
+                            normalizedContent.push({
+                                type: 'text',
+                                text: JSON.stringify(block, null, 2),
+                            });
+                        }
+                    }
+                    if (normalizedContent.length === 0) {
+                        const structuredContent = result['structuredContent'];
+                        if (structuredContent !== undefined) {
+                            normalizedContent.push({
+                                type: 'text',
+                                text: JSON.stringify(structuredContent, null, 2),
+                            });
+                        }
+                        else {
+                            normalizedContent.push({
+                                type: 'text',
+                                text: String(result.content ?? ''),
+                            });
+                        }
+                    }
+                    return {
+                        content: normalizedContent,
+                        details: {
+                            structuredContent: result['structuredContent'] ?? null,
+                            rawContent: result.content ?? null,
+                        },
+                    };
+                }
+                catch (err) {
+                    // Re-throw as a standard error for pi-agent-core to handle
+                    if (err instanceof Error)
+                        throw err;
+                    throw new Error(`MCP tool call "${mcpTool.name}" failed: ${String(err)}`);
+                }
+            },
+        };
+    }
+    // -----------------------------------------------------------------------
+    // Private: Reconnect handling
+    // -----------------------------------------------------------------------
+    /**
+     * Handle unexpected disconnection from an MCP server.
+     * Attempts reconnection up to MAX_RECONNECT_ATTEMPTS times.
+     */
+    handleDisconnect(serverName) {
+        const conn = this.connections.get(serverName);
+        if (!conn)
+            return;
+        // Already disconnected intentionally
+        if (!conn.connected)
+            return;
+        conn.connected = false;
+        conn.reconnectAttempts++;
+        if (conn.pid != null) {
+            this.onSubprocessExited?.(conn.pid);
+            conn.pid = null;
+        }
+        this.logger.warn('[MCP] unexpected disconnect', { serverName, attempt: conn.reconnectAttempts, maxAttempts: MAX_RECONNECT_ATTEMPTS });
+        if (conn.reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {
+            this.logger.error('[MCP] reconnect exhausted, deregistering', { serverName, maxAttempts: MAX_RECONNECT_ATTEMPTS });
+            this.connections.delete(serverName);
+            this.onToolsChanged?.();
+            return;
+        }
+        // Attempt reconnect asynchronously
+        this.attemptReconnect(serverName, conn.config).catch((err) => {
+            this.logger.error('[MCP] reconnect attempt failed', { serverName, error: err instanceof Error ? err.message : String(err) });
+        });
+    }
+    /**
+     * Attempt to reconnect to an MCP server.
+     */
+    async attemptReconnect(serverName, config) {
+        // Brief delay before reconnect
+        await new Promise(resolve => setTimeout(resolve, 1000));
+        const existing = this.connections.get(serverName);
+        if (!existing)
+            return; // Was deregistered during delay
+        let client = null;
+        let pid = null;
+        try {
+            // Attempt fresh connection
+            const transport = this.createTransport(config);
+            client = new Client({ name: `cortex-${serverName}`, version: '1.0.0' }, { capabilities: {} });
+            await client.connect(transport);
+            // Track subprocess PID
+            if (transport instanceof StdioClientTransport) {
+                pid = transport.pid;
+                if (pid != null) {
+                    this.onSubprocessSpawned?.(pid);
+                }
+            }
+            // Rediscover tools
+            const tools = await this.discoverTools(serverName, client);
+            // Wire close handler
+            transport.onclose = () => {
+                this.handleDisconnect(serverName);
+            };
+            // Update connection record
+            existing.client = client;
+            existing.transport = transport;
+            existing.tools = tools;
+            existing.connected = true;
+            existing.pid = pid;
+            // Keep reconnectAttempts as-is (reset only on fresh connect)
+            this.logger.info('[MCP] reconnected', { serverName, toolCount: tools.length });
+            this.onToolsChanged?.();
+        }
+        catch (err) {
+            // Clean up resources from partial connection
+            if (client) {
+                try {
+                    await client.close();
+                }
+                catch { /* best-effort */ }
+            }
+            if (pid != null) {
+                this.onSubprocessExited?.(pid);
+            }
+            this.logger.warn('[MCP] reconnect failed', { serverName, error: err instanceof Error ? err.message : String(err) });
+            existing.reconnectAttempts++;
+            if (existing.reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {
+                this.logger.error('[MCP] max reconnect attempts exceeded, deregistering', { serverName });
+                this.connections.delete(serverName);
+                this.onToolsChanged?.();
+            }
+            else {
+                // Schedule another attempt since transport.onclose may not fire
+                this.attemptReconnect(serverName, config).catch((retryErr) => {
+                    this.logger.error('[MCP] subsequent reconnect failed', { serverName, error: retryErr instanceof Error ? retryErr.message : String(retryErr) });
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/mcp-client.js.map

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

package/dist/model-wrapper.d.ts

@@ -0,0 +1,58 @@
+/**
+ * CortexModel: branded opaque type for type-safe model passing.
+ *
+ * Wraps pi-ai's Model<any> with a branded type to prevent consumers
+ * from accidentally passing raw pi-ai models where cortex models
+ * are expected (and vice versa).
+ *
+ * The consumer can read provider, modelId, and contextWindow for
+ * display and configuration. The underlying pi-ai Model object is
+ * accessed internally by CortexAgent when constructing the
+ * pi-agent-core Agent.
+ *
+ * Reference: provider-manager.md
+ */
+/**
+ * Opaque model handle. The consumer receives this from ProviderManager
+ * and passes it to CortexAgent. The consumer never inspects its internals
+ * beyond the declared fields.
+ *
+ * Internally, this wraps pi-ai's Model<T> type.
+ */
+export interface CortexModel {
+    /** @internal Brand tag for nominal type safety. */
+    readonly __brand: 'CortexModel';
+    /** Provider identifier (e.g., 'anthropic', 'openai', 'google'). */
+    readonly provider: string;
+    /** Model identifier (e.g., 'claude-sonnet-4-20250514'). */
+    readonly modelId: string;
+    /** Context window size in tokens. */
+    readonly contextWindow: number;
+}
+/**
+ * Wrap a pi-ai Model object into a CortexModel.
+ *
+ * @param model - The pi-ai Model object to wrap
+ * @param provider - The provider identifier
+ * @param modelId - The model identifier
+ * @param contextWindow - The context window size (default: 200000)
+ * @returns An opaque CortexModel handle
+ */
+export declare function wrapModel(model: unknown, provider: string, modelId: string, contextWindow?: number): CortexModel;
+/**
+ * Unwrap a CortexModel to retrieve the underlying pi-ai Model object.
+ *
+ * @param cortexModel - The CortexModel to unwrap
+ * @returns The underlying pi-ai Model object
+ * @throws Error if the object is not a valid CortexModel
+ */
+export declare function unwrapModel(cortexModel: CortexModel): unknown;
+/**
+ * Check whether a value is a valid CortexModel (has the correct brand
+ * and contains a wrapped inner model).
+ *
+ * @param value - The value to check
+ * @returns True if the value is a valid CortexModel
+ */
+export declare function isCortexModel(value: unknown): value is CortexModel;
+//# sourceMappingURL=model-wrapper.d.ts.map

package/dist/model-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-wrapper.d.ts","sourceRoot":"","sources":["../src/model-wrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAiBD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GACrB,WAAW,CASb;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAK7D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAUlE"}

package/dist/model-wrapper.js

@@ -0,0 +1,86 @@
+/**
+ * CortexModel: branded opaque type for type-safe model passing.
+ *
+ * Wraps pi-ai's Model<any> with a branded type to prevent consumers
+ * from accidentally passing raw pi-ai models where cortex models
+ * are expected (and vice versa).
+ *
+ * The consumer can read provider, modelId, and contextWindow for
+ * display and configuration. The underlying pi-ai Model object is
+ * accessed internally by CortexAgent when constructing the
+ * pi-agent-core Agent.
+ *
+ * Reference: provider-manager.md
+ */
+// The symbol key used to store the underlying pi-ai model.
+const INNER_MODEL = Symbol.for('cortex.innerModel');
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Wrap a pi-ai Model object into a CortexModel.
+ *
+ * @param model - The pi-ai Model object to wrap
+ * @param provider - The provider identifier
+ * @param modelId - The model identifier
+ * @param contextWindow - The context window size (default: 200000)
+ * @returns An opaque CortexModel handle
+ */
+export function wrapModel(model, provider, modelId, contextWindow) {
+    const wrapped = {
+        __brand: 'CortexModel',
+        provider,
+        modelId,
+        contextWindow: contextWindow ?? extractContextWindow(model) ?? 200_000,
+        [INNER_MODEL]: model,
+    };
+    return wrapped;
+}
+/**
+ * Unwrap a CortexModel to retrieve the underlying pi-ai Model object.
+ *
+ * @param cortexModel - The CortexModel to unwrap
+ * @returns The underlying pi-ai Model object
+ * @throws Error if the object is not a valid CortexModel
+ */
+export function unwrapModel(cortexModel) {
+    if (!isCortexModel(cortexModel)) {
+        throw new Error('Expected a CortexModel created by wrapModel()');
+    }
+    return cortexModel[INNER_MODEL];
+}
+/**
+ * Check whether a value is a valid CortexModel (has the correct brand
+ * and contains a wrapped inner model).
+ *
+ * @param value - The value to check
+ * @returns True if the value is a valid CortexModel
+ */
+export function isCortexModel(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const obj = value;
+    return (obj['__brand'] === 'CortexModel' &&
+        typeof obj['provider'] === 'string' &&
+        typeof obj['modelId'] === 'string' &&
+        typeof obj['contextWindow'] === 'number' &&
+        INNER_MODEL in obj);
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Attempt to extract the context window size from a pi-ai Model object.
+ * Pi-ai models expose contextWindow as a property.
+ */
+function extractContextWindow(model) {
+    if (model && typeof model === 'object') {
+        const obj = model;
+        const cw = obj['contextWindow'];
+        if (typeof cw === 'number') {
+            return cw;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=model-wrapper.js.map

package/dist/model-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-wrapper.js","sourceRoot":"","sources":["../src/model-wrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAwBH,2DAA2D;AAC3D,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAUpD,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CACvB,KAAc,EACd,QAAgB,EAChB,OAAe,EACf,aAAsB;IAEtB,MAAM,OAAO,GAAiB;QAC5B,OAAO,EAAE,aAAsB;QAC/B,QAAQ;QACR,OAAO;QACP,aAAa,EAAE,aAAa,IAAI,oBAAoB,CAAC,KAAK,CAAC,IAAI,OAAO;QACtE,CAAC,WAAW,CAAC,EAAE,KAAK;KACrB,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,WAAwB;IAClD,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,OAAQ,WAA4B,CAAC,WAAW,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,GAAG,GAAG,KAAyC,CAAC;IACtD,OAAO,CACL,GAAG,CAAC,SAAS,CAAC,KAAK,aAAa;QAChC,OAAO,GAAG,CAAC,UAAU,CAAC,KAAK,QAAQ;QACnC,OAAO,GAAG,CAAC,SAAS,CAAC,KAAK,QAAQ;QAClC,OAAO,GAAG,CAAC,eAAe,CAAC,KAAK,QAAQ;QACxC,WAAW,IAAI,GAAG,CACnB,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,oBAAoB,CAAC,KAAc;IAC1C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,MAAM,EAAE,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC;QAChC,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC3B,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/noop-logger.d.ts

@@ -0,0 +1,4 @@
+import type { CortexLogger } from './types.js';
+/** Silent logger used when no consumer logger is provided. */
+export declare const NOOP_LOGGER: CortexLogger;
+//# sourceMappingURL=noop-logger.d.ts.map

package/dist/noop-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-logger.d.ts","sourceRoot":"","sources":["../src/noop-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,8DAA8D;AAC9D,eAAO,MAAM,WAAW,EAAE,YAKzB,CAAC"}

package/dist/noop-logger.js

@@ -0,0 +1,8 @@
+/** Silent logger used when no consumer logger is provided. */
+export const NOOP_LOGGER = {
+    debug() { },
+    info() { },
+    warn() { },
+    error() { },
+};
+//# sourceMappingURL=noop-logger.js.map