mcp-agent-foundry 1.3.0 → 2.0.0

package/dist/observability/logger.js

@@ -228,6 +228,164 @@ export const logger = new Logger({ name: 'agent-router' });
 export function createLogger(options = {}) {
     return new Logger(options);
 }
+// ============================================================================
+// Extended Logger Class Methods
+// ============================================================================
+/**
+ * Extended Logger class with specialized logging methods for Agent Foundry.
+ */
+export class ExtendedLogger extends Logger {
+    /**
+     * Log a tool call attempt.
+     */
+    logToolCall(data) {
+        this.debug('Tool call initiated', {
+            tool: data.tool,
+            input: data.input,
+            taskId: data.taskId,
+            worktreeId: data.worktreeId,
+        });
+    }
+    /**
+     * Log a tool call success.
+     */
+    logToolSuccess(data) {
+        this.info('Tool call succeeded', {
+            tool: data.tool,
+            durationMs: data.durationMs,
+            outputSize: data.outputSize,
+            taskId: data.taskId,
+        });
+    }
+    /**
+     * Log a tool call failure.
+     */
+    logToolFailure(data) {
+        this.error('Tool call failed', {
+            tool: data.tool,
+            error: data.error,
+            durationMs: data.durationMs,
+            taskId: data.taskId,
+            denied: data.denied,
+            denyReason: data.denyReason,
+        });
+    }
+    /**
+     * Log a tool call denial by hook or policy.
+     */
+    logToolDenial(data) {
+        this.warn('Tool call denied', {
+            tool: data.tool,
+            reason: data.reason,
+            hookName: data.hookName,
+            taskId: data.taskId,
+        });
+    }
+    /**
+     * Log a provider failover event.
+     */
+    logFailover(data) {
+        this.warn('Provider failover triggered', {
+            fromProvider: data.fromProvider,
+            toProvider: data.toProvider,
+            reason: data.reason,
+            errorCode: data.errorCode,
+            errorMessage: data.errorMessage,
+            role: data.role,
+            attemptNumber: data.attemptNumber,
+            totalAttempts: data.totalAttempts,
+        });
+    }
+    /**
+     * Log a provider health change.
+     */
+    logHealthChange(data) {
+        const level = data.newStatus === 'unhealthy' ? 'error' :
+            data.newStatus === 'degraded' ? 'warn' : 'info';
+        const message = `Provider health changed: ${data.previousStatus} -> ${data.newStatus}`;
+        if (level === 'error') {
+            this.error(message, {
+                provider: data.provider,
+                previousStatus: data.previousStatus,
+                newStatus: data.newStatus,
+                reason: data.reason,
+                cooldownUntil: data.cooldownUntil?.toISOString(),
+            });
+        }
+        else if (level === 'warn') {
+            this.warn(message, {
+                provider: data.provider,
+                previousStatus: data.previousStatus,
+                newStatus: data.newStatus,
+                reason: data.reason,
+                cooldownUntil: data.cooldownUntil?.toISOString(),
+            });
+        }
+        else {
+            this.info(message, {
+                provider: data.provider,
+                previousStatus: data.previousStatus,
+                newStatus: data.newStatus,
+                reason: data.reason,
+            });
+        }
+    }
+    /**
+     * Log a rate limit warning.
+     */
+    logRateLimitWarning(data) {
+        this.warn('Rate limit warning', {
+            provider: data.provider,
+            remaining: data.remaining,
+            limit: data.limit,
+            usedPercentage: data.usedPercentage,
+            resetsAt: data.resetsAt.toISOString(),
+        });
+    }
+    /**
+     * Log a structured error with full context.
+     */
+    logStructuredError(data) {
+        const logData = {
+            category: data.category,
+            code: data.code,
+            context: data.context,
+            stack: data.stack,
+            recoverable: data.recoverable,
+            suggestedAction: data.suggestedAction,
+        };
+        if (data.recoverable) {
+            this.warn(`[${data.category.toUpperCase()}] ${data.code}: ${data.message}`, logData);
+        }
+        else {
+            this.error(`[${data.category.toUpperCase()}] ${data.code}: ${data.message}`, logData);
+        }
+    }
+    /**
+     * Create a child logger with additional bound context.
+     * Returns an ExtendedLogger instead of Logger.
+     */
+    child(context) {
+        const pinoChild = this.pinoInstance;
+        const childLogger = new ExtendedLogger({
+            level: pinoChild.level,
+        });
+        const mergedContext = { ...context };
+        childLogger.pino = pinoChild.child(mergedContext);
+        childLogger.boundContext = mergedContext;
+        return childLogger;
+    }
+}
+/**
+ * Factory function to create an ExtendedLogger instance.
+ */
+export function createExtendedLogger(options = {}) {
+    return new ExtendedLogger(options);
+}
+/**
+ * Default extended logger instance for the agent-foundry package.
+ */
+export const extendedLogger = new ExtendedLogger({ name: 'agent-foundry' });
 /**
  * Re-export for convenience.
  */

