@frontmcp/sdk 0.6.0 → 0.6.2

package/src/resource/resource.utils.js

@@ -1,151 +0,0 @@
-"use strict";
-// file: libs/sdk/src/resource/resource.utils.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildParsedResourceResult = exports.isUriTemplate = exports.extractTemplateParams = exports.expandUriTemplate = exports.matchUriTemplate = exports.parseUriTemplate = exports.qualifiedNameOf = exports.ownerKeyOf = exports.ensureMaxLen = exports.shortHash = exports.normalizeOwnerPath = exports.normalizeProviderId = exports.normalizeSegment = exports.sepFor = exports.toCase = exports.splitWords = void 0;
-exports.collectResourceMetadata = collectResourceMetadata;
-exports.collectResourceTemplateMetadata = collectResourceTemplateMetadata;
-exports.normalizeResource = normalizeResource;
-exports.normalizeResourceTemplate = normalizeResourceTemplate;
-exports.isResourceTemplate = isResourceTemplate;
-exports.resourceDiscoveryDeps = resourceDiscoveryDeps;
-const common_1 = require("../common");
-const token_utils_1 = require("../utils/token.utils");
-const metadata_utils_1 = require("../utils/metadata.utils");
-// Re-export shared naming utilities (ResourceNameCase is exported from resource.types.ts)
-var naming_utils_1 = require("../utils/naming.utils");
-Object.defineProperty(exports, "splitWords", { enumerable: true, get: function () { return naming_utils_1.splitWords; } });
-Object.defineProperty(exports, "toCase", { enumerable: true, get: function () { return naming_utils_1.toCase; } });
-Object.defineProperty(exports, "sepFor", { enumerable: true, get: function () { return naming_utils_1.sepFor; } });
-Object.defineProperty(exports, "normalizeSegment", { enumerable: true, get: function () { return naming_utils_1.normalizeSegment; } });
-Object.defineProperty(exports, "normalizeProviderId", { enumerable: true, get: function () { return naming_utils_1.normalizeProviderId; } });
-Object.defineProperty(exports, "normalizeOwnerPath", { enumerable: true, get: function () { return naming_utils_1.normalizeOwnerPath; } });
-Object.defineProperty(exports, "shortHash", { enumerable: true, get: function () { return naming_utils_1.shortHash; } });
-Object.defineProperty(exports, "ensureMaxLen", { enumerable: true, get: function () { return naming_utils_1.ensureMaxLen; } });
-// Re-export shared lineage utilities
-var lineage_utils_1 = require("../utils/lineage.utils");
-Object.defineProperty(exports, "ownerKeyOf", { enumerable: true, get: function () { return lineage_utils_1.ownerKeyOf; } });
-Object.defineProperty(exports, "qualifiedNameOf", { enumerable: true, get: function () { return lineage_utils_1.qualifiedNameOf; } });
-// Re-export URI template utilities
-var uri_template_utils_1 = require("../utils/uri-template.utils");
-Object.defineProperty(exports, "parseUriTemplate", { enumerable: true, get: function () { return uri_template_utils_1.parseUriTemplate; } });
-Object.defineProperty(exports, "matchUriTemplate", { enumerable: true, get: function () { return uri_template_utils_1.matchUriTemplate; } });
-Object.defineProperty(exports, "expandUriTemplate", { enumerable: true, get: function () { return uri_template_utils_1.expandUriTemplate; } });
-Object.defineProperty(exports, "extractTemplateParams", { enumerable: true, get: function () { return uri_template_utils_1.extractTemplateParams; } });
-Object.defineProperty(exports, "isUriTemplate", { enumerable: true, get: function () { return uri_template_utils_1.isUriTemplate; } });
-// Re-export content utilities
-var content_utils_1 = require("../utils/content.utils");
-Object.defineProperty(exports, "buildParsedResourceResult", { enumerable: true, get: function () { return content_utils_1.buildResourceContent; } });
-/**
- * Collect metadata from a class decorated with @FrontMcpResource
- */
-function collectResourceMetadata(cls) {
-    const extended = (0, metadata_utils_1.getMetadata)(common_1.extendedResourceMetadata, cls);
-    const seed = (extended ? { ...extended } : {});
-    return Object.entries(common_1.FrontMcpResourceTokens).reduce((metadata, [key, token]) => {
-        const value = (0, metadata_utils_1.getMetadata)(token, cls);
-        if (value !== undefined) {
-            return Object.assign(metadata, {
-                [key]: value,
-            });
-        }
-        return metadata;
-    }, seed);
-}
-/**
- * Collect metadata from a class decorated with @FrontMcpResourceTemplate
- */
-function collectResourceTemplateMetadata(cls) {
-    const extended = (0, metadata_utils_1.getMetadata)(common_1.extendedResourceTemplateMetadata, cls);
-    const seed = (extended ? { ...extended } : {});
-    return Object.entries(common_1.FrontMcpResourceTemplateTokens).reduce((metadata, [key, token]) => {
-        const value = (0, metadata_utils_1.getMetadata)(token, cls);
-        if (value !== undefined) {
-            return Object.assign(metadata, {
-                [key]: value,
-            });
-        }
-        return metadata;
-    }, seed);
-}
-/**
- * Normalize any resource input (class or function) to a ResourceRecord
- */
-function normalizeResource(item) {
-    // Function-style decorator: resource({ uri: '...' })(handler)
-    if (item &&
-        typeof item === 'function' &&
-        item[common_1.FrontMcpResourceTokens.type] === 'function-resource' &&
-        item[common_1.FrontMcpResourceTokens.metadata]) {
-        return {
-            kind: common_1.ResourceKind.FUNCTION,
-            provide: item(),
-            metadata: item[common_1.FrontMcpResourceTokens.metadata],
-        };
-    }
-    // Class-style decorator: @FrontMcpResource({ uri: '...' })
-    if ((0, token_utils_1.isClass)(item)) {
-        const metadata = collectResourceMetadata(item);
-        return { kind: common_1.ResourceKind.CLASS_TOKEN, provide: item, metadata };
-    }
-    const name = item?.name ?? String(item);
-    throw new Error(`Invalid resource '${name}'. Expected a class or a resource function.`);
-}
-/**
- * Normalize any resource template input (class or function) to a ResourceTemplateRecord
- */
-function normalizeResourceTemplate(item) {
-    // Function-style decorator: resourceTemplate({ uriTemplate: '...' })(handler)
-    if (item &&
-        typeof item === 'function' &&
-        item[common_1.FrontMcpResourceTemplateTokens.type] === 'function-resource-template' &&
-        item[common_1.FrontMcpResourceTemplateTokens.metadata]) {
-        return {
-            kind: common_1.ResourceTemplateKind.FUNCTION,
-            provide: item(),
-            metadata: item[common_1.FrontMcpResourceTemplateTokens.metadata],
-        };
-    }
-    // Class-style decorator: @FrontMcpResourceTemplate({ uriTemplate: '...' })
-    if ((0, token_utils_1.isClass)(item)) {
-        const metadata = collectResourceTemplateMetadata(item);
-        return { kind: common_1.ResourceTemplateKind.CLASS_TOKEN, provide: item, metadata };
-    }
-    const name = item?.name ?? String(item);
-    throw new Error(`Invalid resource template '${name}'. Expected a class or a resource template function.`);
-}
-/**
- * Determine if an item is a resource template (vs static resource)
- */
-function isResourceTemplate(item) {
-    // Function-style template
-    if (item &&
-        typeof item === 'function' &&
-        item[common_1.FrontMcpResourceTemplateTokens.type] === 'function-resource-template') {
-        return true;
-    }
-    // Class-style: check if it has uriTemplate metadata
-    if ((0, token_utils_1.isClass)(item)) {
-        const uriTemplate = (0, metadata_utils_1.getMetadata)(common_1.FrontMcpResourceTemplateTokens.uriTemplate, item);
-        return uriTemplate !== undefined;
-    }
-    return false;
-}
-/**
- * Get dependency tokens for graph/cycle detection
- */
-function resourceDiscoveryDeps(rec) {
-    switch (rec.kind) {
-        case common_1.ResourceKind.FUNCTION:
-        case common_1.ResourceTemplateKind.FUNCTION:
-            return (0, token_utils_1.depsOfFunc)(rec.provide, 'discovery');
-        case common_1.ResourceKind.CLASS_TOKEN:
-        case common_1.ResourceTemplateKind.CLASS_TOKEN:
-            return (0, token_utils_1.depsOfClass)(rec.provide, 'discovery');
-        default: {
-            // Exhaustive check - this should never happen if all ResourceKind and ResourceTemplateKind are handled
-            const _exhaustiveCheck = rec;
-            throw new Error(`Unhandled resource kind: ${rec.kind}`);
-        }
-    }
-}
-//# sourceMappingURL=resource.utils.js.map

