@vinkius-core/mcp-fusion 2.14.0 → 2.14.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli/fusion.js +35 -35
- package/dist/cli/templates/config.js +26 -26
- package/dist/cli/templates/core.d.ts.map +1 -1
- package/dist/cli/templates/core.js +108 -111
- package/dist/cli/templates/core.js.map +1 -1
- package/dist/cli/templates/middleware.js +25 -25
- package/dist/cli/templates/readme.js +142 -142
- package/dist/cli/templates/testing.js +83 -83
- package/dist/cli/templates/tools.js +46 -46
- package/dist/cli/templates/vectors/database.js +69 -69
- package/dist/cli/templates/vectors/oauth.js +63 -63
- package/dist/cli/templates/vectors/openapi.js +97 -97
- package/dist/core/builder/ActionGroupBuilder.d.ts +6 -2
- package/dist/core/builder/ActionGroupBuilder.d.ts.map +1 -1
- package/dist/core/builder/ActionGroupBuilder.js +6 -2
- package/dist/core/builder/ActionGroupBuilder.js.map +1 -1
- package/dist/core/builder/FluentRouter.d.ts +6 -2
- package/dist/core/builder/FluentRouter.d.ts.map +1 -1
- package/dist/core/builder/FluentRouter.js +6 -2
- package/dist/core/builder/FluentRouter.js.map +1 -1
- package/dist/core/builder/FluentToolBuilder.d.ts +45 -9
- package/dist/core/builder/FluentToolBuilder.d.ts.map +1 -1
- package/dist/core/builder/FluentToolBuilder.js +54 -27
- package/dist/core/builder/FluentToolBuilder.js.map +1 -1
- package/dist/core/builder/GroupedToolBuilder.d.ts +32 -2
- package/dist/core/builder/GroupedToolBuilder.d.ts.map +1 -1
- package/dist/core/builder/GroupedToolBuilder.js +47 -2
- package/dist/core/builder/GroupedToolBuilder.js.map +1 -1
- package/dist/core/builder/defineTool.d.ts +5 -4
- package/dist/core/builder/defineTool.d.ts.map +1 -1
- package/dist/core/builder/defineTool.js +3 -2
- package/dist/core/builder/defineTool.js.map +1 -1
- package/dist/core/initFusion.d.ts +26 -1
- package/dist/core/initFusion.d.ts.map +1 -1
- package/dist/core/initFusion.js +5 -0
- package/dist/core/initFusion.js.map +1 -1
- package/dist/fsm/StateMachineGate.d.ts +264 -0
- package/dist/fsm/StateMachineGate.d.ts.map +1 -0
- package/dist/fsm/StateMachineGate.js +343 -0
- package/dist/fsm/StateMachineGate.js.map +1 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -0
- package/dist/index.js.map +1 -1
- package/dist/introspection/SemanticProbe.js +49 -49
- package/dist/observability/TelemetryBus.d.ts +82 -0
- package/dist/observability/TelemetryBus.d.ts.map +1 -0
- package/dist/observability/TelemetryBus.js +335 -0
- package/dist/observability/TelemetryBus.js.map +1 -0
- package/dist/observability/TelemetryEvent.d.ts +171 -0
- package/dist/observability/TelemetryEvent.d.ts.map +1 -0
- package/dist/observability/TelemetryEvent.js +2 -0
- package/dist/observability/TelemetryEvent.js.map +1 -0
- package/dist/presenter/definePresenter.d.ts +2 -2
- package/dist/presenter/definePresenter.d.ts.map +1 -1
- package/dist/prompt/FluentPromptBuilder.d.ts.map +1 -1
- package/dist/server/ServerAttachment.d.ts +63 -0
- package/dist/server/ServerAttachment.d.ts.map +1 -1
- package/dist/server/ServerAttachment.js +149 -6
- package/dist/server/ServerAttachment.js.map +1 -1
- package/package.json +10 -3
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"defineTool.d.ts","sourceRoot":"","sources":["../../../src/core/builder/defineTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAqB,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAEH,KAAK,SAAS,EACd,KAAK,WAAW,EACnB,MAAM,uBAAuB,CAAC;AAO/B;;;;;;;;;;GAUG;AACH,MAAM,WAAW,SAAS,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,SAAS,SAAS,GAAG,SAAS;IAC3G,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAC1C,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,iFAAiF;IACjF,OAAO,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC7B,2EAA2E;IAC3E,OAAO,EAAE,CACL,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,OAAO,SAAS,SAAS,GACzB,CAAC,MAAM,OAAO,SAAS,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,GAC1G,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1C,OAAO,CAAC,YAAY,CAAC,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IACnE,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,
|
|
1
|
+
{"version":3,"file":"defineTool.d.ts","sourceRoot":"","sources":["../../../src/core/builder/defineTool.ts"],"names":[],"mappings":"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"}
|
|
@@ -27,6 +27,7 @@
|
|
|
27
27
|
import {} from 'zod';
|
|
28
28
|
import { GroupedToolBuilder } from './GroupedToolBuilder.js';
|
|
29
29
|
import {} from '../types.js';
|
|
30
|
+
import { resolveMiddleware } from '../middleware/ContextDerivation.js';
|
|
30
31
|
import {} from '../../presenter/Presenter.js';
|
|
31
32
|
import { convertParamsToZod, } from './ParamDescriptors.js';
|
|
32
33
|
import { isZodSchema } from '../schema/SchemaUtils.js';
|
|
@@ -109,7 +110,7 @@ export function defineTool(name, config) {
|
|
|
109
110
|
const sharedSchema = resolveSchema(shared);
|
|
110
111
|
if (sharedSchema)
|
|
111
112
|
builder.commonSchema(sharedSchema);
|
|
112
|
-
middleware?.forEach(mw => builder.use(mw));
|
|
113
|
+
middleware?.forEach(mw => builder.use(resolveMiddleware(mw)));
|
|
113
114
|
// ── Register actions/groups ──
|
|
114
115
|
if (actions) {
|
|
115
116
|
for (const [actionName, actionDef] of Object.entries(actions)) {
|
|
@@ -154,7 +155,7 @@ function registerGroup(builder, groupName, def) {
|
|
|
154
155
|
if (def.omitCommon != null && def.omitCommon.length > 0) {
|
|
155
156
|
g.omitCommon(...def.omitCommon);
|
|
156
157
|
}
|
|
157
|
-
def.middleware?.forEach(mw => g.use(mw));
|
|
158
|
+
def.middleware?.forEach(mw => g.use(resolveMiddleware(mw)));
|
|
158
159
|
for (const [actionName, actionDef] of Object.entries(def.actions)) {
|
|
159
160
|
g.action(buildActionConfig(actionName, actionDef));
|
|
160
161
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"defineTool.js","sourceRoot":"","sources":["../../../src/core/builder/defineTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAoC,MAAM,KAAK,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAA2D,MAAM,aAAa,CAAC;AACtF,OAAO,EAAkB,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EACH,kBAAkB,GAGrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AA4HvD,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;GAGG;AACH,SAAS,aAAa,CAClB,MAAsD;IAEtD,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,WAAW,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACvC,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,UAAU,UAAU,CACtB,IAAY,EACZ,MAA4B;IAE5B,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAC9D,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEvD,yDAAyD;IACzD,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACX,eAAe,IAAI,qDAAqD;YACxE,4EAA4E,CAC/E,CAAC;IACN,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAW,IAAI,CAAC,CAAC;IAEvD,4CAA4C;IAC5C,IAAI,WAAW;QAAE,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAClD,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3D,IAAI,aAAa;QAAE,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IACxD,IAAI,eAAe;QAAE,OAAO,CAAC,eAAe,EAAE,CAAC;IAC/C,IAAI,WAAW;QAAE,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAElD,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,YAAY;QAAE,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IAErD,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"defineTool.js","sourceRoot":"","sources":["../../../src/core/builder/defineTool.ts"],"names":[],"mappings":"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"}
|
|
@@ -46,6 +46,7 @@ import { StateSyncBuilder } from '../state-sync/StateSyncBuilder.js';
|
|
|
46
46
|
import { type ErrorCode } from './response.js';
|
|
47
47
|
import { SandboxEngine, type SandboxConfig } from '../sandbox/SandboxEngine.js';
|
|
48
48
|
import { type JsonSerializer } from './serialization/JsonSerializer.js';
|
|
49
|
+
import { StateMachineGate, type FsmConfig } from '../fsm/StateMachineGate.js';
|
|
49
50
|
/**
|
|
50
51
|
* The initialized Fusion instance.
|
|
51
52
|
*
|
|
@@ -123,7 +124,7 @@ export interface FusionInstance<TContext> {
|
|
|
123
124
|
* });
|
|
124
125
|
* ```
|
|
125
126
|
*/
|
|
126
|
-
presenter<TSchema extends ZodType
|
|
127
|
+
presenter<TSchema extends ZodType<any, any, any>>(config: PresenterConfig<TSchema['_output']> & {
|
|
127
128
|
schema: TSchema;
|
|
128
129
|
}): Presenter<TSchema['_output']>;
|
|
129
130
|
/**
|
|
@@ -242,6 +243,30 @@ export interface FusionInstance<TContext> {
|
|
|
242
243
|
* ```
|
|
243
244
|
*/
|
|
244
245
|
readonly serializer: JsonSerializer;
|
|
246
|
+
/**
|
|
247
|
+
* Create a Finite State Machine gate for temporal anti-hallucination.
|
|
248
|
+
*
|
|
249
|
+
* Tools bound to FSM states (via `.bindState()`) are dynamically
|
|
250
|
+
* filtered from `tools/list` based on the current workflow state.
|
|
251
|
+
*
|
|
252
|
+
* @param config - FSM definition (states, transitions, initial state)
|
|
253
|
+
* @returns A new StateMachineGate instance
|
|
254
|
+
*
|
|
255
|
+
* @example
|
|
256
|
+
* ```typescript
|
|
257
|
+
* const gate = f.fsm({
|
|
258
|
+
* id: 'checkout',
|
|
259
|
+
* initial: 'empty',
|
|
260
|
+
* states: {
|
|
261
|
+
* empty: { on: { ADD_ITEM: 'has_items' } },
|
|
262
|
+
* has_items: { on: { CHECKOUT: 'payment' } },
|
|
263
|
+
* payment: { on: { PAY: 'confirmed' } },
|
|
264
|
+
* confirmed: { type: 'final' },
|
|
265
|
+
* },
|
|
266
|
+
* });
|
|
267
|
+
* ```
|
|
268
|
+
*/
|
|
269
|
+
fsm(config: FsmConfig): StateMachineGate;
|
|
245
270
|
}
|
|
246
271
|
/**
|
|
247
272
|
* Initialize a Fusion instance with a fixed context type.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"initFusion.d.ts","sourceRoot":"","sources":["../../src/core/initFusion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAAE,KAAK,OAAO,EAAoC,MAAM,KAAK,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAGrE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACxF,OAAO,EAAoB,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EACH,iBAAiB,EAEpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,mCAAmC,CAAC;
|
|
1
|
+
{"version":3,"file":"initFusion.d.ts","sourceRoot":"","sources":["../../src/core/initFusion.ts"],"names":[],"mappings":"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"}
|
package/dist/core/initFusion.js
CHANGED
|
@@ -49,6 +49,7 @@ import { StateSyncBuilder } from '../state-sync/StateSyncBuilder.js';
|
|
|
49
49
|
import {} from './response.js';
|
|
50
50
|
import { SandboxEngine } from '../sandbox/SandboxEngine.js';
|
|
51
51
|
import { defaultSerializer } from './serialization/JsonSerializer.js';
|
|
52
|
+
import { StateMachineGate } from '../fsm/StateMachineGate.js';
|
|
52
53
|
// ── Factory ──────────────────────────────────────────────
|
|
53
54
|
/**
|
|
54
55
|
* Initialize a Fusion instance with a fixed context type.
|
|
@@ -127,6 +128,10 @@ export function initFusion() {
|
|
|
127
128
|
},
|
|
128
129
|
// ── Serialization ────────────────────────────────
|
|
129
130
|
serializer: defaultSerializer,
|
|
131
|
+
// ── FSM State Gate ─────────────────────────────
|
|
132
|
+
fsm(config) {
|
|
133
|
+
return new StateMachineGate(config);
|
|
134
|
+
},
|
|
130
135
|
};
|
|
131
136
|
}
|
|
132
137
|
//# sourceMappingURL=initFusion.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"initFusion.js","sourceRoot":"","sources":["../../src/core/initFusion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAAkD,MAAM,KAAK,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAqB,MAAM,eAAe,CAAC;AAClD,OAAO,EAAqB,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAkB,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAwB,MAAM,iCAAiC,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAA6B,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,UAAU,EAAmB,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAyC,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EACH,iBAAiB,EACjB,cAAc,EAAE,iBAAiB,EAAE,eAAe,GACrD,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAkB,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAsB,MAAM,6BAA6B,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAuB,MAAM,mCAAmC,CAAC;
|
|
1
|
+
{"version":3,"file":"initFusion.js","sourceRoot":"","sources":["../../src/core/initFusion.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,264 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* StateMachineGate — Temporal Anti-Hallucination Engine
|
|
3
|
+
*
|
|
4
|
+
* Zero-hallucination tool ordering via finite state machines.
|
|
5
|
+
* Tools bound to FSM states are **physically removed** from
|
|
6
|
+
* `tools/list` when the current state doesn't match — the LLM
|
|
7
|
+
* cannot call what doesn't exist in its reality.
|
|
8
|
+
*
|
|
9
|
+
* Powered by XState v5 (optional peer dependency, lazy-loaded).
|
|
10
|
+
*
|
|
11
|
+
* @example
|
|
12
|
+
* ```typescript
|
|
13
|
+
* const gate = new StateMachineGate({
|
|
14
|
+
* id: 'checkout',
|
|
15
|
+
* initial: 'empty',
|
|
16
|
+
* states: {
|
|
17
|
+
* empty: { on: { ADD_ITEM: 'has_items' } },
|
|
18
|
+
* has_items: { on: { CHECKOUT: 'payment', CLEAR: 'empty' } },
|
|
19
|
+
* payment: { on: { PAY: 'confirmed', CANCEL: 'has_items' } },
|
|
20
|
+
* confirmed: { on: { RESET: 'empty' } },
|
|
21
|
+
* },
|
|
22
|
+
* });
|
|
23
|
+
*
|
|
24
|
+
* gate.bindTool('cart_add_item', ['empty', 'has_items'], 'ADD_ITEM');
|
|
25
|
+
* gate.bindTool('cart_checkout', ['has_items'], 'CHECKOUT');
|
|
26
|
+
* gate.bindTool('cart_pay', ['payment'], 'PAY');
|
|
27
|
+
* ```
|
|
28
|
+
*
|
|
29
|
+
* ## Architecture
|
|
30
|
+
*
|
|
31
|
+
* ```
|
|
32
|
+
* ┌──────────────────────────────────────────────────────┐
|
|
33
|
+
* │ Boot: StateMachineGate(config) │
|
|
34
|
+
* │ │
|
|
35
|
+
* │ XState createMachine() → createActor() → .start() │
|
|
36
|
+
* │ │ │
|
|
37
|
+
* │ ▼ │
|
|
38
|
+
* │ tools/list request │
|
|
39
|
+
* │ │ │
|
|
40
|
+
* │ ▼ │
|
|
41
|
+
* │ gate.getVisibleTools(allTools) │
|
|
42
|
+
* │ → filter by current FSM state │
|
|
43
|
+
* │ → return only allowed tools │
|
|
44
|
+
* │ │ │
|
|
45
|
+
* │ ▼ │
|
|
46
|
+
* │ tools/call succeeds │
|
|
47
|
+
* │ → gate.transition(event) │
|
|
48
|
+
* │ → FSM advances → list_changed notification │
|
|
49
|
+
* └──────────────────────────────────────────────────────┘
|
|
50
|
+
* ```
|
|
51
|
+
*
|
|
52
|
+
* @module
|
|
53
|
+
*/
|
|
54
|
+
/**
|
|
55
|
+
* Configuration for a finite state machine definition.
|
|
56
|
+
*
|
|
57
|
+
* Uses the same shape as XState v5 `createMachine()` config,
|
|
58
|
+
* but only the subset needed for tool gating.
|
|
59
|
+
*/
|
|
60
|
+
export interface FsmConfig {
|
|
61
|
+
/** Unique identifier for this state machine */
|
|
62
|
+
id?: string;
|
|
63
|
+
/** Initial state when a new session starts */
|
|
64
|
+
initial: string;
|
|
65
|
+
/** State definitions with event transitions */
|
|
66
|
+
states: Record<string, {
|
|
67
|
+
/** Events that trigger transitions: `{ EVENT_NAME: 'target_state' }` */
|
|
68
|
+
on?: Record<string, string>;
|
|
69
|
+
/** Set to `'final'` to mark a terminal state */
|
|
70
|
+
type?: 'final';
|
|
71
|
+
}>;
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* External state store for serverless/edge deployments.
|
|
75
|
+
*
|
|
76
|
+
* When MCP runs over Streamable HTTP (Vercel, Cloudflare Workers),
|
|
77
|
+
* there is no persistent process — FSM state must be externalized.
|
|
78
|
+
* The `sessionId` comes from the `Mcp-Session-Id` header.
|
|
79
|
+
*
|
|
80
|
+
* @example
|
|
81
|
+
* ```typescript
|
|
82
|
+
* const fsmStore: FsmStateStore = {
|
|
83
|
+
* load: async (sessionId) => {
|
|
84
|
+
* const data = await redis.get(`fsm:${sessionId}`);
|
|
85
|
+
* return data ? JSON.parse(data) : undefined;
|
|
86
|
+
* },
|
|
87
|
+
* save: async (sessionId, snapshot) => {
|
|
88
|
+
* await redis.set(`fsm:${sessionId}`, JSON.stringify(snapshot), { EX: 3600 });
|
|
89
|
+
* },
|
|
90
|
+
* };
|
|
91
|
+
* ```
|
|
92
|
+
*/
|
|
93
|
+
export interface FsmStateStore {
|
|
94
|
+
/** Load persisted FSM state for a session. Returns `undefined` for new sessions. */
|
|
95
|
+
load(sessionId: string): Promise<FsmSnapshot | undefined>;
|
|
96
|
+
/** Save FSM state after a transition. */
|
|
97
|
+
save(sessionId: string, snapshot: FsmSnapshot): Promise<void>;
|
|
98
|
+
}
|
|
99
|
+
/**
|
|
100
|
+
* Serializable FSM state snapshot for persistence.
|
|
101
|
+
*/
|
|
102
|
+
export interface FsmSnapshot {
|
|
103
|
+
/** Current FSM state value */
|
|
104
|
+
state: string;
|
|
105
|
+
/** Timestamp of last transition */
|
|
106
|
+
updatedAt: number;
|
|
107
|
+
}
|
|
108
|
+
/**
|
|
109
|
+
* Result of a state transition attempt.
|
|
110
|
+
*/
|
|
111
|
+
export interface TransitionResult {
|
|
112
|
+
/** Whether the FSM state actually changed */
|
|
113
|
+
changed: boolean;
|
|
114
|
+
/** The FSM state before the transition */
|
|
115
|
+
previousState: string;
|
|
116
|
+
/** The FSM state after the transition */
|
|
117
|
+
currentState: string;
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* Pre-load `xstate` at boot time (optional optimization).
|
|
121
|
+
*
|
|
122
|
+
* Call during server startup to avoid the first-use dynamic import latency.
|
|
123
|
+
* Returns `true` if xstate is available, `false` otherwise.
|
|
124
|
+
*
|
|
125
|
+
* @example
|
|
126
|
+
* ```typescript
|
|
127
|
+
* import { initFsmEngine } from '@vinkius-core/mcp-fusion';
|
|
128
|
+
* const available = await initFsmEngine();
|
|
129
|
+
* if (!available) console.warn('xstate not installed — FSM gating disabled');
|
|
130
|
+
* ```
|
|
131
|
+
*/
|
|
132
|
+
export declare function initFsmEngine(): Promise<boolean>;
|
|
133
|
+
/**
|
|
134
|
+
* Temporal Anti-Hallucination Engine.
|
|
135
|
+
*
|
|
136
|
+
* Wraps an XState v5 finite state machine and controls which MCP tools
|
|
137
|
+
* are visible to the LLM based on the current workflow state.
|
|
138
|
+
*
|
|
139
|
+
* **Hard constraint**: Tools not bound to the current state are removed
|
|
140
|
+
* from `tools/list` entirely — the LLM physically cannot call them.
|
|
141
|
+
*
|
|
142
|
+
* **Soft constraint**: `suggestActions` (HATEOAS) continues to recommend
|
|
143
|
+
* the best next action within the visible set. Zero conflict.
|
|
144
|
+
*/
|
|
145
|
+
export declare class StateMachineGate {
|
|
146
|
+
private readonly _config;
|
|
147
|
+
private readonly _bindings;
|
|
148
|
+
private readonly _transitionCallbacks;
|
|
149
|
+
private _actor;
|
|
150
|
+
private _currentState;
|
|
151
|
+
private _initialized;
|
|
152
|
+
/**
|
|
153
|
+
* @param config - FSM definition (states, transitions, initial state)
|
|
154
|
+
*/
|
|
155
|
+
constructor(config: FsmConfig);
|
|
156
|
+
/**
|
|
157
|
+
* Initialize the XState actor (lazy-loaded).
|
|
158
|
+
*
|
|
159
|
+
* Called automatically on first use. Can be called explicitly
|
|
160
|
+
* at boot time for eager initialization.
|
|
161
|
+
*
|
|
162
|
+
* @returns `true` if XState is available and the actor started
|
|
163
|
+
*/
|
|
164
|
+
init(): Promise<boolean>;
|
|
165
|
+
/**
|
|
166
|
+
* Bind a tool to specific FSM states.
|
|
167
|
+
*
|
|
168
|
+
* The tool will only appear in `tools/list` when the FSM
|
|
169
|
+
* is in one of the specified states.
|
|
170
|
+
*
|
|
171
|
+
* @param toolName - MCP tool name (flat: `cart_add_item`, grouped: `cart`)
|
|
172
|
+
* @param allowedStates - FSM states where this tool is visible
|
|
173
|
+
* @param transitionEvent - Event to send on successful execution (optional)
|
|
174
|
+
* @returns `this` for chaining
|
|
175
|
+
*
|
|
176
|
+
* @example
|
|
177
|
+
* ```typescript
|
|
178
|
+
* gate.bindTool('cart_add_item', ['empty', 'has_items'], 'ADD_ITEM');
|
|
179
|
+
* gate.bindTool('cart_checkout', ['has_items'], 'CHECKOUT');
|
|
180
|
+
* ```
|
|
181
|
+
*/
|
|
182
|
+
bindTool(toolName: string, allowedStates: string[], transitionEvent?: string): StateMachineGate;
|
|
183
|
+
/**
|
|
184
|
+
* Get the current FSM state.
|
|
185
|
+
*/
|
|
186
|
+
get currentState(): string;
|
|
187
|
+
/**
|
|
188
|
+
* Check if a specific tool is allowed in the current FSM state.
|
|
189
|
+
*
|
|
190
|
+
* Tools **not** registered via `bindTool()` are always visible
|
|
191
|
+
* (ungated — they don't participate in FSM gating).
|
|
192
|
+
*
|
|
193
|
+
* @param toolName - MCP tool name to check
|
|
194
|
+
* @returns `true` if the tool should appear in `tools/list`
|
|
195
|
+
*/
|
|
196
|
+
isToolAllowed(toolName: string): boolean;
|
|
197
|
+
/**
|
|
198
|
+
* Filter a list of tool names by the current FSM state.
|
|
199
|
+
*
|
|
200
|
+
* @param toolNames - All registered tool names
|
|
201
|
+
* @returns Only the tools allowed in the current state
|
|
202
|
+
*/
|
|
203
|
+
getVisibleToolNames(toolNames: string[]): string[];
|
|
204
|
+
/**
|
|
205
|
+
* Get the transition event for a tool (if any).
|
|
206
|
+
*
|
|
207
|
+
* @param toolName - MCP tool name
|
|
208
|
+
* @returns The event string, or `undefined` if no transition is bound
|
|
209
|
+
*/
|
|
210
|
+
getTransitionEvent(toolName: string): string | undefined;
|
|
211
|
+
/**
|
|
212
|
+
* Check if any tools are bound to this FSM gate.
|
|
213
|
+
*
|
|
214
|
+
* @returns `true` if at least one tool is state-gated
|
|
215
|
+
*/
|
|
216
|
+
get hasBindings(): boolean;
|
|
217
|
+
/**
|
|
218
|
+
* Send an event to the FSM, potentially triggering a state transition.
|
|
219
|
+
*
|
|
220
|
+
* @param eventType - The event to send (e.g. `'ADD_ITEM'`, `'CHECKOUT'`)
|
|
221
|
+
* @returns Result indicating whether the state changed
|
|
222
|
+
*/
|
|
223
|
+
transition(eventType: string): Promise<TransitionResult>;
|
|
224
|
+
/**
|
|
225
|
+
* Manual state transition fallback when XState is not installed.
|
|
226
|
+
*
|
|
227
|
+
* Reads the FSM config directly to determine the next state.
|
|
228
|
+
* This provides basic FSM gating even without `xstate` installed,
|
|
229
|
+
* though without XState's guards, actions, and advanced features.
|
|
230
|
+
*
|
|
231
|
+
* @internal
|
|
232
|
+
*/
|
|
233
|
+
private _transitionManual;
|
|
234
|
+
/**
|
|
235
|
+
* Register a callback that fires when the FSM state changes.
|
|
236
|
+
*
|
|
237
|
+
* Used by `ServerAttachment` to emit `notifications/tools/list_changed`
|
|
238
|
+
* when a state transition makes tools appear or disappear.
|
|
239
|
+
*
|
|
240
|
+
* @param callback - Function to call on state change
|
|
241
|
+
* @returns Unsubscribe function
|
|
242
|
+
*/
|
|
243
|
+
onTransition(callback: () => void): () => void;
|
|
244
|
+
/**
|
|
245
|
+
* Create a serializable snapshot of the current FSM state.
|
|
246
|
+
*
|
|
247
|
+
* Used with `FsmStateStore` for serverless deployments where
|
|
248
|
+
* FSM state must survive across request boundaries.
|
|
249
|
+
*
|
|
250
|
+
* @returns Serializable snapshot
|
|
251
|
+
*/
|
|
252
|
+
snapshot(): FsmSnapshot;
|
|
253
|
+
/**
|
|
254
|
+
* Restore FSM state from a persisted snapshot.
|
|
255
|
+
*
|
|
256
|
+
* @param snap - Previously saved snapshot
|
|
257
|
+
*/
|
|
258
|
+
restore(snap: FsmSnapshot): void;
|
|
259
|
+
/**
|
|
260
|
+
* Stop the XState actor and release resources.
|
|
261
|
+
*/
|
|
262
|
+
dispose(): void;
|
|
263
|
+
}
|
|
264
|
+
//# sourceMappingURL=StateMachineGate.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"StateMachineGate.d.ts","sourceRoot":"","sources":["../../src/fsm/StateMachineGate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAIH;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACtB,+CAA+C;IAC/C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QACnB,wEAAwE;QACxE,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5B,gDAAgD;QAChD,IAAI,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;CACN;AAcD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,aAAa;IAC1B,oFAAoF;IACpF,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAC1D,yCAAyC;IACzC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;CACxB;AA6BD;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAEtD;AAID;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAyB;IAC9D,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAE7B;;OAEG;gBACS,MAAM,EAAE,SAAS;IAO7B;;;;;;;OAOG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAmC9B;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,gBAAgB;IAW/F;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;;;;;OAQG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAMxC;;;;;OAKG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAIlD;;;;;OAKG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIxD;;;;OAIG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAID;;;;;OAKG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuB9D;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;;;;;;;OAQG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAU9C;;;;;;;OAOG;IACH,QAAQ,IAAI,WAAW;IAOvB;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAQhC;;OAEG;IACH,OAAO,IAAI,IAAI;CAOlB"}
|