package/dist/observability/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/observability/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,IAAmC,MAAM,MAAM,CAAC;AA2CvD,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,MAAM;IACA,IAAI,CAAa;IACjB,YAAY,CAAa;IAE1C,YAAY,UAAyB,EAAE;QACrC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,aAAa,CAAC;QAChE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC;QAClD,MAAM,YAAY,GAAa,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QAEhE,wEAAwE;QACxE,MAAM,WAAW,GAAuB;YACtC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,YAAY;YAChE,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,OAAO;YACxC,UAAU,EAAE;gBACV,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;aACrC;SACF,CAAC;QAEF,+BAA+B;QAC/B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,WAAW,CAAC,IAAI,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAC5C,CAAC;QAED,uBAAuB;QACvB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,WAAW,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAClC,CAAC;QAED,wDAAwD;QACxD,IAAI,SAAS,EAAE,CAAC;YACd,WAAW,CAAC,SAAS,GAAG;gBACtB,MAAM,EAAE,aAAa;gBACrB,OAAO,EAAE;oBACP,QAAQ,EAAE,IAAI;oBACd,aAAa,EAAE,cAAc;oBAC7B,MAAM,EAAE,cAAc;iBACvB;aACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,gEAAgE;YAChE,OAAO,WAAW,CAAC,SAAS,CAAC;YAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;YAC9B,IAAI,SAAS,EAAE,CAAC;gBACd,+CAA+C;gBAC/C,IAAI,CAAC,IAAI,CAAC,IAAI,CACZ,2DAA2D;oBAC3D,0CAA0C,CAC3C,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAmB;QACvB,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC;YAC7B,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAiB;SACnC,CAAC,CAAC;QACH,0CAA0C;QAC1C,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,OAAO,EAAE,CAAC;QAC1D,WAA+C,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACtF,WAAuD,CAAC,YAAY,GAAG,aAAa,CAAC;QACtF,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,OAAoB;QACzC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,OAAoB;QACzC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,OAAoB;QACxC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,OAAoB;QACxC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,OAAwC;QAC7D,IAAI,OAAO,EAAE,CAAC;YACZ,oDAAoD;YACpD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;YACnC,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,OAAwC;QAC7D,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;YACnC,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,IAAI,CAAC,KAAiB,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,IAAI,KAAK,CAAC,KAAe;QACvB,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,KAAe;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,EAAE,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,iBAA8B;IAChE,OAAO;QACL,OAAO,EAAE,eAAe,EAAE;QAC1B,GAAG,iBAAiB;KACrB,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;AAE3D;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,UAAyB,EAAE;IACtD,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,eAAe,MAAM,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/observability/logger.ts"],"names":[],"mappings":"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"}

package/dist/router/context-manager.d.ts

