mcp-agent-foundry 1.3.1 → 2.1.0

package/dist/hooks/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Hooks Module
+ *
+ * Exports the hooks system for Agent Foundry.
+ * Allows custom code to run in response to events during agent execution.
+ */
+export * from './types.js';
+export { HookManager } from './hook-manager.js';
+export { HookExecutor } from './hook-executor.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,10 @@
+/**
+ * Hooks Module
+ *
+ * Exports the hooks system for Agent Foundry.
+ * Allows custom code to run in response to events during agent execution.
+ */
+export * from './types.js';
+export { HookManager } from './hook-manager.js';
+export { HookExecutor } from './hook-executor.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/hooks/types.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Hook System Types
+ *
+ * Type definitions for the Agent Foundry hooks system.
+ * Hooks allow custom code to run in response to events during agent execution.
+ * Modeled after Claude Code's hooks system.
+ */
+/**
+ * Hook event types that can trigger hook execution.
+ */
+export type HookEvent = 'PreToolUse' | 'PostToolUse' | 'Setup' | 'ToolError' | 'TaskStart' | 'TaskComplete' | 'TaskFail' | 'ProviderError' | 'Failover';
+/**
+ * All valid hook events as an array for validation.
+ */
+export declare const HOOK_EVENTS: readonly HookEvent[];
+/**
+ * Hook decision for PreToolUse hooks.
+ * Determines whether tool execution should proceed.
+ */
+export type HookDecision = 'allow' | 'deny' | 'ask';
+/**
+ * Input provided to hooks via stdin as JSON.
+ * Contains event context and relevant data depending on event type.
+ */
+export interface HookInput {
+    /** The event type that triggered this hook */
+    event: HookEvent;
+    /** Timestamp when the event occurred */
+    timestamp: Date;
+    /** Session ID for the current MCP session */
+    sessionId?: string;
+    /** Task ID if this hook is related to a task */
+    taskId?: string;
+    /** Worktree path if operating in a worktree */
+    worktreePath?: string;
+    /** Name of the tool being executed (for tool events) */
+    toolName?: string;
+    /** Input parameters passed to the tool */
+    toolInput?: Record<string, unknown>;
+    /** Output from the tool (for PostToolUse) */
+    toolOutput?: unknown;
+    /** Error from the tool (for ToolError) */
+    toolError?: Error;
+    /** Provider name (for provider events) */
+    provider?: string;
+    /** Model identifier */
+    model?: string;
+    /** Agent role being used */
+    role?: string;
+    /** HTTP status code (for error events) */
+    errorCode?: number;
+    /** Error message */
+    errorMessage?: string;
+    /** Original provider that failed (for Failover) */
+    fromProvider?: string;
+    /** New provider being tried (for Failover) */
+    toProvider?: string;
+    /** Attempt number in failover chain */
+    attemptNumber?: number;
+}
+/**
+ * Output from hook execution, parsed from stdout JSON.
+ * Hooks can influence agent behavior through these fields.
+ */
+export interface HookOutput {
+    /** Decision for PreToolUse hooks (allow/deny/ask) */
+    decision?: HookDecision;
+    /** Additional context to inject into agent prompt */
+    additionalContext?: string;
+    /** Modified tool input (replaces original input) */
+    updatedInput?: Record<string, unknown>;
+    /** Message to display to user/log */
+    message?: string;
+    /** Abort execution entirely */
+    abort?: boolean;
+    /** Exit code from the hook process */
+    exitCode?: number;
+    /** Raw stdout from the hook */
+    stdout?: string;
+    /** Raw stderr from the hook */
+    stderr?: string;
+}
+/**
+ * Hook definition in configuration.
+ * Defines a hook's trigger conditions and execution parameters.
+ */
+export interface HookDefinition {
+    /** Unique name for this hook */
+    name: string;
+    /** Event that triggers this hook */
+    event: HookEvent;
+    /** Description of what this hook does */
+    description?: string;
+    /** Shell command to execute */
+    command: string;
+    /** Working directory for command */
+    cwd?: string;
+    /** Environment variables to set for the hook process */
+    env?: Record<string, string>;
+    /** Timeout in milliseconds (overrides default) */
+    timeout_ms?: number;
+    /** Only run once per session */
+    once?: boolean;
+    /** Only trigger for specific tools (tool name patterns) */
+    tools?: string[];
+    /** Only trigger for specific providers */
+    providers?: string[];
+    /** Only trigger for specific roles */
+    roles?: string[];
+    /** Error codes that trigger this hook (for ToolError, ProviderError) */
+    error_codes?: number[];
+    /** Whether this hook is enabled */
+    enabled?: boolean;
+}
+/**
+ * Complete hooks configuration.
+ * Can be defined in config.yaml under the 'hooks' key.
+ */
+export interface HooksConfig {
+    /** Enable hooks system globally */
+    enabled: boolean;
+    /** Hook definitions */
+    hooks: HookDefinition[];
+    /** Global timeout for hooks in milliseconds */
+    default_timeout_ms: number;
+    /** Fail silently on hook errors (don't abort main operation) */
+    fail_silent: boolean;
+    /** Path to external hooks configuration file (optional) */
+    hooks_file?: string;
+}
+/**
+ * Default hooks configuration.
+ */
+export declare const DEFAULT_HOOKS_CONFIG: HooksConfig;
+/**
+ * Variable substitutions available in hook commands.
+ * Variables are substituted using ${VAR_NAME} syntax.
+ */
+export interface HookVariables {
+    /** Current MCP session ID */
+    CLAUDE_SESSION_ID: string;
+    /** Task ID being executed */
+    TASK_ID: string;
+    /** Path to the worktree directory */
+    WORKTREE_PATH: string;
+    /** Name of the tool being executed */
+    TOOL_NAME: string;
+    /** Provider name */
+    PROVIDER: string;
+    /** Model identifier */
+    MODEL: string;
+    /** Agent role */
+    ROLE: string;
+    /** Error code (HTTP status) */
+    ERROR_CODE: string;
+    /** Error message */
+    ERROR_MESSAGE: string;
+    /** Original provider (for failover) */
+    FROM_PROVIDER: string;
+    /** Target provider (for failover) */
+    TO_PROVIDER: string;
+    /** Attempt number */
+    ATTEMPT_NUMBER: string;
+}
+/**
+ * Result of a single hook execution.
+ */
+export interface HookExecutionResult {
+    /** Hook that was executed */
+    hook: HookDefinition;
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Output from the hook */
+    output?: HookOutput;
+    /** Error if execution failed */
+    error?: Error;
+    /** Duration in milliseconds */
+    durationMs: number;
+}
+/**
+ * Combined result from triggering an event (multiple hooks).
+ */
+export interface HookTriggerResult {
+    /** Event that was triggered */
+    event: HookEvent;
+    /** Number of hooks executed */
+    hooksExecuted: number;
+    /** Results from each hook */
+    results: HookExecutionResult[];
+    /** Combined output from all hooks */
+    combinedOutput: HookOutput;
+    /** Whether any hook failed */
+    hasErrors: boolean;
+    /** Whether execution should be aborted */
+    shouldAbort: boolean;
+}
+/**
+ * Events emitted by the HookManager.
+ */
+export interface HookManagerEvents {
+    /** Emitted before a hook is executed */
+    'hook:before': {
+        hook: HookDefinition;
+        input: HookInput;
+    };
+    /** Emitted after a hook completes */
+    'hook:after': {
+        hook: HookDefinition;
+        result: HookExecutionResult;
+    };
+    /** Emitted when a hook fails */
+    'hook:error': {
+        hook: HookDefinition;
+        error: Error;
+    };
+    /** Emitted when hooks are reloaded */
+    'hooks:reload': {
+        count: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/types.d.ts.map

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

package/dist/hooks/types.js

@@ -0,0 +1,31 @@
+/**
+ * Hook System Types
+ *
+ * Type definitions for the Agent Foundry hooks system.
+ * Hooks allow custom code to run in response to events during agent execution.
+ * Modeled after Claude Code's hooks system.
+ */
+/**
+ * All valid hook events as an array for validation.
+ */
+export const HOOK_EVENTS = [
+    'PreToolUse',
+    'PostToolUse',
+    'Setup',
+    'ToolError',
+    'TaskStart',
+    'TaskComplete',
+    'TaskFail',
+    'ProviderError',
+    'Failover',
+];
+/**
+ * Default hooks configuration.
+ */
+export const DEFAULT_HOOKS_CONFIG = {
+    enabled: false,
+    hooks: [],
+    default_timeout_ms: 5000,
+    fail_silent: true,
+};
+//# sourceMappingURL=types.js.map

package/dist/hooks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/hooks/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAyB;IAC/C,YAAY;IACZ,aAAa;IACb,OAAO;IACP,WAAW;IACX,WAAW;IACX,cAAc;IACd,UAAU;IACV,eAAe;IACf,UAAU;CACF,CAAC;AAsJX;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,EAAE;IACT,kBAAkB,EAAE,IAAI;IACxB,WAAW,EAAE,IAAI;CAClB,CAAC"}

package/dist/index.d.ts

@@ -2,7 +2,7 @@
  * AgentRouter - MCP server for multi-agent orchestration
  * Entry point
  */
-export declare const VERSION = "3.0.2";
+export declare const VERSION = "2.1.0";
 export { initializeWithRecovery, shutdown } from "./startup.js";
 export type { StartupConfig, StartupResult } from "./startup.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -3,7 +3,7 @@
  * Entry point
  */
 import { createServer, startServer, shutdownServer } from "./server.js";
-export const VERSION = "3.0.2";
+export const VERSION = "2.1.0";
 // Re-export startup utilities for programmatic use
 export { initializeWithRecovery, shutdown } from "./startup.js";
 /**

package/dist/mcp/auto-mode.d.ts

@@ -0,0 +1,221 @@
+/**
+ * MCP Auto Mode
+ *
+ * Automatically defers tool descriptions when they would exceed a configurable
+ * percentage of the context window. This prevents context overflow in long
+ * sessions with many tools.
+ *
+ * Based on Claude Code v2.1.7's MCP Auto Mode feature.
+ *
+ * Key features:
+ * - Configurable percentage threshold for tool descriptions
+ * - Priority-based tool selection
+ * - Always-include and always-defer lists
+ * - On-demand fetching of deferred tool descriptions
+ * - Force-include override for user requests
+ */
+import type { Logger } from '../observability/logger.js';
+import type { ContextManager, ContextState } from '../router/context-manager.js';
+/**
+ * Configuration for MCP Auto Mode
+ */
+export interface MCPAutoModeConfig {
+    /** Enable auto mode (default: true) */
+    enabled: boolean;
+    /** Maximum percentage of context for tool descriptions (default: 10) */
+    maxToolDescriptionPercent: number;
+    /** Tools that should never be deferred */
+    alwaysInclude?: string[];
+    /** Tools that should always be deferred */
+    alwaysDefer?: string[];
+    /** Minimum tools to include even when deferring (default: 5) */
+    minToolsToInclude: number;
+}
+/**
+ * Tool with its description metadata
+ */
+export interface ToolDescriptor {
+    /** Unique tool name */
+    name: string;
+    /** Tool description text */
+    description: string;
+    /** Estimated tokens for this tool's schema */
+    estimatedTokens: number;
+    /** Priority (higher = more important, default: 0) */
+    priority?: number;
+    /** Is this tool currently deferred? */
+    deferred?: boolean;
+    /** Timestamp of last use (for recency-based prioritization) */
+    lastUsedAt?: number;
+}
+/**
+ * Result of auto mode processing
+ */
+export interface AutoModeResult {
+    /** Tools to include in this request */
+    includedTools: string[];
+    /** Tools that were deferred */
+    deferredTools: string[];
+    /** Total tokens saved by deferring */
+    tokensSaved: number;
+    /** Was any tool deferred? */
+    hadDeferrals: boolean;
+    /** Message to show user if tools were deferred */
+    deferralMessage?: string;
+}
+/**
+ * MCP Auto Mode - Intelligent tool description management
+ *
+ * Automatically defers tool descriptions that would exceed context limits.
+ * This is based on Claude Code v2.1.7's MCP Auto Mode feature.
+ *
+ * @example
+ * ```typescript
+ * const autoMode = new MCPAutoMode(
+ *   { maxToolDescriptionPercent: 15 },
+ *   contextManager,
+ *   logger
+ * );
+ *
+ * // Register tools
+ * autoMode.registerTool({
+ *   name: 'invoke_agent',
+ *   description: 'Invoke a specialized agent...',
+ *   estimatedTokens: 150,
+ *   priority: 10,
+ * });
+ *
+ * // Before each request, process tools
+ * const contextState = contextManager.getState('openai', 'gpt-4o', messages);
+ * const result = autoMode.processForRequest(contextState);
+ *
+ * // Use result.includedTools for this request
+ * if (result.hadDeferrals) {
+ *   console.log(result.deferralMessage);
+ * }
+ * ```
+ */
+export declare class MCPAutoMode {
+    private config;
+    private readonly contextManager;
+    private readonly logger;
+    private toolRegistry;
+    private forcedIncludes;
+    /**
+     * Create a new MCPAutoMode instance.
+     *
+     * @param config - Partial configuration (merged with defaults)
+     * @param contextManager - ContextManager for token estimation
+     * @param logger - Logger instance for observability
+     */
+    constructor(config: Partial<MCPAutoModeConfig>, contextManager: ContextManager, logger: Logger);
+    /**
+     * Register a tool with its description.
+     *
+     * @param tool - Tool descriptor to register
+     */
+    registerTool(tool: ToolDescriptor): void;
+    /**
+     * Unregister a tool.
+     *
+     * @param name - Name of tool to unregister
+     */
+    unregisterTool(name: string): void;
+    /**
+     * Get all registered tools.
+     *
+     * @returns Array of all tool descriptors
+     */
+    getAllTools(): ToolDescriptor[];
+    /**
+     * Calculate total tokens for all tool descriptions.
+     *
+     * @returns Total estimated tokens
+     */
+    getTotalToolTokens(): number;
+    /**
+     * Process tools for a request given current context state.
+     * Returns which tools to include and which to defer.
+     *
+     * @param contextState - Current context state from ContextManager
+     * @param requestedTools - Optional list of specifically requested tool names
+     * @returns AutoModeResult with included/deferred tools
+     */
+    processForRequest(contextState: ContextState, requestedTools?: string[]): AutoModeResult;
+    /**
+     * Get deferred tool description on demand.
+     * (When user explicitly requests a deferred tool)
+     *
+     * @param name - Name of deferred tool
+     * @returns Tool descriptor if found, undefined otherwise
+     */
+    getDeferredToolDescription(name: string): ToolDescriptor | undefined;
+    /**
+     * Check if a specific tool is currently deferred.
+     *
+     * @param name - Tool name to check
+     * @returns True if tool is deferred
+     */
+    isDeferred(name: string): boolean;
+    /**
+     * Force include a deferred tool (user override).
+     * This tool will be included in subsequent requests until reset.
+     *
+     * @param name - Tool name to force include
+     */
+    forceInclude(name: string): void;
+    /**
+     * Reset all deferrals and force-includes.
+     */
+    resetDeferrals(): void;
+    /**
+     * Mark a tool as recently used (for recency-based prioritization).
+     *
+     * @param name - Tool name that was used
+     */
+    markToolUsed(name: string): void;
+    /**
+     * Get current configuration.
+     *
+     * @returns Current MCPAutoModeConfig
+     */
+    getConfig(): MCPAutoModeConfig;
+    /**
+     * Update configuration.
+     *
+     * @param config - Partial configuration to merge
+     */
+    updateConfig(config: Partial<MCPAutoModeConfig>): void;
+    /**
+     * Sort tools by priority for inclusion decisions.
+     *
+     * Priority order:
+     * 1. Tools in alwaysInclude
+     * 2. Tools explicitly requested for this call
+     * 3. Tools that were force-included by user
+     * 4. Recently used tools
+     * 5. Tools with higher priority scores
+     * 6. Other tools
+     * 7. Tools in alwaysDefer (lowest priority)
+     */
+    private getSortedTools;
+    /**
+     * Calculate total tokens saved by deferring tools.
+     */
+    private calculateTokensSaved;
+    /**
+     * Estimate token count for a tool based on its description.
+     * Uses the context manager's estimation logic.
+     */
+    private estimateToolTokens;
+}
+/**
+ * Create an MCPAutoMode instance.
+ *
+ * @param config - Partial configuration (merged with defaults)
+ * @param contextManager - ContextManager instance
+ * @param logger - Logger instance
+ * @returns Configured MCPAutoMode instance
+ */
+export declare function createMCPAutoMode(config: Partial<MCPAutoModeConfig>, contextManager: ContextManager, logger: Logger): MCPAutoMode;
+//# sourceMappingURL=auto-mode.d.ts.map

package/dist/mcp/auto-mode.d.ts.map

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