@vinkius-core/mcp-fusion 0.1.0

package/dist/src/framework/GroupedToolBuilder.js

@@ -0,0 +1,289 @@
+import { error } from './ResponseHelper.js';
+import { generateDescription } from './strategies/DescriptionGenerator.js';
+import { generateToonDescription } from './strategies/ToonDescriptionGenerator.js';
+import { generateInputSchema } from './strategies/SchemaGenerator.js';
+import { aggregateAnnotations } from './strategies/AnnotationAggregator.js';
+import { compileMiddlewareChains } from './strategies/MiddlewareCompiler.js';
+import { getActionRequiredFields } from './strategies/SchemaUtils.js';
+// ============================================================================
+// ActionGroupBuilder (used in .group() callback)
+// ============================================================================
+export class ActionGroupBuilder {
+    constructor(groupName, description) {
+        /** @internal */
+        this._actions = [];
+        this._groupMiddlewares = [];
+        this._groupName = groupName;
+        this._groupDescription = description || '';
+    }
+    /** Add middleware scoped to this group */
+    use(mw) {
+        this._groupMiddlewares.push(mw);
+        return this;
+    }
+    action(config) {
+        if (config.name.includes('.')) {
+            throw new Error(`Action name "${config.name}" must not contain dots. ` +
+                `The framework uses dots internally for group.action compound keys.`);
+        }
+        this._actions.push({
+            key: `${this._groupName}.${config.name}`,
+            groupName: this._groupName,
+            groupDescription: this._groupDescription,
+            actionName: config.name,
+            description: config.description,
+            schema: config.schema,
+            destructive: config.destructive,
+            idempotent: config.idempotent,
+            readOnly: config.readOnly,
+            handler: config.handler,
+            middlewares: this._groupMiddlewares.length > 0
+                ? [...this._groupMiddlewares] : undefined,
+        });
+        return this;
+    }
+}
+// ============================================================================
+// GroupedToolBuilder
+// ============================================================================
+export class GroupedToolBuilder {
+    constructor(name) {
+        this._discriminator = 'action';
+        this._tags = [];
+        this._middlewares = [];
+        this._actions = [];
+        this._hasFlat = false;
+        this._hasGroup = false;
+        this._toonMode = false;
+        this._frozen = false;
+        this._name = name;
+    }
+    // ── Configuration (fluent) ──────────────────────────
+    /** Set the discriminator field name (default: "action") */
+    discriminator(field) {
+        this._assertNotFrozen();
+        this._discriminator = field;
+        return this;
+    }
+    /** Set the tool description (first line) */
+    description(desc) {
+        this._assertNotFrozen();
+        this._description = desc;
+        return this;
+    }
+    /** Set MCP tool annotations */
+    annotations(a) {
+        this._assertNotFrozen();
+        this._annotations = a;
+        return this;
+    }
+    /** Set capability tags for selective exposure */
+    tags(...tags) {
+        this._assertNotFrozen();
+        this._tags = tags;
+        return this;
+    }
+    /** Set common schema shared by all actions (propagates types to handlers) */
+    commonSchema(schema) {
+        this._assertNotFrozen();
+        this._commonSchema = schema;
+        return this;
+    }
+    /**
+     * Enable TOON-formatted descriptions for token optimization.
+     *
+     * Uses TOON (Token-Oriented Object Notation) to encode action metadata
+     * in a compact tabular format, reducing description token count by ~30-50%.
+     *
+     * @example
+     * ```typescript
+     * new GroupedToolBuilder('projects')
+     *   .description('Manage projects')
+     *   .toonDescription()
+     *   .action({ name: 'list', ... })
+     * ```
+     */
+    toonDescription() {
+        this._assertNotFrozen();
+        this._toonMode = true;
+        return this;
+    }
+    /** Add middleware to the chain */
+    use(mw) {
+        this._assertNotFrozen();
+        this._middlewares.push(mw);
+        return this;
+    }
+    action(config) {
+        this._assertNotFrozen();
+        if (this._hasGroup) {
+            throw new Error(`Cannot use .action() and .group() on the same builder "${this._name}". ` +
+                `Use .action() for flat tools OR .group() for hierarchical tools.`);
+        }
+        this._hasFlat = true;
+        if (config.name.includes('.')) {
+            throw new Error(`Action name "${config.name}" must not contain dots. ` +
+                `The framework uses dots internally for group.action compound keys.`);
+        }
+        this._actions.push({
+            key: config.name,
+            actionName: config.name,
+            description: config.description,
+            schema: config.schema,
+            destructive: config.destructive,
+            idempotent: config.idempotent,
+            readOnly: config.readOnly,
+            handler: config.handler,
+        });
+        return this;
+    }
+    group(name, descriptionOrConfigure, maybeConfigure) {
+        this._assertNotFrozen();
+        const description = typeof descriptionOrConfigure === 'string'
+            ? descriptionOrConfigure
+            : undefined;
+        const configure = typeof descriptionOrConfigure === 'function'
+            ? descriptionOrConfigure
+            : maybeConfigure;
+        if (this._hasFlat) {
+            throw new Error(`Cannot use .group() and .action() on the same builder "${this._name}". ` +
+                `Use .action() for flat tools OR .group() for hierarchical tools.`);
+        }
+        if (name.includes('.')) {
+            throw new Error(`Group name "${name}" must not contain dots.`);
+        }
+        this._hasGroup = true;
+        const groupBuilder = new ActionGroupBuilder(name, description);
+        configure(groupBuilder);
+        this._actions.push(...groupBuilder._actions);
+        return this;
+    }
+    // ── Build ───────────────────────────────────────────
+    /** Generate the MCP Tool definition. Caches result and freezes the builder. */
+    buildToolDefinition() {
+        if (this._cachedTool)
+            return this._cachedTool;
+        if (this._actions.length === 0) {
+            throw new Error(`Builder "${this._name}" has no actions registered.`);
+        }
+        // Delegate to strategy functions
+        const descriptionFn = this._toonMode ? generateToonDescription : generateDescription;
+        const description = descriptionFn(this._actions, this._name, this._description, this._hasGroup);
+        const inputSchema = generateInputSchema(this._actions, this._discriminator, this._hasGroup, this._commonSchema);
+        const annotations = aggregateAnnotations(this._actions, this._annotations);
+        const tool = {
+            name: this._name,
+            description,
+            inputSchema,
+        };
+        if (annotations && Object.keys(annotations).length > 0) {
+            tool.annotations = annotations;
+        }
+        // Pre-compile middleware chains via strategy
+        this._compiledChain = compileMiddlewareChains(this._actions, this._middlewares);
+        // Cache, freeze builder, and seal actions array
+        this._cachedTool = tool;
+        this._frozen = true;
+        Object.freeze(this._actions);
+        return tool;
+    }
+    // ── Execute ─────────────────────────────────────────
+    /** Route a call: validate → middleware → handler */
+    async execute(ctx, args) {
+        // Ensure built
+        if (!this._compiledChain) {
+            this.buildToolDefinition();
+        }
+        // 1. Parse discriminator
+        const discriminatorValue = args[this._discriminator];
+        if (!discriminatorValue) {
+            return error(`Error: ${this._discriminator} is required. ` +
+                `Available: ${this._actions.map(a => a.key).join(', ')}`);
+        }
+        // 2. Find action
+        const action = this._actions.find(a => a.key === discriminatorValue);
+        if (!action) {
+            return error(`Error: Unknown ${this._discriminator} "${discriminatorValue}". ` +
+                `Available: ${this._actions.map(a => a.key).join(', ')}`);
+        }
+        // 3. Validate & strip args with Zod
+        const validationSchema = this._buildValidationSchema(action);
+        if (validationSchema) {
+            // Remove discriminator before validation
+            const { [this._discriminator]: _, ...argsWithoutDiscriminator } = args;
+            const result = validationSchema.safeParse(argsWithoutDiscriminator);
+            if (!result.success) {
+                const issues = result.error.issues
+                    .map(i => `${i.path.join('.')}: ${i.message}`)
+                    .join('; ');
+                return error(`Validation failed: ${issues}`);
+            }
+            // Use validated + stripped args
+            args = { ...result.data, [this._discriminator]: discriminatorValue };
+        }
+        // 4. Run pre-compiled middleware chain → handler
+        const chain = this._compiledChain.get(action.key);
+        try {
+            return await chain(ctx, args);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return error(`[${this._name}/${discriminatorValue}] ${message}`);
+        }
+    }
+    // ── Introspection ───────────────────────────────────
+    /** Get the tool name */
+    getName() {
+        return this._name;
+    }
+    /** Get the tags */
+    getTags() {
+        return [...this._tags];
+    }
+    /** Get all action keys */
+    getActionNames() {
+        return this._actions.map(a => a.key);
+    }
+    /** Get metadata for all registered actions (for enterprise observability) */
+    getActionMetadata() {
+        return this._actions.map(a => {
+            var _a, _b, _c, _d, _e;
+            return ({
+                key: a.key,
+                actionName: a.actionName,
+                groupName: a.groupName,
+                description: a.description,
+                destructive: (_a = a.destructive) !== null && _a !== void 0 ? _a : false,
+                idempotent: (_b = a.idempotent) !== null && _b !== void 0 ? _b : false,
+                readOnly: (_c = a.readOnly) !== null && _c !== void 0 ? _c : false,
+                requiredFields: getActionRequiredFields(a),
+                hasMiddleware: ((_e = (_d = a.middlewares) === null || _d === void 0 ? void 0 : _d.length) !== null && _e !== void 0 ? _e : 0) > 0,
+            });
+        });
+    }
+    // ── Private: Validation Schema Building ─────────────
+    _buildValidationSchema(action) {
+        if (!this._commonSchema && !action.schema)
+            return null;
+        if (this._commonSchema && action.schema) {
+            return this._commonSchema.merge(action.schema).strip();
+        }
+        if (this._commonSchema) {
+            return this._commonSchema.strip();
+        }
+        if (action.schema) {
+            return action.schema.strip();
+        }
+        // Unreachable: all combinations covered above
+        /* istanbul ignore next */
+        return null;
+    }
+    // ── Private: Guards ─────────────────────────────────
+    _assertNotFrozen() {
+        if (this._frozen) {
+            throw new Error(`Builder "${this._name}" is frozen after buildToolDefinition(). ` +
+                `Cannot modify a built tool.`);
+        }
+    }
+}
+//# sourceMappingURL=GroupedToolBuilder.js.map

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

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

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