package/src/resource/resource.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resource.utils.js","sourceRoot":"","sources":["../../../src/resource/resource.utils.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/resource/resource.utils.ts\n\nimport {\n  ResourceMetadata,\n  ResourceTemplateMetadata,\n  FrontMcpResourceTokens,\n  FrontMcpResourceTemplateTokens,\n  extendedResourceMetadata,\n  extendedResourceTemplateMetadata,\n  ResourceType,\n  Token,\n  ResourceRecord,\n  ResourceKind,\n  ResourceTemplateRecord,\n  ResourceTemplateKind,\n  Type,\n  ResourceEntry,\n} from '../common';\nimport { depsOfClass, depsOfFunc, isClass } from '../utils/token.utils';\nimport { getMetadata } from '../utils/metadata.utils';\nimport { ResourceTemplateType } from './resource.types';\n\n// Re-export shared naming utilities (ResourceNameCase is exported from resource.types.ts)\nexport {\n  splitWords,\n  toCase,\n  sepFor,\n  normalizeSegment,\n  normalizeProviderId,\n  normalizeOwnerPath,\n  shortHash,\n  ensureMaxLen,\n} from '../utils/naming.utils';\n\n// Re-export shared lineage utilities\nexport { ownerKeyOf, qualifiedNameOf } from '../utils/lineage.utils';\n\n// Re-export URI template utilities\nexport {\n  parseUriTemplate,\n  matchUriTemplate,\n  expandUriTemplate,\n  extractTemplateParams,\n  isUriTemplate,\n} from '../utils/uri-template.utils';\n\n// Re-export content utilities\nexport { buildResourceContent as buildParsedResourceResult } from '../utils/content.utils';\n\n/**\n * Collect metadata from a class decorated with @FrontMcpResource\n */\nexport function collectResourceMetadata(cls: ResourceType): ResourceMetadata {\n  const extended = getMetadata(extendedResourceMetadata, cls);\n  const seed = (extended ? { ...extended } : {}) as ResourceMetadata;\n  return Object.entries(FrontMcpResourceTokens).reduce((metadata, [key, token]) => {\n    const value = getMetadata(token, cls);\n    if (value !== undefined) {\n      return Object.assign(metadata, {\n        [key]: value,\n      });\n    }\n    return metadata;\n  }, seed);\n}\n\n/**\n * Collect metadata from a class decorated with @FrontMcpResourceTemplate\n */\nexport function collectResourceTemplateMetadata(cls: ResourceTemplateType): ResourceTemplateMetadata {\n  const extended = getMetadata(extendedResourceTemplateMetadata, cls);\n  const seed = (extended ? { ...extended } : {}) as ResourceTemplateMetadata;\n  return Object.entries(FrontMcpResourceTemplateTokens).reduce((metadata, [key, token]) => {\n    const value = getMetadata(token, cls);\n    if (value !== undefined) {\n      return Object.assign(metadata, {\n        [key]: value,\n      });\n    }\n    return metadata;\n  }, seed);\n}\n\n/**\n * Normalize any resource input (class or function) to a ResourceRecord\n */\nexport function normalizeResource(item: any): ResourceRecord {\n  // Function-style decorator: resource({ uri: '...' })(handler)\n  if (\n    item &&\n    typeof item === 'function' &&\n    item[FrontMcpResourceTokens.type] === 'function-resource' &&\n    item[FrontMcpResourceTokens.metadata]\n  ) {\n    return {\n      kind: ResourceKind.FUNCTION,\n      provide: item(),\n      metadata: item[FrontMcpResourceTokens.metadata] as ResourceMetadata,\n    };\n  }\n\n  // Class-style decorator: @FrontMcpResource({ uri: '...' })\n  if (isClass(item)) {\n    const metadata = collectResourceMetadata(item as ResourceType);\n    return { kind: ResourceKind.CLASS_TOKEN, provide: item as Type<ResourceEntry>, metadata };\n  }\n\n  const name = (item as any)?.name ?? String(item);\n  throw new Error(`Invalid resource '${name}'. Expected a class or a resource function.`);\n}\n\n/**\n * Normalize any resource template input (class or function) to a ResourceTemplateRecord\n */\nexport function normalizeResourceTemplate(item: any): ResourceTemplateRecord {\n  // Function-style decorator: resourceTemplate({ uriTemplate: '...' })(handler)\n  if (\n    item &&\n    typeof item === 'function' &&\n    item[FrontMcpResourceTemplateTokens.type] === 'function-resource-template' &&\n    item[FrontMcpResourceTemplateTokens.metadata]\n  ) {\n    return {\n      kind: ResourceTemplateKind.FUNCTION,\n      provide: item(),\n      metadata: item[FrontMcpResourceTemplateTokens.metadata] as ResourceTemplateMetadata,\n    };\n  }\n\n  // Class-style decorator: @FrontMcpResourceTemplate({ uriTemplate: '...' })\n  if (isClass(item)) {\n    const metadata = collectResourceTemplateMetadata(item as ResourceTemplateType);\n    return { kind: ResourceTemplateKind.CLASS_TOKEN, provide: item as Type<ResourceEntry>, metadata };\n  }\n\n  const name = (item as any)?.name ?? String(item);\n  throw new Error(`Invalid resource template '${name}'. Expected a class or a resource template function.`);\n}\n\n/**\n * Determine if an item is a resource template (vs static resource)\n */\nexport function isResourceTemplate(item: any): boolean {\n  // Function-style template\n  if (\n    item &&\n    typeof item === 'function' &&\n    item[FrontMcpResourceTemplateTokens.type] === 'function-resource-template'\n  ) {\n    return true;\n  }\n\n  // Class-style: check if it has uriTemplate metadata\n  if (isClass(item)) {\n    const uriTemplate = getMetadata(FrontMcpResourceTemplateTokens.uriTemplate, item);\n    return uriTemplate !== undefined;\n  }\n\n  return false;\n}\n\n/**\n * Get dependency tokens for graph/cycle detection\n */\nexport function resourceDiscoveryDeps(rec: ResourceRecord | ResourceTemplateRecord): Token[] {\n  switch (rec.kind) {\n    case ResourceKind.FUNCTION:\n    case ResourceTemplateKind.FUNCTION:\n      return depsOfFunc(rec.provide, 'discovery');\n    case ResourceKind.CLASS_TOKEN:\n    case ResourceTemplateKind.CLASS_TOKEN:\n      return depsOfClass(rec.provide, 'discovery');\n    default: {\n      // Exhaustive check - this should never happen if all ResourceKind and ResourceTemplateKind are handled\n      const _exhaustiveCheck: never = rec;\n      throw new Error(`Unhandled resource kind: ${(rec as { kind: string }).kind}`);\n    }\n  }\n}\n"]}

