@frontmcp/sdk 0.6.0 → 0.6.2

package/src/completion/flows/complete.flow.js

@@ -1,199 +0,0 @@
-"use strict";
-// file: libs/sdk/src/completion/flows/complete.flow.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-const common_1 = require("../../common");
-const zod_1 = require("zod");
-const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
-const errors_1 = require("../../errors");
-const ui_1 = require("../../tool/ui");
-const inputSchema = zod_1.z.object({
-    request: types_js_1.CompleteRequestSchema,
-    ctx: zod_1.z.unknown(),
-});
-const outputSchema = types_js_1.CompleteResultSchema;
-/**
- * Reference types for completion requests
- */
-const PromptRefSchema = zod_1.z.object({
-    type: zod_1.z.literal('ref/prompt'),
-    name: zod_1.z.string(),
-});
-const ResourceRefSchema = zod_1.z.object({
-    type: zod_1.z.literal('ref/resource'),
-    uri: zod_1.z.string(),
-});
-const stateSchema = zod_1.z.object({
-    ref: zod_1.z.discriminatedUnion('type', [PromptRefSchema, ResourceRefSchema]),
-    argument: zod_1.z.object({
-        name: zod_1.z.string(),
-        value: zod_1.z.string(),
-    }),
-    output: outputSchema,
-});
-const plan = {
-    pre: ['parseInput'],
-    execute: ['complete'],
-    finalize: ['finalize'],
-};
-const name = 'completion:complete';
-const { Stage } = (0, common_1.FlowHooksOf)(name);
-let CompleteFlow = class CompleteFlow extends common_1.FlowBase {
-    logger = this.scopeLogger.child('CompleteFlow');
-    async parseInput() {
-        this.logger.verbose('parseInput:start');
-        let method;
-        let params;
-        try {
-            const inputData = inputSchema.parse(this.rawInput);
-            method = inputData.request.method;
-            params = inputData.request.params;
-        }
-        catch (e) {
-            throw new errors_1.InvalidInputError('Invalid Input', e instanceof zod_1.z.ZodError ? e.issues : undefined);
-        }
-        if (method !== 'completion/complete') {
-            this.logger.warn(`parseInput: invalid method "${method}"`);
-            throw new errors_1.InvalidMethodError(method, 'completion/complete');
-        }
-        const { ref, argument } = params;
-        // Validate ref structure
-        if (!ref || !ref.type) {
-            throw new errors_1.InvalidInputError('Reference (ref) is required with type field');
-        }
-        if (ref.type !== 'ref/prompt' && ref.type !== 'ref/resource') {
-            // Cast needed because TypeScript exhaustively checks ref.type, making it 'never' in this branch
-            throw new errors_1.InvalidInputError(`Invalid reference type: ${ref.type}. Expected "ref/prompt" or "ref/resource"`);
-        }
-        // Validate argument structure
-        if (!argument || typeof argument.name !== 'string' || typeof argument.value !== 'string') {
-            throw new errors_1.InvalidInputError('Argument must have "name" and "value" string fields');
-        }
-        this.state.set({ ref, argument });
-        this.logger.verbose('parseInput:done');
-    }
-    async complete() {
-        this.logger.verbose('complete:start');
-        const { ref, argument } = this.state.required;
-        let values = [];
-        let total;
-        let hasMore;
-        if (ref.type === 'ref/prompt') {
-            // Get completion suggestions for a prompt argument
-            const { name: promptName } = ref;
-            const { name: argName, value: argValue } = argument;
-            this.logger.debug(`complete: prompt completion for "${promptName}" argument "${argName}" with value "${argValue}"`);
-            // Look up the prompt in the registry
-            const prompt = this.scope.prompts.findByName(promptName);
-            if (prompt) {
-                // Check if the prompt instance has a completer for this argument
-                // Completion support is optional - prompts can implement getArgumentCompleter to provide suggestions
-                const instance = prompt; // PromptInstance may have completer method
-                if (typeof instance.getArgumentCompleter === 'function') {
-                    const completer = instance.getArgumentCompleter(argName);
-                    if (completer) {
-                        try {
-                            const result = await completer(argValue);
-                            values = result.values || [];
-                            total = result.total;
-                            hasMore = result.hasMore;
-                        }
-                        catch (e) {
-                            this.logger.warn(`complete: completer failed for prompt "${promptName}" argument "${argName}": ${e}`);
-                        }
-                    }
-                }
-            }
-            else {
-                this.logger.debug(`complete: prompt "${promptName}" not found`);
-            }
-        }
-        else if (ref.type === 'ref/resource') {
-            // Get completion suggestions for a resource template URI
-            const { uri } = ref;
-            const { name: argName, value: argValue } = argument;
-            this.logger.debug(`complete: resource completion for URI "${uri}" argument "${argName}" with value "${argValue}"`);
-            // Special handling for ui:// widget URIs - complete with tool names that have UI config
-            if (uri.startsWith('ui://widget/') && argName === 'toolName') {
-                const toolsWithUI = this.scope.tools.getTools().filter((t) => (0, ui_1.hasUIConfig)(t.metadata));
-                const toolNames = toolsWithUI.map((t) => t.metadata.id ?? t.metadata.name);
-                // Filter by prefix if value is provided
-                const prefix = argValue.toLowerCase();
-                values = toolNames.filter((name) => name.toLowerCase().startsWith(prefix));
-                total = values.length;
-                this.logger.debug(`complete: found ${values.length} tools with UI config matching "${argValue}"`);
-            }
-            else {
-                // Look up the resource template in the registry by URI
-                const resourceMatch = this.scope.resources.findResourceForUri(uri);
-                if (resourceMatch) {
-                    // Check if the resource instance has a completer for this argument
-                    // Completion support is optional - resources can implement getArgumentCompleter to provide suggestions
-                    const instance = resourceMatch.instance; // ResourceInstance may have completer method
-                    if (typeof instance.getArgumentCompleter === 'function') {
-                        const completer = instance.getArgumentCompleter(argName);
-                        if (completer) {
-                            try {
-                                const result = await completer(argValue);
-                                values = result.values || [];
-                                total = result.total;
-                                hasMore = result.hasMore;
-                            }
-                            catch (e) {
-                                this.logger.warn(`complete: completer failed for resource "${uri}" argument "${argName}": ${e}`);
-                            }
-                        }
-                    }
-                }
-                else {
-                    this.logger.debug(`complete: resource "${uri}" not found`);
-                }
-            }
-        }
-        // Build the completion result
-        const completion = { values };
-        if (total !== undefined) {
-            completion.total = total;
-        }
-        if (hasMore !== undefined) {
-            completion.hasMore = hasMore;
-        }
-        this.state.set({ output: { completion } });
-        this.logger.verbose('complete:done');
-    }
-    async finalize() {
-        this.logger.verbose('finalize:start');
-        const { output } = this.state.required;
-        this.respond(output);
-        this.logger.verbose('finalize:done');
-    }
-};
-tslib_1.__decorate([
-    Stage('parseInput'),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", []),
-    tslib_1.__metadata("design:returntype", Promise)
-], CompleteFlow.prototype, "parseInput", null);
-tslib_1.__decorate([
-    Stage('complete'),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", []),
-    tslib_1.__metadata("design:returntype", Promise)
-], CompleteFlow.prototype, "complete", null);
-tslib_1.__decorate([
-    Stage('finalize'),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", []),
-    tslib_1.__metadata("design:returntype", Promise)
-], CompleteFlow.prototype, "finalize", null);
-CompleteFlow = tslib_1.__decorate([
-    (0, common_1.Flow)({
-        name,
-        plan,
-        inputSchema,
-        outputSchema,
-        access: 'authorized',
-    })
-], CompleteFlow);
-exports.default = CompleteFlow;
-//# sourceMappingURL=complete.flow.js.map