@@ -0,0 +1,43 @@
+/**
+ * Response Helpers
+ *
+ * Universal MCP response builders. No API coupling.
+ * These produce the standard MCP ToolResponse format.
+ */
+import { type EncodeOptions } from '@toon-format/toon';
+/** Standard MCP tool response */
+export interface ToolResponse {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/** Create a success response from text or a JSON-serializable object */
+export declare function success(data: string | object): ToolResponse;
+/** Create an error response */
+export declare function error(message: string): ToolResponse;
+/** Create a validation error for a missing required field */
+export declare function required(field: string): ToolResponse;
+/**
+ * Create a success response with TOON-encoded payload.
+ *
+ * Encodes structured data using TOON (Token-Oriented Object Notation)
+ * for ~40-50% token reduction compared to JSON.stringify().
+ * Ideal for list/tabular responses (arrays of uniform objects).
+ *
+ * @param data - Any JSON-serializable value (objects, arrays, primitives)
+ * @param options - Optional TOON encode options (defaults: pipe delimiter)
+ *
+ * @example
+ * ```typescript
+ * // In a handler:
+ * const users = await db.listUsers();
+ * return toonSuccess(users);
+ *
+ * // With custom options:
+ * return toonSuccess(data, { delimiter: ',' });
+ * ```
+ */
+export declare function toonSuccess(data: unknown, options?: EncodeOptions): ToolResponse;
+//# sourceMappingURL=ResponseHelper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseHelper.d.ts","sourceRoot":"","sources":["../../../src/framework/ResponseHelper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAM/D,iCAAiC;AACjC,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAMD,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAG3D;AAED,+BAA+B;AAC/B,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAEnD;AAED,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAEpD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CAIhF"}

package/dist/src/framework/ResponseHelper.js

@@ -0,0 +1,49 @@
+/**
+ * Response Helpers
+ *
+ * Universal MCP response builders. No API coupling.
+ * These produce the standard MCP ToolResponse format.
+ */
+import { encode } from '@toon-format/toon';
+// ============================================================================
+// Response Builders
+// ============================================================================
+/** Create a success response from text or a JSON-serializable object */
+export function success(data) {
+    const text = typeof data === 'string' ? data : JSON.stringify(data, null, 2);
+    return { content: [{ type: "text", text }] };
+}
+/** Create an error response */
+export function error(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+/** Create a validation error for a missing required field */
+export function required(field) {
+    return { content: [{ type: "text", text: `Error: ${field} required` }], isError: true };
+}
+/**
+ * Create a success response with TOON-encoded payload.
+ *
+ * Encodes structured data using TOON (Token-Oriented Object Notation)
+ * for ~40-50% token reduction compared to JSON.stringify().
+ * Ideal for list/tabular responses (arrays of uniform objects).
+ *
+ * @param data - Any JSON-serializable value (objects, arrays, primitives)
+ * @param options - Optional TOON encode options (defaults: pipe delimiter)
+ *
+ * @example
+ * ```typescript
+ * // In a handler:
+ * const users = await db.listUsers();
+ * return toonSuccess(users);
+ *
+ * // With custom options:
+ * return toonSuccess(data, { delimiter: ',' });
+ * ```
+ */
+export function toonSuccess(data, options) {
+    const defaults = { delimiter: '|' };
+    const text = encode(data, { ...defaults, ...options });
+    return { content: [{ type: "text", text }] };
+}
+//# sourceMappingURL=ResponseHelper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseHelper.js","sourceRoot":"","sources":["../../../src/framework/ResponseHelper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,EAAsB,MAAM,mBAAmB,CAAC;AAY/D,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,wEAAwE;AACxE,MAAM,UAAU,OAAO,CAAC,IAAqB;IACzC,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7E,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACjD,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,KAAK,CAAC,OAAe;IACjC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACzE,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,QAAQ,CAAC,KAAa;IAClC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC5F,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,OAAuB;IAC9D,MAAM,QAAQ,GAAkB,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;IACnD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACjD,CAAC"}

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

@@ -0,0 +1,46 @@
+/**
+ * ToolBuilder — Interface for MCP Tool Builders
+ *
+ * Abstraction that allows ToolRegistry to accept any builder implementation,
+ * not just GroupedToolBuilder. This follows the Dependency Inversion Principle.
+ *
+ * @template TContext - The context type passed to handlers on each call.
+ */
+import type { Tool as McpTool } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolResponse } from './ResponseHelper.js';
+/** Metadata for a single action (used for enterprise observability / introspection) */
+export interface ActionMetadata {
+    /** Full action key (e.g. "admin.create" for grouped, "list" for flat) */
+    key: string;
+    /** Action name within its group */
+    actionName: string;
+    /** Group name (undefined for flat actions) */
+    groupName?: string;
+    /** Human-readable description */
+    description?: string;
+    /** Whether this action is destructive */
+    destructive: boolean;
+    /** Whether this action is idempotent */
+    idempotent: boolean;
+    /** Whether this action is read-only */
+    readOnly: boolean;
+    /** Required field names from the Zod schema */
+    requiredFields: string[];
+    /** Whether this action has group/action-level middleware */
+    hasMiddleware: boolean;
+}
+export interface ToolBuilder<TContext = void> {
+    /** Get the tool name (used as the registration key) */
+    getName(): string;
+    /** Get the capability tags for selective exposure */
+    getTags(): string[];
+    /** Get all registered action keys */
+    getActionNames(): string[];
+    /** Get metadata for all registered actions (for enterprise observability) */
+    getActionMetadata(): ActionMetadata[];
+    /** Build and return the MCP Tool definition. May cache internally. */
+    buildToolDefinition(): McpTool;
+    /** Execute a tool call with the given context and arguments */
+    execute(ctx: TContext, args: Record<string, unknown>): Promise<ToolResponse>;
+}
+//# sourceMappingURL=ToolBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ToolBuilder.d.ts","sourceRoot":"","sources":["../../../src/framework/ToolBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC3B,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,wCAAwC;IACxC,UAAU,EAAE,OAAO,CAAC;IACpB,uCAAuC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,aAAa,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW,CAAC,QAAQ,GAAG,IAAI;IACxC,uDAAuD;IACvD,OAAO,IAAI,MAAM,CAAC;IAElB,qDAAqD;IACrD,OAAO,IAAI,MAAM,EAAE,CAAC;IAEpB,qCAAqC;IACrC,cAAc,IAAI,MAAM,EAAE,CAAC;IAE3B,6EAA6E;IAC7E,iBAAiB,IAAI,cAAc,EAAE,CAAC;IAEtC,sEAAsE;IACtE,mBAAmB,IAAI,OAAO,CAAC;IAE/B,+DAA+D;IAC/D,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAChF"}

package/dist/src/framework/ToolBuilder.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ToolBuilder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ToolBuilder.js","sourceRoot":"","sources":["../../../src/framework/ToolBuilder.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,85 @@
+/**
+ * ToolRegistry — Centralized Tool Registration & Routing
+ *
+ * Supports selective exposure via tags for reducing LLM context.
+ * Provides `attachToServer()` for 1-line MCP SDK integration.
+ */
+import type { Tool as McpTool } from '@modelcontextprotocol/sdk/types.js';
+import { type ToolResponse } from './ResponseHelper.js';
+import type { ToolBuilder } from './ToolBuilder.js';
+/** Filter options for getTools() */
+export interface ToolFilter {
+    /** Only include tools that have ALL these tags */
+    tags?: string[];
+    /** Exclude tools that have ANY of these tags */
+    exclude?: string[];
+}
+/**
+ * Options for attaching a ToolRegistry to an MCP Server.
+ *
+ * @template TContext - The context type used by the registry.
+ */
+export interface AttachOptions<TContext> {
+    /** Only expose tools matching these tag filters */
+    filter?: ToolFilter;
+    /**
+     * Factory function to create a per-request context.
+     * Receives the MCP `extra` object (session info, meta, etc.).
+     * If omitted, `undefined` is used as context (suitable for `ToolRegistry<void>`).
+     */
+    contextFactory?: (extra: unknown) => TContext;
+}
+/** Function to detach the registry from the server */
+export type DetachFn = () => void;
+export declare class ToolRegistry<TContext = void> {
+    private _builders;
+    /** Register a tool builder. Throws on duplicate name. */
+    register(builder: ToolBuilder<TContext>): void;
+    /** Register multiple builders at once */
+    registerAll(...builders: ToolBuilder<TContext>[]): void;
+    /** Get all tool definitions */
+    getAllTools(): McpTool[];
+    /** Get tool definitions filtered by tags */
+    getTools(filter: ToolFilter): McpTool[];
+    /** Route a call to the correct builder */
+    routeCall(ctx: TContext, name: string, args: Record<string, unknown>): Promise<ToolResponse>;
+    /**
+     * 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: unknown, options?: AttachOptions<TContext>): DetachFn;
+    /** Check if a tool is registered */
+    has(name: string): boolean;
+    /** Remove all registered tools */
+    clear(): void;
+    /** Get count of registered tools */
+    get size(): number;
+    /**
+     * 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
+     */
+    private _resolveServer;
+}
+//# sourceMappingURL=ToolRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRegistry.d.ts","sourceRoot":"","sources":["../../../src/framework/ToolRegistry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAK1E,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMpD,oCAAoC;AACpC,MAAM,WAAW,UAAU;IACvB,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAWD;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,QAAQ;IACnC,mDAAmD;IACnD,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,QAAQ,CAAC;CACjD;AAED,sDAAsD;AACtD,MAAM,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC;AAMlC,qBAAa,YAAY,CAAC,QAAQ,GAAG,IAAI;IACrC,OAAO,CAAC,SAAS,CAA4C;IAE7D,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,IAAI;IAU9C,yCAAyC;IACzC,WAAW,CAAC,GAAG,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,GAAG,IAAI;IAMvD,+BAA+B;IAC/B,WAAW,IAAI,OAAO,EAAE;IAKxB,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,EAAE;IAwBvC,0CAA0C;IACpC,SAAS,CACX,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,YAAY,CAAC;IAWxB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,cAAc,CACV,MAAM,EAAE,OAAO,EACf,OAAO,GAAE,aAAa,CAAC,QAAQ,CAAM,GACtC,QAAQ;IAqCX,oCAAoC;IACpC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,kCAAkC;IAClC,KAAK,IAAI,IAAI;IAIb,oCAAoC;IACpC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAID;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;CA4BzB"}