@vinkius-core/mcp-fusion 0.1.0

package/dist/src/framework/ToolRegistry.js

@@ -0,0 +1,153 @@
+import { ListToolsRequestSchema, CallToolRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { error } from './ResponseHelper.js';
+// ============================================================================
+// ToolRegistry
+// ============================================================================
+export class ToolRegistry {
+    constructor() {
+        this._builders = new Map();
+    }
+    /** Register a tool builder. Throws on duplicate name. */
+    register(builder) {
+        const name = builder.getName();
+        if (this._builders.has(name)) {
+            throw new Error(`Tool "${name}" is already registered.`);
+        }
+        // Ensure tool is built (triggers validation + caching)
+        builder.buildToolDefinition();
+        this._builders.set(name, builder);
+    }
+    /** Register multiple builders at once */
+    registerAll(...builders) {
+        for (const builder of builders) {
+            this.register(builder);
+        }
+    }
+    /** Get all tool definitions */
+    getAllTools() {
+        return Array.from(this._builders.values())
+            .map(b => b.buildToolDefinition());
+    }
+    /** Get tool definitions filtered by tags */
+    getTools(filter) {
+        return Array.from(this._builders.values())
+            .filter(builder => {
+            const builderTags = builder.getTags();
+            // If tags filter specified, builder must have ALL of them
+            if (filter.tags && filter.tags.length > 0) {
+                if (!filter.tags.every(t => builderTags.includes(t))) {
+                    return false;
+                }
+            }
+            // If exclude filter specified, builder must not have ANY of them
+            if (filter.exclude && filter.exclude.length > 0) {
+                if (filter.exclude.some(t => builderTags.includes(t))) {
+                    return false;
+                }
+            }
+            return true;
+        })
+            .map(b => b.buildToolDefinition());
+    }
+    /** Route a call to the correct builder */
+    async routeCall(ctx, name, args) {
+        const builder = this._builders.get(name);
+        if (!builder) {
+            const available = Array.from(this._builders.keys()).join(', ');
+            return error(`Unknown tool: "${name}". Available tools: ${available}`);
+        }
+        return builder.execute(ctx, args);
+    }
+    /**
+     * Attach this registry to an MCP Server — 1-line integration.
+     *
+     * Supports both:
+     * - `Server` (low-level): `import { Server } from '@modelcontextprotocol/sdk/server/index.js'`
+     * - `McpServer` (high-level): `import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'`
+     *
+     * @example
+     * ```typescript
+     * // Minimal — void context
+     * registry.attachToServer(server);
+     *
+     * // With tag filtering
+     * registry.attachToServer(server, { filter: { tags: ['public'] } });
+     *
+     * // With per-request context
+     * registry.attachToServer(server, {
+     *     contextFactory: (extra) => ({ session: extra })
+     * });
+     * ```
+     *
+     * @returns A detach function to remove the handlers.
+     */
+    attachToServer(server, options = {}) {
+        // Resolve the low-level Server instance
+        const resolved = this._resolveServer(server);
+        const { filter, contextFactory } = options;
+        // ── tools/list handler ────────────────────────────────────────
+        const listHandler = () => {
+            const tools = filter
+                ? this.getTools(filter)
+                : this.getAllTools();
+            return { tools };
+        };
+        // ── tools/call handler ────────────────────────────────────────
+        const callHandler = async (request, extra) => {
+            const { name, arguments: args = {} } = request.params;
+            const ctx = contextFactory
+                ? contextFactory(extra)
+                : undefined;
+            return this.routeCall(ctx, name, args);
+        };
+        // Register both handlers
+        resolved.setRequestHandler(ListToolsRequestSchema, listHandler);
+        resolved.setRequestHandler(CallToolRequestSchema, callHandler);
+        // Return detach function
+        return () => {
+            // Reset handlers to no-op
+            resolved.setRequestHandler(ListToolsRequestSchema, () => ({ tools: [] }));
+            resolved.setRequestHandler(CallToolRequestSchema, async () => error('Tool handlers have been detached'));
+        };
+    }
+    /** Check if a tool is registered */
+    has(name) {
+        return this._builders.has(name);
+    }
+    /** Remove all registered tools */
+    clear() {
+        this._builders.clear();
+    }
+    /** Get count of registered tools */
+    get size() {
+        return this._builders.size;
+    }
+    // ── Private ──────────────────────────────────────────────────────
+    /**
+     * Resolve the low-level Server instance from either a `Server` or `McpServer`.
+     *
+     * Uses duck-typing to detect the server type:
+     * - `McpServer` has a `.server` property that exposes the low-level `Server`
+     * - `Server` has `setRequestHandler` directly
+     */
+    _resolveServer(server) {
+        if (!server || typeof server !== 'object') {
+            throw new Error('attachToServer() requires a Server or McpServer instance.');
+        }
+        // McpServer wraps a Server at `.server`
+        const maybeHigh = server;
+        if ('server' in maybeHigh &&
+            maybeHigh.server &&
+            typeof maybeHigh.server === 'object' &&
+            'setRequestHandler' in maybeHigh.server) {
+            return maybeHigh.server;
+        }
+        // Low-level Server has setRequestHandler directly
+        if ('setRequestHandler' in server) {
+            return server;
+        }
+        throw new Error('attachToServer() requires a Server or McpServer instance. ' +
+            'The provided object does not have setRequestHandler().');
+    }
+}
+//# sourceMappingURL=ToolRegistry.js.map

package/dist/src/framework/ToolRegistry.js.map

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

package/dist/src/framework/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Framework — Barrel Export
+ */
+export { success, error, required, toonSuccess, type ToolResponse } from './ResponseHelper.js';
+export { GroupedToolBuilder, ActionGroupBuilder, type ActionConfig, type MiddlewareFn, type GroupConfigurator, } from './GroupedToolBuilder.js';
+export { type ToolBuilder, type ActionMetadata } from './ToolBuilder.js';
+export { ToolRegistry, type ToolFilter, type AttachOptions, type DetachFn } from './ToolRegistry.js';
+export { generateToonDescription } from './strategies/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/framework/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/framework/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EACH,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACrG,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/framework/index.js

@@ -0,0 +1,8 @@
+/**
+ * Framework — Barrel Export
+ */
+export { success, error, required, toonSuccess } from './ResponseHelper.js';
+export { GroupedToolBuilder, ActionGroupBuilder, } from './GroupedToolBuilder.js';
+export { ToolRegistry } from './ToolRegistry.js';
+export { generateToonDescription } from './strategies/index.js';
+//# sourceMappingURL=index.js.map

package/dist/src/framework/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/framework/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAqB,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EACH,kBAAkB,EAClB,kBAAkB,GAIrB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAsD,MAAM,mBAAmB,CAAC;AACrG,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/framework/strategies/AnnotationAggregator.d.ts

@@ -0,0 +1,11 @@
+/**
+ * AnnotationAggregator — Tool Annotation Aggregation Strategy
+ *
+ * Aggregates per-action hints (readOnly, destructive, idempotent)
+ * into a single annotation record, with explicit overrides.
+ *
+ * Pure-function module: no state, no side effects.
+ */
+import type { InternalAction } from './Types.js';
+export declare function aggregateAnnotations<TContext>(actions: readonly InternalAction<TContext>[], explicitAnnotations: Record<string, unknown> | undefined): Record<string, unknown>;
+//# sourceMappingURL=AnnotationAggregator.d.ts.map

package/dist/src/framework/strategies/AnnotationAggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnnotationAggregator.d.ts","sourceRoot":"","sources":["../../../../src/framework/strategies/AnnotationAggregator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,wBAAgB,oBAAoB,CAAC,QAAQ,EACzC,OAAO,EAAE,SAAS,cAAc,CAAC,QAAQ,CAAC,EAAE,EAC5C,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACzD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2BzB"}

package/dist/src/framework/strategies/AnnotationAggregator.js

@@ -0,0 +1,25 @@
+// ── Public API ───────────────────────────────────────────
+export function aggregateAnnotations(actions, explicitAnnotations) {
+    const result = {};
+    // Copy explicit annotations
+    if (explicitAnnotations) {
+        Object.assign(result, explicitAnnotations);
+    }
+    // Per-action aggregation (only override if not explicitly set)
+    if ((explicitAnnotations === null || explicitAnnotations === void 0 ? void 0 : explicitAnnotations.readOnlyHint) === undefined) {
+        const allReadOnly = actions.length > 0 &&
+            actions.every(a => a.readOnly === true);
+        result.readOnlyHint = allReadOnly;
+    }
+    if ((explicitAnnotations === null || explicitAnnotations === void 0 ? void 0 : explicitAnnotations.destructiveHint) === undefined) {
+        const anyDestructive = actions.some(a => a.destructive === true);
+        result.destructiveHint = anyDestructive;
+    }
+    if ((explicitAnnotations === null || explicitAnnotations === void 0 ? void 0 : explicitAnnotations.idempotentHint) === undefined) {
+        const allIdempotent = actions.length > 0 &&
+            actions.every(a => a.idempotent === true);
+        result.idempotentHint = allIdempotent;
+    }
+    return result;
+}
+//# sourceMappingURL=AnnotationAggregator.js.map

package/dist/src/framework/strategies/AnnotationAggregator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnnotationAggregator.js","sourceRoot":"","sources":["../../../../src/framework/strategies/AnnotationAggregator.ts"],"names":[],"mappings":"AAUA,4DAA4D;AAE5D,MAAM,UAAU,oBAAoB,CAChC,OAA4C,EAC5C,mBAAwD;IAExD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,4BAA4B;IAC5B,IAAI,mBAAmB,EAAE,CAAC;QACtB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC/C,CAAC;IAED,+DAA+D;IAC/D,IAAI,CAAA,mBAAmB,aAAnB,mBAAmB,uBAAnB,mBAAmB,CAAE,YAAY,MAAK,SAAS,EAAE,CAAC;QAClD,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,YAAY,GAAG,WAAW,CAAC;IACtC,CAAC;IAED,IAAI,CAAA,mBAAmB,aAAnB,mBAAmB,uBAAnB,mBAAmB,CAAE,eAAe,MAAK,SAAS,EAAE,CAAC;QACrD,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC;QACjE,MAAM,CAAC,eAAe,GAAG,cAAc,CAAC;IAC5C,CAAC;IAED,IAAI,CAAA,mBAAmB,aAAnB,mBAAmB,uBAAnB,mBAAmB,CAAE,cAAc,MAAK,SAAS,EAAE,CAAC;QACpD,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC;YACpC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC;QAC9C,MAAM,CAAC,cAAc,GAAG,aAAa,CAAC;IAC1C,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/src/framework/strategies/DescriptionGenerator.d.ts

@@ -0,0 +1,12 @@
+/**
+ * DescriptionGenerator — LLM-friendly Tool Description Strategy
+ *
+ * Generates 3-layer descriptions from action metadata:
+ * - Layer 1: Tool summary + module/action listing
+ * - Layer 2: Workflow section with required params and destructive warnings
+ *
+ * Pure-function module: no state, no side effects.
+ */
+import type { InternalAction } from './Types.js';
+export declare function generateDescription<TContext>(actions: readonly InternalAction<TContext>[], name: string, description: string | undefined, hasGroup: boolean): string;
+//# sourceMappingURL=DescriptionGenerator.d.ts.map

package/dist/src/framework/strategies/DescriptionGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DescriptionGenerator.d.ts","sourceRoot":"","sources":["../../../../src/framework/strategies/DescriptionGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjD,wBAAgB,mBAAmB,CAAC,QAAQ,EACxC,OAAO,EAAE,SAAS,cAAc,CAAC,QAAQ,CAAC,EAAE,EAC5C,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,QAAQ,EAAE,OAAO,GAClB,MAAM,CA8BR"}

package/dist/src/framework/strategies/DescriptionGenerator.js

@@ -0,0 +1,70 @@
+import { getActionRequiredFields } from './SchemaUtils.js';
+// ── Public API ───────────────────────────────────────────
+export function generateDescription(actions, name, description, hasGroup) {
+    const lines = [];
+    // Layer 1: Tool description + action/module summary
+    if (hasGroup) {
+        const groups = getGroupSummaries(actions);
+        const moduleList = groups
+            .map(g => `${g.name} (${g.actions.join(',')})`)
+            .join(' | ');
+        lines.push(`${description || name}. ` +
+            `Modules: ${moduleList}`);
+    }
+    else {
+        const actionNames = actions.map(a => a.key);
+        lines.push(`${description || name}. ` +
+            `Actions: ${actionNames.join(', ')}`);
+    }
+    // Layer 2: Workflow section
+    const workflowLines = generateWorkflowLines(actions);
+    if (workflowLines.length > 0) {
+        lines.push('');
+        lines.push('Workflow:');
+        lines.push(...workflowLines);
+    }
+    return lines.join('\n');
+}
+// ── Internal helpers ─────────────────────────────────────
+function generateWorkflowLines(actions) {
+    const lines = [];
+    for (const action of actions) {
+        const requiredFields = getActionRequiredFields(action);
+        const isDestructive = action.destructive === true;
+        if (!action.description && requiredFields.length === 0 && !isDestructive) {
+            continue;
+        }
+        let line = `- '${action.key}': `;
+        if (action.description) {
+            line += action.description;
+        }
+        if (requiredFields.length > 0) {
+            line += action.description ? '. Requires: ' : 'Requires: ';
+            line += requiredFields.join(', ');
+        }
+        if (isDestructive) {
+            line += ' ⚠️ DESTRUCTIVE';
+        }
+        lines.push(line);
+    }
+    return lines;
+}
+function getGroupSummaries(actions) {
+    const groups = new Map();
+    for (const action of actions) {
+        if (!action.groupName)
+            continue;
+        let group = groups.get(action.groupName);
+        if (!group) {
+            group = { description: action.groupDescription || '', actions: [] };
+            groups.set(action.groupName, group);
+        }
+        group.actions.push(action.actionName);
+    }
+    return Array.from(groups.entries()).map(([name, data]) => ({
+        name,
+        description: data.description,
+        actions: data.actions,
+    }));
+}
+//# sourceMappingURL=DescriptionGenerator.js.map

package/dist/src/framework/strategies/DescriptionGenerator.js.map

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

package/dist/src/framework/strategies/MiddlewareCompiler.d.ts

@@ -0,0 +1,13 @@
+/**
+ * MiddlewareCompiler — Middleware Chain Pre-Compilation Strategy
+ *
+ * Wraps middlewares right-to-left around each action handler,
+ * producing a ready-to-execute chain per action key.
+ *
+ * Pure-function module: no state, no side effects.
+ */
+import type { ToolResponse } from '../ResponseHelper.js';
+import type { InternalAction, MiddlewareFn } from './Types.js';
+export type CompiledChain<TContext> = Map<string, (ctx: TContext, args: Record<string, unknown>) => Promise<ToolResponse>>;
+export declare function compileMiddlewareChains<TContext>(actions: readonly InternalAction<TContext>[], middlewares: readonly MiddlewareFn<TContext>[]): CompiledChain<TContext>;
+//# sourceMappingURL=MiddlewareCompiler.d.ts.map

package/dist/src/framework/strategies/MiddlewareCompiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MiddlewareCompiler.d.ts","sourceRoot":"","sources":["../../../../src/framework/strategies/MiddlewareCompiler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/D,MAAM,MAAM,aAAa,CAAC,QAAQ,IAAI,GAAG,CACrC,MAAM,EACN,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,CAC1E,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,QAAQ,EAC5C,OAAO,EAAE,SAAS,cAAc,CAAC,QAAQ,CAAC,EAAE,EAC5C,WAAW,EAAE,SAAS,YAAY,CAAC,QAAQ,CAAC,EAAE,GAC/C,aAAa,CAAC,QAAQ,CAAC,CA4BzB"}

package/dist/src/framework/strategies/MiddlewareCompiler.js

@@ -0,0 +1,24 @@
+export function compileMiddlewareChains(actions, middlewares) {
+    var _a;
+    const compiled = new Map();
+    for (const action of actions) {
+        // Build the chain: global middlewares → group/action middlewares → handler
+        let chain = action.handler;
+        // Per-action/group middleware (innermost, closest to handler)
+        const actionMws = (_a = action.middlewares) !== null && _a !== void 0 ? _a : [];
+        for (let i = actionMws.length - 1; i >= 0; i--) {
+            const mw = actionMws[i];
+            const nextFn = chain;
+            chain = (ctx, args) => mw(ctx, args, () => nextFn(ctx, args));
+        }
+        // Global middleware (outermost)
+        for (let i = middlewares.length - 1; i >= 0; i--) {
+            const mw = middlewares[i];
+            const nextFn = chain;
+            chain = (ctx, args) => mw(ctx, args, () => nextFn(ctx, args));
+        }
+        compiled.set(action.key, chain);
+    }
+    return compiled;
+}
+//# sourceMappingURL=MiddlewareCompiler.js.map

package/dist/src/framework/strategies/MiddlewareCompiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MiddlewareCompiler.js","sourceRoot":"","sources":["../../../../src/framework/strategies/MiddlewareCompiler.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,uBAAuB,CACnC,OAA4C,EAC5C,WAA8C;;IAE9C,MAAM,QAAQ,GAA4B,IAAI,GAAG,EAAE,CAAC;IAEpD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,2EAA2E;QAC3E,IAAI,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC;QAE3B,8DAA8D;QAC9D,MAAM,SAAS,GAAG,MAAA,MAAM,CAAC,WAAW,mCAAI,EAAE,CAAC;QAC3C,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YACxB,MAAM,MAAM,GAAG,KAAK,CAAC;YACrB,KAAK,GAAG,CAAC,GAAa,EAAE,IAA6B,EAAE,EAAE,CACrD,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QAC/C,CAAC;QAED,gCAAgC;QAChC,KAAK,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,MAAM,GAAG,KAAK,CAAC;YACrB,KAAK,GAAG,CAAC,GAAa,EAAE,IAA6B,EAAE,EAAE,CACrD,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QAC/C,CAAC;QAED,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/dist/src/framework/strategies/SchemaGenerator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SchemaGenerator — JSON Schema Input Schema Strategy
+ *
+ * Generates MCP-compatible inputSchema from Zod definitions:
+ * - Discriminator enum from action keys
+ * - Common + per-action schema merging
+ * - Per-field annotations (required-for / optional-for)
+ *
+ * Pure-function module: no state, no side effects.
+ */
+import type { ZodObject, ZodRawShape } from 'zod';
+import type { Tool as McpTool } from '@modelcontextprotocol/sdk/types.js';
+import type { InternalAction } from './Types.js';
+export declare function generateInputSchema<TContext>(actions: readonly InternalAction<TContext>[], discriminator: string, hasGroup: boolean, commonSchema: ZodObject<ZodRawShape> | undefined): McpTool['inputSchema'];
+//# sourceMappingURL=SchemaGenerator.d.ts.map

package/dist/src/framework/strategies/SchemaGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaGenerator.d.ts","sourceRoot":"","sources":["../../../../src/framework/strategies/SchemaGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAElD,OAAO,KAAK,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,wBAAgB,mBAAmB,CAAC,QAAQ,EACxC,OAAO,EAAE,SAAS,cAAc,CAAC,QAAQ,CAAC,EAAE,EAC5C,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,SAAS,GACjD,OAAO,CAAC,aAAa,CAAC,CA0FxB"}

package/dist/src/framework/strategies/SchemaGenerator.js

@@ -0,0 +1,97 @@
+import { zodToJsonSchema } from 'zod-to-json-schema';
+// ── Public API ───────────────────────────────────────────
+export function generateInputSchema(actions, discriminator, hasGroup, commonSchema) {
+    const actionKeys = actions.map(a => a.key);
+    const properties = {};
+    const topLevelRequired = [discriminator];
+    // Discriminator field with enum
+    properties[discriminator] = {
+        type: 'string',
+        enum: actionKeys,
+        description: hasGroup
+            ? `Module and operation (module.${discriminator} format)`
+            : 'Which operation to perform',
+    };
+    // Track field → action keys mapping for annotations
+    const fieldActions = new Map();
+    // Common schema fields
+    const commonRequiredFields = new Set();
+    if (commonSchema) {
+        const jsonSchema = zodToJsonSchema(commonSchema, { target: 'jsonSchema7' });
+        const schemaObj = jsonSchema;
+        const schemaProps = (schemaObj.properties || {});
+        const schemaRequired = (schemaObj.required || []);
+        for (const field of schemaRequired) {
+            commonRequiredFields.add(field);
+            topLevelRequired.push(field);
+        }
+        for (const [key, value] of Object.entries(schemaProps)) {
+            properties[key] = value;
+            fieldActions.set(key, {
+                keys: [...actionKeys],
+                requiredIn: commonRequiredFields.has(key) ? [...actionKeys] : [],
+            });
+        }
+    }
+    // Per-action schema fields
+    for (const action of actions) {
+        if (!action.schema)
+            continue;
+        const jsonSchema = zodToJsonSchema(action.schema, { target: 'jsonSchema7' });
+        const schemaObj = jsonSchema;
+        const schemaProps = (schemaObj.properties || {});
+        const schemaRequired = (schemaObj.required || []);
+        const requiredSet = new Set(schemaRequired);
+        for (const [key, value] of Object.entries(schemaProps)) {
+            // First declaration wins
+            if (!properties[key]) {
+                properties[key] = value;
+            }
+            let tracking = fieldActions.get(key);
+            if (!tracking) {
+                tracking = { keys: [], requiredIn: [] };
+                fieldActions.set(key, tracking);
+            }
+            tracking.keys.push(action.key);
+            if (requiredSet.has(key)) {
+                tracking.requiredIn.push(action.key);
+            }
+        }
+    }
+    // Apply per-field annotations
+    for (const [key, tracking] of fieldActions.entries()) {
+        if (commonRequiredFields.has(key)) {
+            annotateField(properties, key, '(always required)');
+        }
+        else if (tracking.requiredIn.length > 0 && tracking.requiredIn.length === tracking.keys.length) {
+            annotateField(properties, key, `Required for: ${tracking.requiredIn.join(', ')}`);
+        }
+        else if (tracking.requiredIn.length > 0) {
+            const optionalIn = tracking.keys.filter(k => !tracking.requiredIn.includes(k));
+            let annotation = `Required for: ${tracking.requiredIn.join(', ')}`;
+            if (optionalIn.length > 0) {
+                annotation += `. For: ${optionalIn.join(', ')}`;
+            }
+            annotateField(properties, key, annotation);
+        }
+        else {
+            annotateField(properties, key, `For: ${tracking.keys.join(', ')}`);
+        }
+    }
+    return {
+        type: 'object',
+        properties,
+        required: topLevelRequired,
+    };
+}
+// ── Internal helpers ─────────────────────────────────────
+function annotateField(properties, key, annotation) {
+    const field = properties[key];
+    if (!field)
+        return;
+    const existingDesc = field.description || '';
+    field.description = existingDesc
+        ? `${existingDesc}. ${annotation}`
+        : annotation;
+}
+//# sourceMappingURL=SchemaGenerator.js.map

package/dist/src/framework/strategies/SchemaGenerator.js.map

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

package/dist/src/framework/strategies/SchemaUtils.d.ts

@@ -0,0 +1,7 @@
+import type { InternalAction } from './Types.js';
+/**
+ * Get the list of required field names from an action's Zod schema.
+ * Returns an empty array if the action has no schema.
+ */
+export declare function getActionRequiredFields<TContext>(action: InternalAction<TContext>): string[];
+//# sourceMappingURL=SchemaUtils.d.ts.map

package/dist/src/framework/strategies/SchemaUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaUtils.d.ts","sourceRoot":"","sources":["../../../../src/framework/strategies/SchemaUtils.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE,CAU5F"}

package/dist/src/framework/strategies/SchemaUtils.js

@@ -0,0 +1,17 @@
+/**
+ * Get the list of required field names from an action's Zod schema.
+ * Returns an empty array if the action has no schema.
+ */
+export function getActionRequiredFields(action) {
+    if (!action.schema)
+        return [];
+    const shape = action.schema.shape;
+    const required = [];
+    for (const [key, fieldSchema] of Object.entries(shape)) {
+        if (!(fieldSchema.isOptional())) {
+            required.push(key);
+        }
+    }
+    return required;
+}
+//# sourceMappingURL=SchemaUtils.js.map

package/dist/src/framework/strategies/SchemaUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaUtils.js","sourceRoot":"","sources":["../../../../src/framework/strategies/SchemaUtils.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAW,MAAgC;IAC9E,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;IAClC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,CAAE,WAA4B,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;YAChD,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/dist/src/framework/strategies/ToonDescriptionGenerator.d.ts

@@ -0,0 +1,3 @@
+import type { InternalAction } from './Types.js';
+export declare function generateToonDescription<TContext>(actions: readonly InternalAction<TContext>[], name: string, description: string | undefined, hasGroup: boolean): string;
+//# sourceMappingURL=ToonDescriptionGenerator.d.ts.map

package/dist/src/framework/strategies/ToonDescriptionGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToonDescriptionGenerator.d.ts","sourceRoot":"","sources":["../../../../src/framework/strategies/ToonDescriptionGenerator.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjD,wBAAgB,uBAAuB,CAAC,QAAQ,EAC5C,OAAO,EAAE,SAAS,cAAc,CAAC,QAAQ,CAAC,EAAE,EAC5C,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,QAAQ,EAAE,OAAO,GAClB,MAAM,CAeR"}

package/dist/src/framework/strategies/ToonDescriptionGenerator.js

@@ -0,0 +1,53 @@
+import { encode } from '@toon-format/toon';
+import { getActionRequiredFields } from './SchemaUtils.js';
+// ── Public API ───────────────────────────────────────────
+export function generateToonDescription(actions, name, description, hasGroup) {
+    const lines = [];
+    // Layer 1: Tool summary (always human-readable)
+    lines.push(description || name);
+    lines.push('');
+    // Layer 2: Action metadata in TOON tabular format
+    if (hasGroup) {
+        lines.push(encodeGroupedActions(actions));
+    }
+    else {
+        lines.push(encodeFlatActions(actions));
+    }
+    return lines.join('\n');
+}
+function encodeFlatActions(actions) {
+    const rows = actions.map(a => buildActionRow(a.key, a));
+    return encode(rows, { delimiter: '|' });
+}
+function encodeGroupedActions(actions) {
+    // Group actions by their groupName
+    const groups = new Map();
+    for (const action of actions) {
+        const key = action.groupName || '_ungrouped';
+        let list = groups.get(key);
+        if (!list) {
+            list = [];
+            groups.set(key, list);
+        }
+        list.push(action);
+    }
+    // Build a structure that TOON can encode efficiently
+    const groupData = {};
+    for (const [groupName, groupActions] of groups) {
+        groupData[groupName] = groupActions.map(a => buildActionRow(a.actionName, a));
+    }
+    return encode(groupData, { delimiter: '|' });
+}
+function buildActionRow(key, action) {
+    const required = getActionRequiredFields(action);
+    const row = {
+        action: key,
+        desc: action.description || '',
+        required: required.join(','),
+    };
+    if (action.destructive) {
+        row.destructive = true;
+    }
+    return row;
+}
+//# sourceMappingURL=ToonDescriptionGenerator.js.map

package/dist/src/framework/strategies/ToonDescriptionGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToonDescriptionGenerator.js","sourceRoot":"","sources":["../../../../src/framework/strategies/ToonDescriptionGenerator.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,4DAA4D;AAE5D,MAAM,UAAU,uBAAuB,CACnC,OAA4C,EAC5C,IAAY,EACZ,WAA+B,EAC/B,QAAiB;IAEjB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,gDAAgD;IAChD,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,kDAAkD;IAClD,IAAI,QAAQ,EAAE,CAAC;QACX,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACJ,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAWD,SAAS,iBAAiB,CACtB,OAA4C;IAE5C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IACxD,OAAO,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,oBAAoB,CACzB,OAA4C;IAE5C,mCAAmC;IACnC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsC,CAAC;IAC7D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,YAAY,CAAC;QAC7C,IAAI,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,IAAI,GAAG,EAAE,CAAC;YACV,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IAED,qDAAqD;IACrD,MAAM,SAAS,GAAgC,EAAE,CAAC;IAClD,KAAK,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,IAAI,MAAM,EAAE,CAAC;QAC7C,SAAS,CAAC,SAAS,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CACxC,cAAc,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAClC,CAAC;IACN,CAAC;IAED,OAAO,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,cAAc,CACnB,GAAW,EACX,MAAgC;IAEhC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,GAAG,GAAc;QACnB,MAAM,EAAE,GAAG;QACX,IAAI,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;QAC9B,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;KAC/B,CAAC;IAEF,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACrB,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC"}