package/src/completion/flows/complete.flow.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"complete.flow.js","sourceRoot":"","sources":["../../../../src/completion/flows/complete.flow.ts"],"names":[],"mappings":";AAAA,uDAAuD;;;AAEvD,yCAAqF;AACrF,6BAAwB;AACxB,iEAAiG;AACjG,yCAAqE;AACrE,sCAA4C;AAE5C,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,OAAO,EAAE,gCAAqB;IAC9B,GAAG,EAAE,OAAC,CAAC,OAAO,EAAE;CACjB,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,+BAAoB,CAAC;AAE1C;;GAEG;AACH,MAAM,eAAe,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IAC7B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IAC/B,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;CAChB,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,GAAG,EAAE,OAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;IACvE,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;QAChB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;KAClB,CAAC;IACF,MAAM,EAAE,YAAY;CACrB,CAAC,CAAC;AAEH,MAAM,IAAI,GAAG;IACX,GAAG,EAAE,CAAC,YAAY,CAAC;IACnB,OAAO,EAAE,CAAC,UAAU,CAAC;IACrB,QAAQ,EAAE,CAAC,UAAU,CAAC;CACa,CAAC;AActC,MAAM,IAAI,GAAG,qBAA8B,CAAC;AAC5C,MAAM,EAAE,KAAK,EAAE,GAAG,IAAA,oBAAW,EAAwB,IAAI,CAAC,CAAC;AAS5C,IAAM,YAAY,GAAlB,MAAM,YAAa,SAAQ,iBAAqB;IAC7D,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAG1C,AAAN,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAExC,IAAI,MAAe,CAAC;QACpB,IAAI,MAAuD,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnD,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC;YAClC,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC;QACpC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,0BAAiB,CAAC,eAAe,EAAE,CAAC,YAAY,OAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC/F,CAAC;QAED,IAAI,MAAM,KAAK,qBAAqB,EAAE,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,MAAM,GAAG,CAAC,CAAC;YAC3D,MAAM,IAAI,2BAAkB,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAEjC,yBAAyB;QACzB,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACtB,MAAM,IAAI,0BAAiB,CAAC,6CAA6C,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAC7D,gGAAgG;YAChG,MAAM,IAAI,0BAAiB,CACzB,2BAA4B,GAAwB,CAAC,IAAI,2CAA2C,CACrG,CAAC;QACJ,CAAC;QAED,8BAA8B;QAC9B,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACzF,MAAM,IAAI,0BAAiB,CAAC,qDAAqD,CAAC,CAAC;QACrF,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzC,CAAC;IAGK,AAAN,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACtC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QAE9C,IAAI,MAAM,GAAa,EAAE,CAAC;QAC1B,IAAI,KAAyB,CAAC;QAC9B,IAAI,OAA4B,CAAC;QAEjC,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC9B,mDAAmD;YACnD,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC;YACjC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;YAEpD,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,oCAAoC,UAAU,eAAe,OAAO,iBAAiB,QAAQ,GAAG,CACjG,CAAC;YAEF,qCAAqC;YACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YAEzD,IAAI,MAAM,EAAE,CAAC;gBACX,iEAAiE;gBACjE,qGAAqG;gBACrG,MAAM,QAAQ,GAAG,MAAa,CAAC,CAAC,2CAA2C;gBAC3E,IAAI,OAAO,QAAQ,CAAC,oBAAoB,KAAK,UAAU,EAAE,CAAC;oBACxD,MAAM,SAAS,GAAG,QAAQ,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;oBACzD,IAAI,SAAS,EAAE,CAAC;wBACd,IAAI,CAAC;4BACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;4BACzC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;4BAC7B,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;4BACrB,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;wBAC3B,CAAC;wBAAC,OAAO,CAAC,EAAE,CAAC;4BACX,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0CAA0C,UAAU,eAAe,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC;wBACxG,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,UAAU,aAAa,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACvC,yDAAyD;YACzD,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;YACpB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;YAEpD,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,0CAA0C,GAAG,eAAe,OAAO,iBAAiB,QAAQ,GAAG,CAChG,CAAC;YAEF,wFAAwF;YACxF,IAAI,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,gBAAW,EAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACvF,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAE3E,wCAAwC;gBACxC,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;gBACtC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC3E,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;gBAEtB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,MAAM,CAAC,MAAM,mCAAmC,QAAQ,GAAG,CAAC,CAAC;YACpG,CAAC;iBAAM,CAAC;gBACN,uDAAuD;gBACvD,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;gBAEnE,IAAI,aAAa,EAAE,CAAC;oBAClB,mEAAmE;oBACnE,uGAAuG;oBACvG,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAe,CAAC,CAAC,6CAA6C;oBAC7F,IAAI,OAAO,QAAQ,CAAC,oBAAoB,KAAK,UAAU,EAAE,CAAC;wBACxD,MAAM,SAAS,GAAG,QAAQ,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;wBACzD,IAAI,SAAS,EAAE,CAAC;4BACd,IAAI,CAAC;gCACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;gCACzC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;gCAC7B,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;gCACrB,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;4BAC3B,CAAC;4BAAC,OAAO,CAAC,EAAE,CAAC;gCACX,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4CAA4C,GAAG,eAAe,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC;4BACnG,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,GAAG,aAAa,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;QACH,CAAC;QAED,8BAA8B;QAC9B,MAAM,UAAU,GAA4D,EAAE,MAAM,EAAE,CAAC;QACvF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,UAAU,CAAC,KAAK,GAAG,KAAK,CAAC;QAC3B,CAAC;QACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;QAC/B,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACvC,CAAC;IAGK,AAAN,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACtC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACvC,CAAC;CACF,CAAA;AArJO;IADL,KAAK,CAAC,YAAY,CAAC;;;;8CAwCnB;AAGK;IADL,KAAK,CAAC,UAAU,CAAC;;;;4CAmGjB;AAGK;IADL,KAAK,CAAC,UAAU,CAAC;;;;4CAMjB;AAxJkB,YAAY;IAPhC,IAAA,aAAI,EAAC;QACJ,IAAI;QACJ,IAAI;QACJ,WAAW;QACX,YAAY;QACZ,MAAM,EAAE,YAAY;KACrB,CAAC;GACmB,YAAY,CAyJhC;kBAzJoB,YAAY","sourcesContent":["// file: libs/sdk/src/completion/flows/complete.flow.ts\n\nimport { Flow, FlowBase, FlowHooksOf, FlowPlan, FlowRunOptions } from '../../common';\nimport { z } from 'zod';\nimport { CompleteRequestSchema, CompleteResultSchema } from '@modelcontextprotocol/sdk/types.js';\nimport { InvalidMethodError, InvalidInputError } from '../../errors';\nimport { hasUIConfig } from '../../tool/ui';\n\nconst inputSchema = z.object({\n  request: CompleteRequestSchema,\n  ctx: z.unknown(),\n});\n\nconst outputSchema = CompleteResultSchema;\n\n/**\n * Reference types for completion requests\n */\nconst PromptRefSchema = z.object({\n  type: z.literal('ref/prompt'),\n  name: z.string(),\n});\n\nconst ResourceRefSchema = z.object({\n  type: z.literal('ref/resource'),\n  uri: z.string(),\n});\n\nconst stateSchema = z.object({\n  ref: z.discriminatedUnion('type', [PromptRefSchema, ResourceRefSchema]),\n  argument: z.object({\n    name: z.string(),\n    value: z.string(),\n  }),\n  output: outputSchema,\n});\n\nconst plan = {\n  pre: ['parseInput'],\n  execute: ['complete'],\n  finalize: ['finalize'],\n} as const satisfies FlowPlan<string>;\n\ndeclare global {\n  interface ExtendFlows {\n    'completion:complete': FlowRunOptions<\n      CompleteFlow,\n      typeof plan,\n      typeof inputSchema,\n      typeof outputSchema,\n      typeof stateSchema\n    >;\n  }\n}\n\nconst name = 'completion:complete' as const;\nconst { Stage } = FlowHooksOf<'completion:complete'>(name);\n\n@Flow({\n  name,\n  plan,\n  inputSchema,\n  outputSchema,\n  access: 'authorized',\n})\nexport default class CompleteFlow extends FlowBase<typeof name> {\n  logger = this.scopeLogger.child('CompleteFlow');\n\n  @Stage('parseInput')\n  async parseInput() {\n    this.logger.verbose('parseInput:start');\n\n    let method!: string;\n    let params: z.infer<typeof CompleteRequestSchema>['params'];\n    try {\n      const inputData = inputSchema.parse(this.rawInput);\n      method = inputData.request.method;\n      params = inputData.request.params;\n    } catch (e) {\n      throw new InvalidInputError('Invalid Input', e instanceof z.ZodError ? e.issues : undefined);\n    }\n\n    if (method !== 'completion/complete') {\n      this.logger.warn(`parseInput: invalid method \"${method}\"`);\n      throw new InvalidMethodError(method, 'completion/complete');\n    }\n\n    const { ref, argument } = params;\n\n    // Validate ref structure\n    if (!ref || !ref.type) {\n      throw new InvalidInputError('Reference (ref) is required with type field');\n    }\n\n    if (ref.type !== 'ref/prompt' && ref.type !== 'ref/resource') {\n      // Cast needed because TypeScript exhaustively checks ref.type, making it 'never' in this branch\n      throw new InvalidInputError(\n        `Invalid reference type: ${(ref as { type: string }).type}. Expected \"ref/prompt\" or \"ref/resource\"`,\n      );\n    }\n\n    // Validate argument structure\n    if (!argument || typeof argument.name !== 'string' || typeof argument.value !== 'string') {\n      throw new InvalidInputError('Argument must have \"name\" and \"value\" string fields');\n    }\n\n    this.state.set({ ref, argument });\n    this.logger.verbose('parseInput:done');\n  }\n\n  @Stage('complete')\n  async complete() {\n    this.logger.verbose('complete:start');\n    const { ref, argument } = this.state.required;\n\n    let values: string[] = [];\n    let total: number | undefined;\n    let hasMore: boolean | undefined;\n\n    if (ref.type === 'ref/prompt') {\n      // Get completion suggestions for a prompt argument\n      const { name: promptName } = ref;\n      const { name: argName, value: argValue } = argument;\n\n      this.logger.debug(\n        `complete: prompt completion for \"${promptName}\" argument \"${argName}\" with value \"${argValue}\"`,\n      );\n\n      // Look up the prompt in the registry\n      const prompt = this.scope.prompts.findByName(promptName);\n\n      if (prompt) {\n        // Check if the prompt instance has a completer for this argument\n        // Completion support is optional - prompts can implement getArgumentCompleter to provide suggestions\n        const instance = prompt as any; // PromptInstance may have completer method\n        if (typeof instance.getArgumentCompleter === 'function') {\n          const completer = instance.getArgumentCompleter(argName);\n          if (completer) {\n            try {\n              const result = await completer(argValue);\n              values = result.values || [];\n              total = result.total;\n              hasMore = result.hasMore;\n            } catch (e) {\n              this.logger.warn(`complete: completer failed for prompt \"${promptName}\" argument \"${argName}\": ${e}`);\n            }\n          }\n        }\n      } else {\n        this.logger.debug(`complete: prompt \"${promptName}\" not found`);\n      }\n    } else if (ref.type === 'ref/resource') {\n      // Get completion suggestions for a resource template URI\n      const { uri } = ref;\n      const { name: argName, value: argValue } = argument;\n\n      this.logger.debug(\n        `complete: resource completion for URI \"${uri}\" argument \"${argName}\" with value \"${argValue}\"`,\n      );\n\n      // Special handling for ui:// widget URIs - complete with tool names that have UI config\n      if (uri.startsWith('ui://widget/') && argName === 'toolName') {\n        const toolsWithUI = this.scope.tools.getTools().filter((t) => hasUIConfig(t.metadata));\n        const toolNames = toolsWithUI.map((t) => t.metadata.id ?? t.metadata.name);\n\n        // Filter by prefix if value is provided\n        const prefix = argValue.toLowerCase();\n        values = toolNames.filter((name) => name.toLowerCase().startsWith(prefix));\n        total = values.length;\n\n        this.logger.debug(`complete: found ${values.length} tools with UI config matching \"${argValue}\"`);\n      } else {\n        // Look up the resource template in the registry by URI\n        const resourceMatch = this.scope.resources.findResourceForUri(uri);\n\n        if (resourceMatch) {\n          // Check if the resource instance has a completer for this argument\n          // Completion support is optional - resources can implement getArgumentCompleter to provide suggestions\n          const instance = resourceMatch.instance as any; // ResourceInstance may have completer method\n          if (typeof instance.getArgumentCompleter === 'function') {\n            const completer = instance.getArgumentCompleter(argName);\n            if (completer) {\n              try {\n                const result = await completer(argValue);\n                values = result.values || [];\n                total = result.total;\n                hasMore = result.hasMore;\n              } catch (e) {\n                this.logger.warn(`complete: completer failed for resource \"${uri}\" argument \"${argName}\": ${e}`);\n              }\n            }\n          }\n        } else {\n          this.logger.debug(`complete: resource \"${uri}\" not found`);\n        }\n      }\n    }\n\n    // Build the completion result\n    const completion: { values: string[]; total?: number; hasMore?: boolean } = { values };\n    if (total !== undefined) {\n      completion.total = total;\n    }\n    if (hasMore !== undefined) {\n      completion.hasMore = hasMore;\n    }\n\n    this.state.set({ output: { completion } });\n    this.logger.verbose('complete:done');\n  }\n\n  @Stage('finalize')\n  async finalize() {\n    this.logger.verbose('finalize:start');\n    const { output } = this.state.required;\n    this.respond(output);\n    this.logger.verbose('finalize:done');\n  }\n}\n"]}