package/src/scope/flows/http.request.flow.js

@@ -1,474 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.httpRequestStateSchema = void 0;
-const tslib_1 = require("tslib");
-const common_1 = require("../../common");
-const zod_1 = require("zod");
-const session_verify_flow_1 = require("../../auth/flows/session.verify.flow");
-const node_crypto_1 = require("node:crypto");
-const plan = {
-    pre: [
-        // request tracing
-        'traceRequest',
-        // rate limiting / concurrency
-        'acquireQuota',
-        'acquireSemaphore',
-        // route request to the correct flow
-        'checkAuthorization',
-        'router',
-    ],
-    execute: [
-        'handleLegacySse',
-        'handleSse',
-        'handleStreamableHttp',
-        'handleStatefulHttp',
-        'handleStatelessHttp',
-        'handleDeleteSession',
-    ],
-    finalize: [
-        // audit/metrics
-        'audit',
-        'metrics',
-        // cleanup
-        'releaseSemaphore',
-        'releaseQuota',
-        'finalize',
-    ],
-    error: [],
-};
-exports.httpRequestStateSchema = zod_1.z.object({
-    decision: common_1.decisionSchema,
-    intent: common_1.intentSchema,
-    verifyResult: session_verify_flow_1.sessionVerifyOutputSchema,
-});
-const name = 'http:request';
-const { Stage } = (0, common_1.FlowHooksOf)('http:request');
-let HttpRequestFlow = class HttpRequestFlow extends common_1.FlowBase {
-    logger = this.scope.logger.child('HttpRequestFlow');
-    requestStartTime = 0;
-    requestId = '';
-    static canActivate(request, scope) {
-        const requestPath = (0, common_1.normalizeEntryPrefix)(request.path);
-        const prefix = (0, common_1.normalizeEntryPrefix)(scope.entryPath);
-        const scopePath = (0, common_1.normalizeScopeBase)(scope.routeBase);
-        const basePath = `${prefix}${scopePath}`;
-        return (requestPath === basePath || // Modern transports: /
-            requestPath === `${basePath}/sse` || // Legacy SSE: /sse
-            requestPath === `${basePath}/message` // Legacy SSE: /message
-        );
-    }
-    async traceRequest() {
-        const { request } = this.rawInput;
-        this.requestStartTime = Date.now();
-        // Get FrontMcpContext from AsyncLocalStorage (already initialized by FlowInstance.runWithContext)
-        const ctx = this.tryGetContext();
-        // Use randomUUID() for fallback instead of Math.random() to avoid collisions under load
-        this.requestId = ctx?.requestId ?? `req-${(0, node_crypto_1.randomUUID)()}`;
-        // Extract request details for logging
-        const headers = request.headers ?? {};
-        const body = request.body;
-        const userAgent = headers['user-agent'];
-        const contentType = headers['content-type'];
-        const accept = headers['accept'];
-        // Use sessionId from context (which generates unique anon IDs) or header
-        // 'no-session' is a logging fallback only, not used for SESSION providers
-        const sessionId = ctx?.sessionId ?? headers['mcp-session-id'] ?? 'no-session';
-        this.logger.info(`[${this.requestId}] ▶ ${request.method} ${request.path}`, {
-            requestId: this.requestId,
-            traceId: ctx?.traceContext.traceId?.slice(0, 16),
-            method: request.method,
-            path: request.path,
-            userAgent: userAgent?.slice(0, 50),
-            sessionId: sessionId?.slice(0, 20),
-            contentType,
-            accept,
-            hasBody: !!request.body,
-            bodyMethod: body?.['method'],
-        });
-        // Log sanitized headers for debugging connection issues
-        const sanitizedHeaders = Object.fromEntries(Object.entries(headers).map(([key, value]) => {
-            // Redact clearly sensitive headers
-            if (/^(authorization|proxy-authorization|cookie|set-cookie|x-api-key)$/i.test(key)) {
-                return [key, '[REDACTED]'];
-            }
-            // Truncate session identifiers instead of logging full values
-            if (key === 'mcp-session-id') {
-                return [key, String(value).slice(0, 8) + '...'];
-            }
-            return [key, value];
-        }));
-        this.logger.debug(`[${this.requestId}] HEADERS`, { headers: sanitizedHeaders });
-    }
-    async checkAuthorization() {
-        const { request } = this.rawInput;
-        this.logger.verbose(`[${this.requestId}] checkAuthorization: verifying session`);
-        try {
-            const result = await this.scope.runFlow('session:verify', { request });
-            if (!result) {
-                this.logger.error(`[${this.requestId}] failed to verify session`);
-                throw new Error('Session verification failed');
-            }
-            this.state.set({
-                verifyResult: result,
-            });
-            // Update FrontMcpContext with verified auth info if available
-            // This allows all subsequent stages to access the auth info via context
-            if (result.kind === 'authorized' && result.authorization) {
-                const ctx = this.tryGetContext();
-                if (ctx) {
-                    // Build AuthInfo from the authorization object
-                    // AuthInfo is the MCP SDK's auth type with token, clientId, scopes, etc.
-                    const { token, user, session } = result.authorization;
-                    ctx.updateAuthInfo({
-                        token,
-                        clientId: user.sub,
-                        scopes: [],
-                        // JWT exp is in seconds, SDK uses milliseconds throughout (e.g., Date.now())
-                        expiresAt: user.exp ? user.exp * 1000 : undefined,
-                        extra: {
-                            user,
-                            sessionId: session?.id,
-                            sessionPayload: session?.payload,
-                        },
-                    });
-                }
-            }
-        }
-        catch (error) {
-            // FlowControl is expected control flow, not an error
-            if (!(error instanceof common_1.FlowControl)) {
-                this.logError(error, 'checkAuthorization');
-            }
-            throw error;
-        }
-    }
-    async router() {
-        try {
-            const { request } = this.rawInput;
-            this.logger.verbose(`[${this.requestId}] router: check request decision`);
-            // Use transport config directly from auth (already parsed with defaults by Zod)
-            const transport = this.scope.auth.transport;
-            const decision = (0, common_1.decideIntent)(request, { ...transport, tolerateMissingAccept: true });
-            // Handle DELETE method immediately - it's for session termination
-            // regardless of what protocol the session was created with
-            if (request.method.toUpperCase() === 'DELETE') {
-                this.logger.verbose(`[${this.requestId}] DELETE request, using decision intent: ${decision.intent}`);
-                if (decision.intent === 'unknown') {
-                    // DELETE without session ID - forward to next middleware
-                    // to allow custom DELETE handlers by developers
-                    this.logger.verbose(`[${this.requestId}] DELETE with unknown intent, forwarding to next middleware`);
-                    this.next();
-                    return;
-                }
-                this.state.set('intent', decision.intent);
-                return;
-            }
-            const { verifyResult } = this.state.required;
-            if (verifyResult.kind === 'authorized') {
-                const { authorization } = verifyResult;
-                request[common_1.ServerRequestTokens.auth] = authorization;
-                // Update FrontMcpContext session metadata (auth info already set in checkAuthorization)
-                if (authorization.session?.payload) {
-                    const ctx = this.tryGetContext();
-                    if (ctx) {
-                        ctx.updateSessionMetadata(authorization.session.payload);
-                    }
-                }
-                if (authorization.session) {
-                    const sessionId = authorization.session.id;
-                    request[common_1.ServerRequestTokens.sessionId] = sessionId;
-                    // Check if the session has been terminated (via DELETE)
-                    // Per MCP spec, requests to terminated sessions should return 404
-                    if (this.scope.notifications.isSessionTerminated(sessionId)) {
-                        this.logger.warn(`[${this.requestId}] Request to terminated session: ${sessionId.slice(0, 20)}...`);
-                        this.respond(common_1.httpRespond.notFound('Session not found'));
-                        return;
-                    }
-                    // Safely access payload.protocol with null check
-                    const protocol = authorization.session.payload?.protocol;
-                    if (protocol) {
-                        this.logger.info(`[${this.requestId}] decision from session: ${protocol}`);
-                        this.state.set('intent', protocol);
-                        return;
-                    }
-                }
-                if (decision.intent === 'unknown') {
-                    // continue to other middleware
-                    // with authentication (public/authorized routes)
-                    this.logger.verbose(`[${this.requestId}] decision is unknown, continue to next http middleware`);
-                    this.next();
-                    return; // Explicit return for clarity (this.next() throws FlowControl)
-                }
-                // register decision intent to state
-                // and move to next stage
-                this.logger.verbose(`[${this.requestId}] decision is request info: ${decision.intent}`);
-                this.state.set('intent', decision.intent);
-            }
-            else {
-                this.logger.verbose(`[${this.requestId}] not authorized request, check decision intent: ${decision.intent}`);
-                if (decision.intent === 'unknown') {
-                    this.logger.verbose(`[${this.requestId}] decision is unknown, continue to other public http middleware`);
-                    // continue to other middleware
-                    // without authentication (public routes)
-                    this.next();
-                    return; // Explicit return for clarity (this.next() throws FlowControl)
-                }
-                this.logger.warn(`[${this.requestId}] decision is ${decision.intent}, but not authorized, respond with 401`);
-                // if the decision is specific mcp transport and no auth
-                // then respond with 401
-                this.respond(common_1.httpRespond.unauthorized({
-                    headers: {
-                        'WWW-Authenticate': verifyResult.prmMetadataHeader,
-                    },
-                }));
-            }
-        }
-        catch (error) {
-            // FlowControl is expected control flow, not an error
-            if (!(error instanceof common_1.FlowControl)) {
-                this.logError(error, 'router');
-            }
-            throw error;
-        }
-    }
-    async handleLegacySse() {
-        try {
-            const response = await this.scope.runFlow('handle:legacy-sse', this.rawInput);
-            if (response) {
-                this.respond(response);
-            }
-            this.handled();
-        }
-        catch (error) {
-            // FlowControl is expected control flow, not an error
-            if (!(error instanceof common_1.FlowControl)) {
-                this.logError(error, 'handleLegacySse');
-            }
-            throw error;
-        }
-    }
-    async handleSse() {
-        try {
-            const response = await this.scope.runFlow('handle:streamable-http', this.rawInput);
-            if (response) {
-                this.respond(response);
-            }
-            this.next();
-        }
-        catch (error) {
-            // FlowControl is expected control flow, not an error
-            if (!(error instanceof common_1.FlowControl)) {
-                this.logError(error, 'handleSse');
-            }
-            throw error;
-        }
-    }
-    async handleStreamableHttp() {
-        try {
-            const response = await this.scope.runFlow('handle:streamable-http', this.rawInput);
-            if (response) {
-                this.respond(response);
-            }
-            this.next();
-        }
-        catch (error) {
-            // FlowControl is expected control flow, not an error
-            if (!(error instanceof common_1.FlowControl)) {
-                this.logError(error, 'handleStreamableHttp');
-            }
-            throw error;
-        }
-    }
-    async handleStatefulHttp() {
-        // this.scope.runFlow('mcp:transport:stateful-http', this.rawInput);
-        this.next();
-    }
-    async handleStatelessHttp() {
-        try {
-            const response = await this.scope.runFlow('handle:stateless-http', this.rawInput);
-            if (response) {
-                this.respond(response);
-            }
-            this.handled();
-        }
-        catch (error) {
-            // FlowControl is expected control flow, not an error
-            if (!(error instanceof common_1.FlowControl)) {
-                this.logError(error, 'handleStatelessHttp');
-            }
-            throw error;
-        }
-    }
-    async handleDeleteSession() {
-        try {
-            const { request } = this.rawInput;
-            // Headers are normalized to lowercase by the adapter
-            const sessionId = request[common_1.ServerRequestTokens.sessionId] ?? request.headers['mcp-session-id'];
-            if (!sessionId || typeof sessionId !== 'string') {
-                this.logger.warn(`[${this.requestId}] DELETE request without valid session ID`);
-                this.respond(common_1.httpRespond.rpcError('No valid session ID provided'));
-                return;
-            }
-            this.logger.info(`[${this.requestId}] DELETE session: ${sessionId}`);
-            // Terminate the session - this unregisters the server AND adds to terminated set
-            // This prevents future requests with this session ID from being accepted
-            const wasRegistered = this.scope.notifications.terminateSession(sessionId);
-            if (!wasRegistered) {
-                // Session not found - per MCP spec, return 404
-                // Note: We still added it to terminated set to prevent future use
-                this.logger.warn(`[${this.requestId}] Session not found for DELETE: ${sessionId}`);
-                this.respond(common_1.httpRespond.notFound('Session not found'));
-                return;
-            }
-            this.logger.info(`[${this.requestId}] Session terminated: ${sessionId}`);
-            this.respond(common_1.httpRespond.noContent());
-        }
-        catch (error) {
-            // FlowControl is expected control flow, not an error
-            if (!(error instanceof common_1.FlowControl)) {
-                this.logError(error, 'handleDeleteSession');
-            }
-            throw error;
-        }
-    }
-    async finalize() {
-        const { request } = this.rawInput;
-        const duration = Date.now() - this.requestStartTime;
-        const intent = this.state.get('intent') ?? 'unknown';
-        this.logger.info(`[${this.requestId}] ◀ ${request.method} ${request.path} completed in ${duration}ms`, {
-            requestId: this.requestId,
-            method: request.method,
-            path: request.path,
-            duration,
-            intent,
-        });
-    }
-    /**
-     * Log an error that occurred during request processing.
-     * Called from stage handlers that catch errors.
-     */
-    logError(error, context) {
-        const { request } = this.rawInput;
-        const duration = Date.now() - this.requestStartTime;
-        // Extract error details - handle various error shapes
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        const errorName = error instanceof Error ? error.name : 'UnknownError';
-        const errorStack = error instanceof Error ? error.stack : undefined;
-        const body = request.body;
-        // For errors with empty messages, try to extract more info
-        const errorCode = error?.code;
-        const errorCause = error?.cause;
-        // Log comprehensive error info including stack trace
-        this.logger.error(`[${this.requestId}] ✖ ${request.method} ${request.path} failed${context ? ` in ${context}` : ''} after ${duration}ms: ${errorMessage || '(no message)'}`, {
-            requestId: this.requestId,
-            method: request.method,
-            path: request.path,
-            duration,
-            context,
-            error: {
-                name: errorName,
-                message: errorMessage || '(no message)',
-                code: errorCode,
-                cause: errorCause instanceof Error ? errorCause.message : errorCause,
-                stack: errorStack,
-            },
-            request: {
-                userAgent: request.headers?.['user-agent']?.slice(0, 50),
-                sessionId: request.headers?.['mcp-session-id']?.slice(0, 20),
-                contentType: request.headers?.['content-type'],
-                bodyMethod: body?.['method'],
-                bodyId: body?.['id'],
-            },
-            state: {
-                intent: this.state.get('intent'),
-                hasVerifyResult: !!this.state.get('verifyResult'),
-            },
-        });
-    }
-};
-tslib_1.__decorate([
-    Stage('traceRequest'),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", []),
-    tslib_1.__metadata("design:returntype", Promise)
-], HttpRequestFlow.prototype, "traceRequest", null);
-tslib_1.__decorate([
-    Stage('checkAuthorization'),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", []),
-    tslib_1.__metadata("design:returntype", Promise)
-], HttpRequestFlow.prototype, "checkAuthorization", null);
-tslib_1.__decorate([
-    Stage('router'),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", []),
-    tslib_1.__metadata("design:returntype", Promise)
-], HttpRequestFlow.prototype, "router", null);
-tslib_1.__decorate([
-    Stage('handleLegacySse', {
-        filter: ({ state: { required: { intent }, }, }) => intent === 'legacy-sse',
-    }),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", []),
-    tslib_1.__metadata("design:returntype", Promise)
-], HttpRequestFlow.prototype, "handleLegacySse", null);
-tslib_1.__decorate([
-    Stage('handleSse', {
-        filter: ({ state: { required: { intent }, }, }) => intent === 'sse',
-    }),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", []),
-    tslib_1.__metadata("design:returntype", Promise)
-], HttpRequestFlow.prototype, "handleSse", null);
-tslib_1.__decorate([
-    Stage('handleStreamableHttp', {
-        filter: ({ state: { required: { intent }, }, }) => intent === 'streamable-http',
-    }),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", []),
-    tslib_1.__metadata("design:returntype", Promise)
-], HttpRequestFlow.prototype, "handleStreamableHttp", null);
-tslib_1.__decorate([
-    Stage('handleStatefulHttp', {
-        filter: ({ state: { required: { intent }, }, }) => intent === 'stateful-http',
-    }),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", []),
-    tslib_1.__metadata("design:returntype", Promise)
-], HttpRequestFlow.prototype, "handleStatefulHttp", null);
-tslib_1.__decorate([
-    Stage('handleStatelessHttp', {
-        filter: ({ state: { required: { intent }, }, }) => intent === 'stateless-http',
-    }),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", []),
-    tslib_1.__metadata("design:returntype", Promise)
-], HttpRequestFlow.prototype, "handleStatelessHttp", null);
-tslib_1.__decorate([
-    Stage('handleDeleteSession', {
-        filter: ({ state: { required: { intent }, }, }) => intent === 'delete-session',
-    }),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", []),
-    tslib_1.__metadata("design:returntype", Promise)
-], HttpRequestFlow.prototype, "handleDeleteSession", null);
-tslib_1.__decorate([
-    Stage('finalize'),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", []),
-    tslib_1.__metadata("design:returntype", Promise)
-], HttpRequestFlow.prototype, "finalize", null);
-HttpRequestFlow = tslib_1.__decorate([
-    (0, common_1.Flow)({
-        name,
-        plan,
-        access: 'public',
-        inputSchema: common_1.httpInputSchema,
-        outputSchema: common_1.httpOutputSchema,
-        middleware: {
-            path: '/',
-        },
-    })
-], HttpRequestFlow);
-exports.default = HttpRequestFlow;
-//# sourceMappingURL=http.request.flow.js.map