@animus-labs/cortex 0.2.0

package/dist/event-bridge.js

@@ -0,0 +1,381 @@
+/**
+ * Event bridge: maps pi-agent-core events to normalized consumer events.
+ *
+ * Pi-agent-core emits 10 events across 4 scopes (agent, turn, message, tool).
+ * The event bridge normalizes these into a consumer-facing event stream for
+ * logging, monitoring, and lifecycle hooks.
+ *
+ * Key mappings:
+ *   agent_start  -> loop_start
+ *   agent_end    -> loop_end (onLoopComplete fires here)
+ *   turn_start   -> turn_start
+ *   turn_end     -> turn_end + AgentTextOutput (parse working tags)
+ *   message_start  -> response_start
+ *   message_update -> response_chunk
+ *   message_end    -> response_end
+ *   tool_execution_start  -> tool_call_start
+ *   tool_execution_update -> tool_call_update
+ *   tool_execution_end    -> tool_call_end
+ *
+ * Child event forwarding:
+ *   forwardFrom(childBridge, childTaskId) subscribes to a child agent's
+ *   event bridge and re-emits events on this bridge with childTaskId set.
+ *   Consumers use event.childTaskId to distinguish parent vs child events.
+ *
+ * Reference: cortex-architecture.md (Event Bridge section)
+ */
+import { NOOP_LOGGER } from './noop-logger.js';
+import { parseWorkingTags } from './working-tags.js';
+// ---------------------------------------------------------------------------
+// Event type mapping
+// ---------------------------------------------------------------------------
+const PI_TO_CORTEX_MAP = {
+    agent_start: 'loop_start',
+    agent_end: 'loop_end',
+    turn_start: 'turn_start',
+    turn_end: 'turn_end',
+    message_start: 'response_start',
+    message_update: 'response_chunk',
+    message_end: 'response_end',
+    tool_execution_start: 'tool_call_start',
+    tool_execution_update: 'tool_call_update',
+    tool_execution_end: 'tool_call_end',
+};
+// ---------------------------------------------------------------------------
+// EventBridge
+// ---------------------------------------------------------------------------
+export class EventBridge {
+    listeners = new Map();
+    allListeners = new Set();
+    unsubscribeFromPi = null;
+    workingTagsEnabled;
+    logger;
+    /**
+     * Create an EventBridge.
+     *
+     * @param workingTagsEnabled - Whether to parse working tags on turn_end
+     * @param logger - Optional logger for diagnostics (defaults to silent no-op)
+     */
+    constructor(workingTagsEnabled = true, logger) {
+        this.workingTagsEnabled = workingTagsEnabled;
+        this.logger = logger ?? NOOP_LOGGER;
+    }
+    /**
+     * Wire the bridge to a pi-agent-core Agent's event stream.
+     * Stores the unsubscribe function for cleanup.
+     *
+     * @param source - The pi-agent-core Agent (or any PiEventSource)
+     */
+    wire(source) {
+        // Clean up previous wiring if any
+        this.unwire();
+        this.unsubscribeFromPi = source.subscribe((piEvent) => {
+            this.handlePiEvent(piEvent);
+        });
+    }
+    /**
+     * Disconnect from the pi-agent-core event stream.
+     */
+    unwire() {
+        if (this.unsubscribeFromPi) {
+            this.unsubscribeFromPi();
+            this.unsubscribeFromPi = null;
+        }
+    }
+    /**
+     * Register a listener for a specific event type.
+     *
+     * @param type - The event type to listen for
+     * @param listener - The callback function
+     * @returns An unsubscribe function
+     */
+    on(type, listener) {
+        let typeListeners = this.listeners.get(type);
+        if (!typeListeners) {
+            typeListeners = new Set();
+            this.listeners.set(type, typeListeners);
+        }
+        typeListeners.add(listener);
+        return () => {
+            typeListeners.delete(listener);
+        };
+    }
+    /**
+     * Register a listener for all event types.
+     *
+     * @param listener - The callback function
+     * @returns An unsubscribe function
+     */
+    onAll(listener) {
+        this.allListeners.add(listener);
+        return () => {
+            this.allListeners.delete(listener);
+        };
+    }
+    /**
+     * Forward all events from a child agent's event bridge onto this bridge.
+     *
+     * Each forwarded event gets `childTaskId` set so consumers can distinguish
+     * parent events from child events. Returns an unsubscribe function that
+     * stops forwarding (call when the child agent completes or is destroyed).
+     *
+     * @param childBridge - The child agent's EventBridge
+     * @param childTaskId - The sub-agent task ID to tag forwarded events with
+     * @returns An unsubscribe function
+     */
+    forwardFrom(childBridge, childTaskId) {
+        return childBridge.onAll((event) => {
+            this.emit({
+                ...event,
+                childTaskId,
+            });
+        });
+    }
+    /**
+     * Update whether working tags parsing is enabled.
+     */
+    setWorkingTagsEnabled(enabled) {
+        this.workingTagsEnabled = enabled;
+    }
+    /**
+     * Clean up all listeners and disconnect from the pi-agent-core event stream.
+     */
+    destroy() {
+        this.unwire();
+        this.listeners.clear();
+        this.allListeners.clear();
+    }
+    /**
+     * Handle a pi-agent-core event by mapping and emitting to consumers.
+     */
+    handlePiEvent(piEvent) {
+        const cortexType = PI_TO_CORTEX_MAP[piEvent.type];
+        if (!cortexType) {
+            return;
+        }
+        const cortexEvent = {
+            type: cortexType,
+            data: piEvent,
+        };
+        // Populate typed payload for tool events
+        const payload = this.extractToolPayload(cortexType, piEvent);
+        if (payload) {
+            cortexEvent.payload = payload;
+        }
+        // For turn_end, extract typed usage and parse working tags
+        if (cortexType === 'turn_end') {
+            const usage = this.extractUsage(piEvent);
+            if (usage) {
+                cortexEvent.usage = usage;
+            }
+            if (this.workingTagsEnabled) {
+                const text = this.extractTurnText(piEvent);
+                if (text) {
+                    cortexEvent.textOutput = parseWorkingTags(text);
+                }
+            }
+        }
+        this.emit(cortexEvent);
+    }
+    /**
+     * Extract a typed payload from a pi-agent-core tool event.
+     * Returns undefined for non-tool events.
+     */
+    extractToolPayload(cortexType, piEvent) {
+        if (cortexType === 'tool_call_start') {
+            return {
+                toolCallId: String(piEvent['toolCallId'] ?? piEvent['id'] ?? ''),
+                toolName: String(piEvent['toolName'] ?? piEvent['name'] ?? 'unknown'),
+                args: (piEvent['args'] ?? piEvent['input'] ?? {}),
+            };
+        }
+        if (cortexType === 'tool_call_update') {
+            const partialResult = piEvent['partialResult'];
+            return {
+                toolCallId: String(piEvent['toolCallId'] ?? piEvent['id'] ?? ''),
+                toolName: String(piEvent['toolName'] ?? piEvent['name'] ?? 'unknown'),
+                args: (piEvent['args'] ?? piEvent['input'] ?? {}),
+                partialResult: partialResult ?? { content: [], details: {} },
+            };
+        }
+        if (cortexType === 'tool_call_end') {
+            const result = piEvent['result'];
+            const isError = Boolean(piEvent['isError']);
+            const explicitError = piEvent['error'];
+            const payload = {
+                toolCallId: String(piEvent['toolCallId'] ?? piEvent['id'] ?? ''),
+                toolName: String(piEvent['toolName'] ?? piEvent['name'] ?? 'unknown'),
+                result: result ?? { content: [], details: {} },
+                durationMs: Number(piEvent['durationMs'] ?? piEvent['duration'] ?? 0),
+                isError,
+            };
+            if (isError) {
+                // Extract error text from multiple possible sources:
+                // 1. Explicit error string field
+                // 2. Error object with message
+                // 3. Result content text (pi-agent-core puts error details here)
+                // 4. Fallback
+                let errorText;
+                if (typeof explicitError === 'string') {
+                    errorText = explicitError;
+                }
+                else if (explicitError instanceof Error) {
+                    errorText = explicitError.message;
+                }
+                else if (typeof explicitError === 'object' && explicitError !== null && 'message' in explicitError) {
+                    errorText = String(explicitError['message']);
+                }
+                // If no explicit error, extract from result content
+                if (!errorText && result?.content) {
+                    const textParts = result.content
+                        .filter((c) => c.type === 'text')
+                        .map(c => c.text);
+                    if (textParts.length > 0) {
+                        errorText = textParts.join('\n');
+                    }
+                }
+                payload.error = errorText ?? 'unknown error';
+            }
+            return payload;
+        }
+        return undefined;
+    }
+    /**
+     * Extract the text content from a turn_end event.
+     * Pi-agent-core's turn_end event carries the assistant message for that turn.
+     */
+    extractTurnText(piEvent) {
+        // The turn_end event from pi-agent-core carries the assistant message.
+        // The structure varies, so we try multiple access patterns.
+        // Pattern 1: Direct text property
+        if (typeof piEvent['text'] === 'string') {
+            return piEvent['text'];
+        }
+        // Pattern 2: message.content as string
+        const message = piEvent['message'];
+        if (message && typeof message['content'] === 'string') {
+            return message['content'];
+        }
+        // Pattern 3: message.content as array with text parts
+        if (message && Array.isArray(message['content'])) {
+            const textParts = message['content']
+                .filter((part) => part.type === 'text' && typeof part.text === 'string')
+                .map((part) => part.text);
+            if (textParts.length > 0) {
+                return textParts.join('');
+            }
+        }
+        // Pattern 4: result.content
+        const result = piEvent['result'];
+        if (result && typeof result['content'] === 'string') {
+            return result['content'];
+        }
+        // Pattern 5: content on the content parts of the result
+        if (result && Array.isArray(result['content'])) {
+            const textParts = result['content']
+                .filter((part) => part.type === 'text' && typeof part.text === 'string')
+                .map((part) => part.text);
+            if (textParts.length > 0) {
+                return textParts.join('');
+            }
+        }
+        return null;
+    }
+    /**
+     * Extract typed CortexUsage from a turn_end event.
+     *
+     * Pi-ai's AssistantMessage carries usage at message.usage with a nested
+     * cost object. This method navigates the opaque event data once so all
+     * subscribers receive clean, typed usage without duplicating extraction.
+     */
+    extractUsage(piEvent) {
+        // Pattern 1: message.usage (pi-ai AssistantMessage, the primary path)
+        const message = piEvent['message'];
+        if (message) {
+            const usage = this.buildUsageFromObject(message['usage']);
+            if (usage) {
+                if (typeof message['model'] === 'string') {
+                    usage.model = message['model'];
+                }
+                return usage;
+            }
+        }
+        // Pattern 2: Direct usage property on the event
+        const directUsage = this.buildUsageFromObject(piEvent['usage']);
+        if (directUsage)
+            return directUsage;
+        // Pattern 3: result.usage
+        const result = piEvent['result'];
+        if (result) {
+            const resultUsage = this.buildUsageFromObject(result['usage']);
+            if (resultUsage)
+                return resultUsage;
+        }
+        return null;
+    }
+    /**
+     * Build a CortexUsage from a raw usage-shaped object.
+     * Returns null if the object is not a valid usage structure.
+     */
+    buildUsageFromObject(raw) {
+        if (!raw || typeof raw !== 'object')
+            return null;
+        const u = raw;
+        const input = typeof u['input'] === 'number' ? u['input'] : 0;
+        const output = typeof u['output'] === 'number' ? u['output'] : 0;
+        const cacheRead = typeof u['cacheRead'] === 'number' ? u['cacheRead'] : 0;
+        const cacheWrite = typeof u['cacheWrite'] === 'number' ? u['cacheWrite'] : 0;
+        const totalTokens = typeof u['totalTokens'] === 'number' ? u['totalTokens'] : input + output;
+        // At least one non-zero field to consider this a valid usage object
+        if (input === 0 && output === 0 && cacheRead === 0 && totalTokens === 0)
+            return null;
+        let cost = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 };
+        const costObj = u['cost'];
+        if (costObj && typeof costObj === 'object') {
+            const c = costObj;
+            cost = {
+                input: typeof c['input'] === 'number' ? c['input'] : 0,
+                output: typeof c['output'] === 'number' ? c['output'] : 0,
+                cacheRead: typeof c['cacheRead'] === 'number' ? c['cacheRead'] : 0,
+                cacheWrite: typeof c['cacheWrite'] === 'number' ? c['cacheWrite'] : 0,
+                total: typeof c['total'] === 'number' ? c['total'] : 0,
+            };
+        }
+        return { input, output, cacheRead, cacheWrite, totalTokens, cost };
+    }
+    /**
+     * Emit a normalized event to all matching listeners.
+     * Each listener is wrapped in try/catch so a throwing listener
+     * does not prevent subsequent listeners from receiving the event.
+     */
+    emit(event) {
+        // Notify type-specific listeners
+        const typeListeners = this.listeners.get(event.type);
+        if (typeListeners) {
+            for (const listener of typeListeners) {
+                try {
+                    listener(event);
+                }
+                catch (err) {
+                    this.logger.error('[EventBridge] listener threw', {
+                        eventType: event.type,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            }
+        }
+        // Notify catch-all listeners
+        for (const listener of this.allListeners) {
+            try {
+                listener(event);
+            }
+            catch (err) {
+                this.logger.error('[EventBridge] catch-all listener threw', {
+                    eventType: event.type,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=event-bridge.js.map

package/dist/event-bridge.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @animus-labs/cortex
+ *
+ * Production-grade agent wrapper for pi-agent-core.
+ * Provides context management, MCP tool support, tool permissions,
+ * budget guards, compaction, skill system, and event logging.
+ *
+ * Phase 1A exports: types and pure utility modules.
+ * Phase 1B exports: CortexAgent, ContextManager, EventBridge, BudgetGuard.
+ * Phase 1C exports: Built-in tools (Read, Write, Edit, Glob, Grep, Bash, TaskOutput, WebFetch).
+ * Phase 1D exports: ProviderManager, model wrapper, provider registry.
+ */
+export type { CortexLogger, CortexUsage, SessionUsage, CortexLifecycleState, CortexToolPermissionDecision, CortexToolPermissionResult, CortexAgentConfig, CortexDiagnosticsConfig, ContextManagerConfig, ErrorCategory, ErrorSeverity, ClassifiedError, AgentTextOutput, ToolContentDetails, BudgetGuardConfig, ToolCategory, MicrocompactionConfig, CompactionConfig, FailsafeConfig, AdaptiveThresholdConfig, CortexCompactionConfig, CompactionTarget, CompactionResult, CompactionDegradedInfo, CompactionExhaustedInfo, PersistResultFn, CortexEvents, UtilityModelDefaults, McpTransportConfig, McpStdioConfig, McpHttpConfig, McpConnectionState, SkillConfig, SkillEntry, LoadedSkill, CortexScriptContext, SubAgentSpawnConfig, SubAgentResult, TrackedSubAgent, ThinkingLevel, ModelThinkingCapabilities, ToolExecuteContext, ToolCallStartPayload, ToolCallUpdatePayload, ToolCallEndPayload, PromptWatchdogDiagnosticsConfig, } from './types.js';
+export { NOOP_LOGGER } from './noop-logger.js';
+export { zodToTypebox } from './schema-converter.js';
+export { estimateTokens } from './token-estimator.js';
+export { stripWorkingTags, extractWorkingContent, parseWorkingTags, } from './working-tags.js';
+export { classifyError } from './error-classifier.js';
+export type { ClassifyErrorOptions } from './error-classifier.js';
+export { ContextManager } from './context-manager.js';
+export type { AgentMessage, AgentStateAccessor, AgentContext, } from './context-manager.js';
+export { EventBridge } from './event-bridge.js';
+export type { CortexEventType, CortexEvent, CortexEventListener, PiEventType, PiEvent, PiEventSource, } from './event-bridge.js';
+export { BudgetGuard } from './budget-guard.js';
+export { CortexAgent, MINIMUM_CONTEXT_WINDOW, TOOL_RESULT_WORKING_TAGS_REMINDER } from './cortex-agent.js';
+export type { PiAgent, PiModel } from './cortex-agent.js';
+export { fromPiAgentTool, assertValidCortexTool } from './tool-contract.js';
+export type { CortexTool, PiAgentTool } from './tool-contract.js';
+export { McpClientManager } from './mcp-client.js';
+export type { AgentTool } from './mcp-client.js';
+export { ReadRegistry, CwdTracker, CortexToolRuntime, BackgroundTaskStore, WebFetchRuntimeState, globalBackgroundTaskStore, attachRuntimeAwareTool, getRuntimeAwareToolMetadata, cloneRuntimeAwareTool, createReadTool, createWriteTool, createEditTool, createGlobTool, createGrepTool, createBashTool, createTaskOutputTool, createWebFetchTool, WebFetchCache, getBackgroundTask, getAllBackgroundTasks, buildSafeEnv, isCriticalPath, classifyCommand, checkObfuscation, stripInvisibleChars, checkScriptPreflight, checkAutoModeClassifier, runSafetyChecks, validateWritePaths, extractWritePaths, TOOL_NAMES, } from './tools/index.js';
+export type { ReadDetails, ReadParamsType, ReadToolConfig, WriteDetails, WriteParamsType, WriteToolConfig, DiffHunk, EditDetails, EditParamsType, EditToolConfig, GlobDetails, GlobParamsType, GlobToolConfig, GrepDetails, GrepParamsType, GrepToolConfig, BashDetails, BashStreamUpdate, BashParamsType, BashToolConfig, BackgroundTask, TaskOutputDetails, TaskOutputParamsType, TaskOutputToolConfig, WebFetchDetails, WebFetchParamsType, WebFetchToolConfig, CacheEntry, CommandClassification, SafetyCheckResult, BuiltInToolName, SubAgentToolConfig, SubAgentDetails, SubAgentParamsType, } from './tools/index.js';
+export { SkillRegistry, parseFrontmatter } from './skill-registry.js';
+export { preprocessSkillBody, substituteVariables, executeShellCommand, executeScript } from './skill-preprocessor.js';
+export { createLoadSkillTool, buildLoadSkillDescription, LOAD_SKILL_TOOL_NAME } from './skill-tool.js';
+export type { LoadSkillToolConfig, LoadSkillParamsType } from './skill-tool.js';
+export { LoadSkillParams } from './skill-tool.js';
+export { SubAgentManager } from './sub-agent-manager.js';
+export type { SubAgentManagerConfig, SubAgentLifecycleHooks } from './sub-agent-manager.js';
+export { DeferredToolRegistry } from './tools/tool-search/registry.js';
+export type { ToolSearchResult } from './tools/tool-search/registry.js';
+export { createToolSearchTool, TOOL_SEARCH_TOOL_NAME, ToolSearchParams, } from './tools/tool-search/index.js';
+export type { ToolSearchToolConfig, ToolSearchDetails, ToolSearchParamsType, } from './tools/tool-search/index.js';
+export type { DeferredToolsConfig } from './types.js';
+export { CompactionManager, buildCompactionConfig, DEFAULT_COMPACTION_CONFIG, ADAPTIVE_DEFAULTS, computeAdaptiveThreshold, MicrocompactionEngine, capToolResult, runCompaction, shouldCompact, partitionHistory, buildSummaryMessage, emergencyTruncate, shouldTruncate, isContextOverflow, } from './compaction/index.js';
+export { applyResultPersistence, processToolResult, resolveThreshold, MAX_RESULT_TOKENS, BOOKEND_CHARS, SKIP_RESULT_PERSISTENCE, DEFAULT_TOOL_THRESHOLDS, } from './tool-result-persistence.js';
+export type { ApplyPersistenceOptions, ProcessResultOptions, } from './tool-result-persistence.js';
+export type { TrimAction, TrimState, CompleteFn, FailsafeTruncationResult, ObservationalMemoryConfig, ObservationalMemoryState, ObservationEvent, ReflectionEvent, RecallConfig, RecallResult, } from './compaction/index.js';
+export { wrapModel, unwrapModel, isCortexModel } from './model-wrapper.js';
+export type { CortexModel } from './model-wrapper.js';
+export { PROVIDER_REGISTRY, OAUTH_PROVIDER_IDS, UTILITY_MODEL_DEFAULTS, PRIMARY_MODEL_DEFAULTS, PROVIDER_CACHE_CONFIG, resolveCacheRetention, } from './provider-registry.js';
+export type { AuthMethod, ProviderInfo, ModelInfo, ProviderCacheConfig, CacheRetention, } from './provider-registry.js';
+export { ProviderManager } from './provider-manager.js';
+export type { IProviderManager, OAuthCallbacks, OAuthMeta, OAuthResult, OAuthRefreshResult, CustomModelConfig, ApiKeyValidationStatus, ApiKeyValidationResult, } from './provider-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,57 @@
+/**
+ * @animus-labs/cortex
+ *
+ * Production-grade agent wrapper for pi-agent-core.
+ * Provides context management, MCP tool support, tool permissions,
+ * budget guards, compaction, skill system, and event logging.
+ *
+ * Phase 1A exports: types and pure utility modules.
+ * Phase 1B exports: CortexAgent, ContextManager, EventBridge, BudgetGuard.
+ * Phase 1C exports: Built-in tools (Read, Write, Edit, Glob, Grep, Bash, TaskOutput, WebFetch).
+ * Phase 1D exports: ProviderManager, model wrapper, provider registry.
+ */
+// Logger
+export { NOOP_LOGGER } from './noop-logger.js';
+// Schema Converter
+export { zodToTypebox } from './schema-converter.js';
+// Token Estimator
+export { estimateTokens } from './token-estimator.js';
+// Working Tags Parser
+export { stripWorkingTags, extractWorkingContent, parseWorkingTags, } from './working-tags.js';
+// Error Classifier
+export { classifyError } from './error-classifier.js';
+// Context Manager (Phase 1B)
+export { ContextManager } from './context-manager.js';
+// Event Bridge (Phase 1B)
+export { EventBridge } from './event-bridge.js';
+// Budget Guard (Phase 1B)
+export { BudgetGuard } from './budget-guard.js';
+// CortexAgent (Phase 1B)
+export { CortexAgent, MINIMUM_CONTEXT_WINDOW, TOOL_RESULT_WORKING_TAGS_REMINDER } from './cortex-agent.js';
+// Tool Contracts
+export { fromPiAgentTool, assertValidCortexTool } from './tool-contract.js';
+// MCP Client Manager (Phase 3)
+export { McpClientManager } from './mcp-client.js';
+// Built-in Tools (Phase 1C)
+export { ReadRegistry, CwdTracker, CortexToolRuntime, BackgroundTaskStore, WebFetchRuntimeState, globalBackgroundTaskStore, attachRuntimeAwareTool, getRuntimeAwareToolMetadata, cloneRuntimeAwareTool, createReadTool, createWriteTool, createEditTool, createGlobTool, createGrepTool, createBashTool, createTaskOutputTool, createWebFetchTool, WebFetchCache, getBackgroundTask, getAllBackgroundTasks, buildSafeEnv, isCriticalPath, classifyCommand, checkObfuscation, stripInvisibleChars, checkScriptPreflight, checkAutoModeClassifier, runSafetyChecks, validateWritePaths, extractWritePaths, TOOL_NAMES, } from './tools/index.js';
+// Skill System (Phase 4)
+export { SkillRegistry, parseFrontmatter } from './skill-registry.js';
+export { preprocessSkillBody, substituteVariables, executeShellCommand, executeScript } from './skill-preprocessor.js';
+export { createLoadSkillTool, buildLoadSkillDescription, LOAD_SKILL_TOOL_NAME } from './skill-tool.js';
+export { LoadSkillParams } from './skill-tool.js';
+// Sub-Agent Manager (Phase 4)
+export { SubAgentManager } from './sub-agent-manager.js';
+// Deferred Tool Loading / ToolSearch
+export { DeferredToolRegistry } from './tools/tool-search/registry.js';
+export { createToolSearchTool, TOOL_SEARCH_TOOL_NAME, ToolSearchParams, } from './tools/tool-search/index.js';
+// Compaction (Phase 5)
+export { CompactionManager, buildCompactionConfig, DEFAULT_COMPACTION_CONFIG, ADAPTIVE_DEFAULTS, computeAdaptiveThreshold, MicrocompactionEngine, capToolResult, runCompaction, shouldCompact, partitionHistory, buildSummaryMessage, emergencyTruncate, shouldTruncate, isContextOverflow, } from './compaction/index.js';
+// Tool Result Persistence (proactive interceptor at the tool execution boundary)
+export { applyResultPersistence, processToolResult, resolveThreshold, MAX_RESULT_TOKENS, BOOKEND_CHARS, SKIP_RESULT_PERSISTENCE, DEFAULT_TOOL_THRESHOLDS, } from './tool-result-persistence.js';
+// Model Wrapper (Phase 1D)
+export { wrapModel, unwrapModel, isCortexModel } from './model-wrapper.js';
+// Provider Registry (Phase 1D)
+export { PROVIDER_REGISTRY, OAUTH_PROVIDER_IDS, UTILITY_MODEL_DEFAULTS, PRIMARY_MODEL_DEFAULTS, PROVIDER_CACHE_CONFIG, resolveCacheRetention, } from './provider-registry.js';
+// Provider Manager (Phase 1D)
+export { ProviderManager } from './provider-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mcp-client.d.ts

@@ -0,0 +1,119 @@
+/**
+ * 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 type { McpTransportConfig, McpConnectionState, CortexLogger } from './types.js';
+import type { CortexTool } from './tool-contract.js';
+/**
+ * Backward-compatible export name for Cortex's canonical tool contract.
+ */
+export type AgentTool = CortexTool;
+export declare class McpClientManager {
+    private connections;
+    /**
+     * Callback invoked whenever the aggregate tool set changes.
+     * CortexAgent uses this to resync live tools after connect/disconnect/reconnect.
+     */
+    onToolsChanged?: () => void;
+    /**
+     * Callback invoked when a subprocess is spawned (for PID tracking).
+     * The consumer (CortexAgent) uses this to track PIDs for exit cleanup.
+     */
+    onSubprocessSpawned?: (pid: number) => void;
+    /**
+     * Callback invoked when a subprocess exits (for PID tracking).
+     */
+    onSubprocessExited?: (pid: number) => void;
+    /**
+     * 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?: Record<string, string>;
+    /** Logger for MCP diagnostics. Set by CortexAgent after construction. */
+    logger: CortexLogger;
+    /**
+     * 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
+     */
+    connect(serverName: string, config: McpTransportConfig): Promise<void>;
+    /**
+     * Disconnect from a specific MCP server.
+     * Closes the transport and removes all tools from that server.
+     *
+     * @param serverName - The server name to disconnect
+     */
+    disconnect(serverName: string): Promise<void>;
+    /**
+     * Close all MCP connections.
+     * Kills all stdio subprocesses and closes HTTP connections.
+     */
+    closeAll(): Promise<void>;
+    /**
+     * Get all AgentTool objects from all connected MCP servers.
+     * Returns tools namespaced as serverName__toolName.
+     */
+    getTools(): AgentTool[];
+    /**
+     * Get tool names from a specific server.
+     */
+    getServerToolNames(serverName: string): string[];
+    /**
+     * Get the connection state for all servers.
+     */
+    getConnectionStates(): McpConnectionState[];
+    /**
+     * Check if a specific server is connected.
+     */
+    isConnected(serverName: string): boolean;
+    /**
+     * Get the number of active connections.
+     */
+    get connectionCount(): number;
+    private createTransport;
+    private createStdioTransport;
+    private createHttpTransport;
+    /**
+     * Discover tools from a connected MCP server and wrap them as AgentTools.
+     */
+    private discoverTools;
+    /**
+     * 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)
+     */
+    private wrapMcpTool;
+    /**
+     * Handle unexpected disconnection from an MCP server.
+     * Attempts reconnection up to MAX_RECONNECT_ATTEMPTS times.
+     */
+    private handleDisconnect;
+    /**
+     * Attempt to reconnect to an MCP server.
+     */
+    private attemptReconnect;
+}
+//# sourceMappingURL=mcp-client.d.ts.map

package/dist/mcp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../src/mcp-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAiC,YAAY,EAAE,MAAM,YAAY,CAAC;AACtH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAQrD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC;AA4BnC,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,WAAW,CAAoC;IAEvD;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAE5B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5C;;OAEG;IACH,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAE3C;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC,yEAAyE;IACzE,MAAM,EAAE,YAAY,CAAe;IAEnC;;;;;;;;;;OAUG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqE5E;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBnD;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAc/B;;;OAGG;IACH,QAAQ,IAAI,SAAS,EAAE;IAUvB;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAMhD;;OAEG;IACH,mBAAmB,IAAI,kBAAkB,EAAE;IAc3C;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAKxC;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,CAM5B;IAMD,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,oBAAoB;IA4B5B,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;YACW,aAAa;IAmB3B;;;;;;;;OAQG;IACH,OAAO,CAAC,WAAW;IA+GnB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA8BxB;;OAEG;YACW,gBAAgB;CAqE/B"}