package/src/context/frontmcp-context-storage.js

@@ -1,183 +0,0 @@
-"use strict";
-/**
- * FrontMcpContextStorage - AsyncLocalStorage wrapper for unified context
- *
- * Provides concurrent-safe context propagation using Node.js AsyncLocalStorage.
- * Access through DI only - never use static imports to access the storage directly.
- *
- * @example
- * ```typescript
- * // In a flow or middleware
- * const storage = this.get(FrontMcpContextStorage);
- * await storage.runFromHeaders(request.headers, {
- *   sessionId: sessionId,
- *   scopeId: scope.id,
- * }, async () => {
- *   // All code here can access the context via DI
- *   const ctx = this.get(FRONTMCP_CONTEXT);
- * });
- * ```
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ContextStorage = exports.FrontMcpContextStorage = void 0;
-const tslib_1 = require("tslib");
-const node_async_hooks_1 = require("node:async_hooks");
-const decorators_1 = require("../common/decorators");
-const metadata_1 = require("../common/metadata");
-const frontmcp_context_1 = require("./frontmcp-context");
-const trace_context_1 = require("./trace-context");
-const mcp_error_1 = require("../errors/mcp.error");
-/**
- * Module-level AsyncLocalStorage instance.
- *
- * This is the ONLY place where the storage is created.
- * Access should be through DI, not through static imports.
- */
-const frontmcpContextStorage = new node_async_hooks_1.AsyncLocalStorage();
-/**
- * FrontMcpContextStorage provides unified context via AsyncLocalStorage.
- *
- * This is a GLOBAL-scoped provider because it manages the storage itself,
- * not the per-context data. The actual FrontMcpContext is accessed via
- * the FRONTMCP_CONTEXT token which is CONTEXT-scoped.
- */
-let FrontMcpContextStorage = class FrontMcpContextStorage {
-    /**
-     * Run a callback with a new FrontMcpContext.
-     *
-     * @param args - Arguments to create the context
-     * @param fn - Async function to run with the context
-     * @returns Result of the callback
-     */
-    run(args, fn) {
-        const context = new frontmcp_context_1.FrontMcpContext(args);
-        return frontmcpContextStorage.run(context, fn);
-    }
-    /**
-     * Run with context extracted from HTTP headers.
-     *
-     * Automatically parses trace context from headers using W3C Trace Context
-     * specification with fallback to x-frontmcp-trace-id.
-     *
-     * @param headers - HTTP headers
-     * @param args - Additional context args (sessionId, scopeId)
-     * @param fn - Async function to run
-     * @returns Result of the callback
-     */
-    runFromHeaders(headers, args, fn) {
-        const traceContext = (0, trace_context_1.parseTraceContext)(headers);
-        const metadata = extractMetadata(headers);
-        const context = new frontmcp_context_1.FrontMcpContext({
-            ...args,
-            traceContext,
-            metadata,
-        });
-        return frontmcpContextStorage.run(context, fn);
-    }
-    /**
-     * Run with an existing FrontMcpContext.
-     *
-     * Useful when you need to propagate an existing context to a new async scope.
-     *
-     * @param context - Existing FrontMcpContext
-     * @param fn - Async function to run
-     * @returns Result of the callback
-     */
-    runWithContext(context, fn) {
-        return frontmcpContextStorage.run(context, fn);
-    }
-    /**
-     * Get the current FrontMcpContext.
-     *
-     * @returns Current context or undefined if not in a context scope
-     */
-    getStore() {
-        return frontmcpContextStorage.getStore();
-    }
-    /**
-     * Get the current FrontMcpContext, throwing if not available.
-     *
-     * @throws Error if not in a context scope
-     */
-    getStoreOrThrow() {
-        const ctx = this.getStore();
-        if (!ctx) {
-            throw new mcp_error_1.RequestContextNotAvailableError('FrontMcpContext not available. Ensure operation runs within context scope.');
-        }
-        return ctx;
-    }
-    /**
-     * Check if currently running within a context.
-     *
-     * @returns True if a FrontMcpContext is available
-     */
-    hasContext() {
-        return frontmcpContextStorage.getStore() !== undefined;
-    }
-    /**
-     * Update the authInfo in the current context.
-     *
-     * This mutates the existing context in place to preserve internal state
-     * (marks, store, sessionMetadata) while updating auth info.
-     *
-     * @param authInfo - Auth info fields to set/update (merged with existing)
-     * @param fn - Function to run after update
-     * @returns Result of the callback
-     */
-    updateAuthInfo(authInfo, fn) {
-        const current = this.getStoreOrThrow();
-        current.updateAuthInfo(authInfo);
-        return fn();
-    }
-};
-exports.FrontMcpContextStorage = FrontMcpContextStorage;
-exports.ContextStorage = FrontMcpContextStorage;
-exports.ContextStorage = exports.FrontMcpContextStorage = FrontMcpContextStorage = tslib_1.__decorate([
-    (0, decorators_1.Provider)({
-        name: 'FrontMcpContextStorage',
-        description: 'Manages unified context via AsyncLocalStorage',
-        scope: metadata_1.ProviderScope.GLOBAL,
-    })
-], FrontMcpContextStorage);
-/**
- * Extract request metadata from headers.
- */
-function extractMetadata(headers) {
-    const customHeaders = {};
-    for (const [key, value] of Object.entries(headers)) {
-        if (key.toLowerCase().startsWith('x-frontmcp-') && typeof value === 'string') {
-            customHeaders[key.toLowerCase()] = value;
-        }
-    }
-    return {
-        userAgent: typeof headers['user-agent'] === 'string' ? headers['user-agent'] : undefined,
-        contentType: typeof headers['content-type'] === 'string' ? headers['content-type'] : undefined,
-        accept: typeof headers['accept'] === 'string' ? headers['accept'] : undefined,
-        clientIp: extractClientIp(headers),
-        customHeaders,
-    };
-}
-/**
- * Extract client IP from headers.
- * Handles both string and array header values (some adapters pass arrays).
- */
-function extractClientIp(headers) {
-    // x-forwarded-for can be comma-separated list; first is client IP
-    const xff = headers['x-forwarded-for'];
-    if (typeof xff === 'string') {
-        return xff.split(',')[0]?.trim();
-    }
-    // Some adapters pass arrays for multi-value headers
-    if (Array.isArray(xff) && typeof xff[0] === 'string') {
-        return xff[0].split(',')[0]?.trim();
-    }
-    const realIp = headers['x-real-ip'];
-    if (typeof realIp === 'string') {
-        return realIp;
-    }
-    if (Array.isArray(realIp) && typeof realIp[0] === 'string') {
-        return realIp[0];
-    }
-    return undefined;
-}
-//# sourceMappingURL=frontmcp-context-storage.js.map