@@ -1,2 +1,215 @@
-export {};
+/**
+ * Context Manager
+ *
+ * Manages context window tracking, auto-compaction, and truncation
+ * for multi-provider agent orchestration. Tracks token usage across
+ * different providers and models with varying context limits.
+ *
+ * Key features:
+ * - Per-provider/model context limit tracking
+ * - Automatic compaction when approaching limits
+ * - Smart truncation that preserves important content
+ * - Context visualization for debugging
+ * - Event emission for monitoring
+ */
+import type { Logger } from '../observability/logger.js';
+import type { Message, ContentBlock } from '../types.js';
+import type { ContextManagerConfig, ContextState, ContextBreakdown, ContextMessage, ContextContentBlock, ContextEventListener, TruncationOptions, TruncationResult } from './context-types.js';
+/**
+ * Manages context window tracking and optimization for multi-provider
+ * agent orchestration.
+ *
+ * @example
+ * ```typescript
+ * const contextManager = new ContextManager({ autoCompactThreshold: 0.85 }, logger);
+ *
+ * // Check context state before making a request
+ * const state = contextManager.getState('openai', 'gpt-4o', messages);
+ * if (state.isBlocked) {
+ *   // Context too full, need to compact
+ *   messages = contextManager.compact(messages);
+ * }
+ *
+ * // Get detailed breakdown for debugging
+ * const breakdown = contextManager.getBreakdown(messages);
+ * console.log(contextManager.visualize(state, breakdown));
+ * ```
+ */
+export declare class ContextManager {
+    private readonly config;
+    private readonly logger;
+    private readonly listeners;
+    /**
+     * Create a new ContextManager instance.
+     *
+     * @param config - Partial configuration (merged with defaults)
+     * @param logger - Logger instance for observability
+     */
+    constructor(config: Partial<ContextManagerConfig>, logger: Logger);
+    /**
+     * Get the current context state for a provider/model combination.
+     *
+     * @param provider - Provider name (e.g., 'openai', 'anthropic')
+     * @param model - Model name (e.g., 'gpt-4o', 'claude-3-opus')
+     * @param messages - Current conversation messages
+     * @returns Current context state with usage metrics
+     */
+    getState(provider: string, model: string, messages: Message[]): ContextState;
+    /**
+     * Check if the context should be auto-compacted.
+     *
+     * @param state - Current context state
+     * @returns True if compaction should be triggered
+     */
+    shouldCompact(state: ContextState): boolean;
+    /**
+     * Check if the context is blocked (too full for new messages).
+     *
+     * @param state - Current context state
+     * @returns True if context is blocked
+     */
+    isBlocked(state: ContextState): boolean;
+    /**
+     * Estimate the number of tokens in a string.
+     *
+     * Uses a simple character-based approximation. For more accurate counting,
+     * consider integrating tiktoken or a provider-specific tokenizer.
+     *
+     * @param text - Text to estimate tokens for
+     * @param provider - Provider name for provider-specific ratios
+     * @returns Estimated token count
+     */
+    estimateTokens(text: string, provider?: string): number;
+    /**
+     * Estimate tokens for a content block.
+     *
+     * @param block - Content block to analyze
+     * @param provider - Provider name for estimation
+     * @returns Estimated token count
+     */
+    estimateContentBlockTokens(block: ContentBlock | ContextContentBlock, provider?: string): number;
+    /**
+     * Estimate tokens for a message.
+     *
+     * @param message - Message to analyze
+     * @param provider - Provider name for estimation
+     * @returns Estimated token count
+     */
+    estimateMessageTokens(message: Message | ContextMessage, provider?: string): number;
+    /**
+     * Estimate total tokens for an array of messages.
+     *
+     * @param messages - Messages to analyze
+     * @param provider - Provider name for estimation
+     * @returns Total estimated token count
+     */
+    estimateMessagesTokens(messages: (Message | ContextMessage)[], provider?: string): number;
+    /**
+     * Get the context limit for a specific model.
+     *
+     * Looks up the model in the configured limits, falling back to
+     * DEFAULT_MODEL_LIMITS, then to the default context limit.
+     *
+     * @param provider - Provider name
+     * @param model - Model name
+     * @returns Context limit in tokens
+     */
+    getModelLimit(provider: string, model: string): number;
+    /**
+     * Truncate content to fit within a token limit.
+     *
+     * @param content - Content to truncate
+     * @param maxTokens - Maximum tokens allowed
+     * @param options - Truncation options
+     * @returns Truncated content
+     */
+    truncate(content: string, maxTokens: number, options?: Partial<TruncationOptions>): string;
+    /**
+     * Truncate content with detailed result information.
+     *
+     * @param content - Content to truncate
+     * @param maxTokens - Maximum tokens allowed
+     * @param options - Truncation options
+     * @returns Truncation result with metadata
+     */
+    truncateWithResult(content: string, maxTokens: number, options?: Partial<TruncationOptions>): TruncationResult;
+    /**
+     * Compact messages to reduce context usage.
+     *
+     * Strategy:
+     * 1. Truncate long tool results
+     * 2. Truncate long individual messages
+     * 3. Summarize/drop older messages if still over limit
+     *
+     * @param messages - Messages to compact
+     * @param targetReduction - Target reduction percentage (0-1, default 0.3)
+     * @returns Compacted messages array
+     */
+    compact(messages: Message[], targetReduction?: number): Message[];
+    /**
+     * Get a detailed breakdown of context usage by category.
+     *
+     * @param messages - Messages to analyze
+     * @param provider - Provider name for estimation
+     * @returns Context breakdown by category
+     */
+    getBreakdown(messages: (Message | ContextMessage)[], provider?: string): ContextBreakdown;
+    /**
+     * Generate a human-readable visualization of context usage.
+     *
+     * @param state - Current context state
+     * @param breakdown - Context breakdown by category
+     * @returns Formatted visualization string
+     */
+    visualize(state: ContextState, breakdown: ContextBreakdown): string;
+    /**
+     * Add an event listener for context events.
+     *
+     * @param listener - Event listener function
+     */
+    addEventListener(listener: ContextEventListener): void;
+    /**
+     * Remove an event listener.
+     *
+     * @param listener - Event listener to remove
+     */
+    removeEventListener(listener: ContextEventListener): void;
+    /**
+     * Emit a context event to all listeners.
+     */
+    private emit;
+    /**
+     * Truncate tool results that exceed the configured limit.
+     */
+    private truncateToolResults;
+    /**
+     * Truncate individual messages that exceed the configured limit.
+     */
+    private truncateLongMessages;
+    /**
+     * Check if a message is a system prompt.
+     */
+    private isSystemPromptMessage;
+    /**
+     * Emit a compaction result event.
+     */
+    private emitCompactionResult;
+    /**
+     * Format a percentage for display.
+     */
+    private formatPercentage;
+    /**
+     * Generate a visual progress bar for context usage.
+     */
+    private generateUsageBar;
+}
+/**
+ * Create a ContextManager instance.
+ *
+ * @param config - Partial configuration (merged with defaults)
+ * @param logger - Logger instance
+ * @returns Configured ContextManager instance
+ */
+export declare function createContextManager(config: Partial<ContextManagerConfig>, logger: Logger): ContextManager;
+export type { ContextManagerConfig, ContextState, ContextBreakdown, ContextMessage, ContextContentBlock, CompactionResult, CompactionStrategy, ContextEvent, ContextEventListener, TruncationOptions, TruncationResult, } from './context-types.js';
 //# sourceMappingURL=context-manager.d.ts.map

package/dist/router/context-manager.d.ts.map

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