vinkius-labs/mcp-fusion

Added

@mcpfusion/core — FSM Progressive Disclosure: Context Window Optimization

MCP tool descriptions now support two-phase progressive disclosure via the FSM state machine — compact descriptions during discovery, full expert descriptions after first execution. Reduces initial tools/list token footprint by ~88% per prover without sacrificing reasoning quality.

• .compactDescription(text) on FluentToolBuilder — New fluent method for specifying a brief (~200 char) discovery-time description alongside the full .describe() instructional content. Optional — tools without it behave identically to before.

• ExpositionCompiler compact mode — compileExposition() and buildAtomicDescription() now accept a fsmCompactMode boolean. When true and compactDescription is set, the compiler emits the compact version.

• ServerAttachment FSM-gated tool list — createToolListHandler() determines compact mode by comparing fsm.currentState === fsm.initialState. After the first tool execution triggers an FSM transition, notifyToolListChanged forces the client to re-fetch with full expert descriptions.

• StateMachineGate.initialState getter — New public getter for progressive disclosure comparison.

• compactDescription field propagation — Added to InternalAction, ActionConfig, FluentBuildConfig, and mapConfigToActionFields.

Changed

• All @mcpfusion/* cross-dependencies updated to ^4.1.0