package/src/context/frontmcp-context-storage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"frontmcp-context-storage.js","sourceRoot":"","sources":["../../../src/context/frontmcp-context-storage.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * FrontMcpContextStorage - AsyncLocalStorage wrapper for unified context\n *\n * Provides concurrent-safe context propagation using Node.js AsyncLocalStorage.\n * Access through DI only - never use static imports to access the storage directly.\n *\n * @example\n * ```typescript\n * // In a flow or middleware\n * const storage = this.get(FrontMcpContextStorage);\n * await storage.runFromHeaders(request.headers, {\n *   sessionId: sessionId,\n *   scopeId: scope.id,\n * }, async () => {\n *   // All code here can access the context via DI\n *   const ctx = this.get(FRONTMCP_CONTEXT);\n * });\n * ```\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport { Provider } from '../common/decorators';\nimport { ProviderScope } from '../common/metadata';\nimport { FrontMcpContext, FrontMcpContextArgs, RequestMetadata } from './frontmcp-context';\nimport { parseTraceContext } from './trace-context';\nimport { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';\nimport { RequestContextNotAvailableError } from '../errors/mcp.error';\n\n/**\n * Module-level AsyncLocalStorage instance.\n *\n * This is the ONLY place where the storage is created.\n * Access should be through DI, not through static imports.\n */\nconst frontmcpContextStorage = new AsyncLocalStorage<FrontMcpContext>();\n\n/**\n * FrontMcpContextStorage provides unified context via AsyncLocalStorage.\n *\n * This is a GLOBAL-scoped provider because it manages the storage itself,\n * not the per-context data. The actual FrontMcpContext is accessed via\n * the FRONTMCP_CONTEXT token which is CONTEXT-scoped.\n */\n@Provider({\n  name: 'FrontMcpContextStorage',\n  description: 'Manages unified context via AsyncLocalStorage',\n  scope: ProviderScope.GLOBAL,\n})\nexport class FrontMcpContextStorage {\n  /**\n   * Run a callback with a new FrontMcpContext.\n   *\n   * @param args - Arguments to create the context\n   * @param fn - Async function to run with the context\n   * @returns Result of the callback\n   */\n  run<T>(args: FrontMcpContextArgs, fn: () => T | Promise<T>): T | Promise<T> {\n    const context = new FrontMcpContext(args);\n    return frontmcpContextStorage.run(context, fn);\n  }\n\n  /**\n   * Run with context extracted from HTTP headers.\n   *\n   * Automatically parses trace context from headers using W3C Trace Context\n   * specification with fallback to x-frontmcp-trace-id.\n   *\n   * @param headers - HTTP headers\n   * @param args - Additional context args (sessionId, scopeId)\n   * @param fn - Async function to run\n   * @returns Result of the callback\n   */\n  runFromHeaders<T>(\n    headers: Record<string, unknown>,\n    args: Omit<FrontMcpContextArgs, 'traceContext' | 'metadata'>,\n    fn: () => T | Promise<T>,\n  ): T | Promise<T> {\n    const traceContext = parseTraceContext(headers);\n    const metadata = extractMetadata(headers);\n    const context = new FrontMcpContext({\n      ...args,\n      traceContext,\n      metadata,\n    });\n    return frontmcpContextStorage.run(context, fn);\n  }\n\n  /**\n   * Run with an existing FrontMcpContext.\n   *\n   * Useful when you need to propagate an existing context to a new async scope.\n   *\n   * @param context - Existing FrontMcpContext\n   * @param fn - Async function to run\n   * @returns Result of the callback\n   */\n  runWithContext<T>(context: FrontMcpContext, fn: () => T | Promise<T>): T | Promise<T> {\n    return frontmcpContextStorage.run(context, fn);\n  }\n\n  /**\n   * Get the current FrontMcpContext.\n   *\n   * @returns Current context or undefined if not in a context scope\n   */\n  getStore(): FrontMcpContext | undefined {\n    return frontmcpContextStorage.getStore();\n  }\n\n  /**\n   * Get the current FrontMcpContext, throwing if not available.\n   *\n   * @throws Error if not in a context scope\n   */\n  getStoreOrThrow(): FrontMcpContext {\n    const ctx = this.getStore();\n    if (!ctx) {\n      throw new RequestContextNotAvailableError(\n        'FrontMcpContext not available. Ensure operation runs within context scope.',\n      );\n    }\n    return ctx;\n  }\n\n  /**\n   * Check if currently running within a context.\n   *\n   * @returns True if a FrontMcpContext is available\n   */\n  hasContext(): boolean {\n    return frontmcpContextStorage.getStore() !== undefined;\n  }\n\n  /**\n   * Update the authInfo in the current context.\n   *\n   * This mutates the existing context in place to preserve internal state\n   * (marks, store, sessionMetadata) while updating auth info.\n   *\n   * @param authInfo - Auth info fields to set/update (merged with existing)\n   * @param fn - Function to run after update\n   * @returns Result of the callback\n   */\n  updateAuthInfo<T>(authInfo: Partial<AuthInfo>, fn: () => T | Promise<T>): T | Promise<T> {\n    const current = this.getStoreOrThrow();\n    current.updateAuthInfo(authInfo);\n    return fn();\n  }\n}\n\n/**\n * Extract request metadata from headers.\n */\nfunction extractMetadata(headers: Record<string, unknown>): RequestMetadata {\n  const customHeaders: Record<string, string> = {};\n\n  for (const [key, value] of Object.entries(headers)) {\n    if (key.toLowerCase().startsWith('x-frontmcp-') && typeof value === 'string') {\n      customHeaders[key.toLowerCase()] = value;\n    }\n  }\n\n  return {\n    userAgent: typeof headers['user-agent'] === 'string' ? headers['user-agent'] : undefined,\n    contentType: typeof headers['content-type'] === 'string' ? headers['content-type'] : undefined,\n    accept: typeof headers['accept'] === 'string' ? headers['accept'] : undefined,\n    clientIp: extractClientIp(headers),\n    customHeaders,\n  };\n}\n\n/**\n * Extract client IP from headers.\n * Handles both string and array header values (some adapters pass arrays).\n */\nfunction extractClientIp(headers: Record<string, unknown>): string | undefined {\n  // x-forwarded-for can be comma-separated list; first is client IP\n  const xff = headers['x-forwarded-for'];\n  if (typeof xff === 'string') {\n    return xff.split(',')[0]?.trim();\n  }\n  // Some adapters pass arrays for multi-value headers\n  if (Array.isArray(xff) && typeof xff[0] === 'string') {\n    return xff[0].split(',')[0]?.trim();\n  }\n\n  const realIp = headers['x-real-ip'];\n  if (typeof realIp === 'string') {\n    return realIp;\n  }\n  if (Array.isArray(realIp) && typeof realIp[0] === 'string') {\n    return realIp[0];\n  }\n\n  return undefined;\n}\n\n/**\n * Alias for backward compatibility.\n * @deprecated Use FrontMcpContextStorage instead\n */\nexport { FrontMcpContextStorage as ContextStorage };\n"]}