@frontmcp/sdk 0.4.1 → 0.5.1

package/src/resource/resource.utils.js

@@ -0,0 +1,151 @@
+"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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -1,369 +1,77 @@
 import { httpInputSchema, FlowRunOptions, httpOutputSchema, FlowBase, ScopeEntry, ServerRequest } from '../../common';
 import { z } from 'zod';
 declare const plan: {
-    readonly pre: ["acquireQuota", "acquireSemaphore", "checkAuthorization", "router"];
-    readonly execute: ["handleLegacySse", "handleSse", "handleStreamableHttp", "handleStatefulHttp", "handleStatelessHttp"];
+    readonly pre: ["traceRequest", "acquireQuota", "acquireSemaphore", "checkAuthorization", "router"];
+    readonly execute: ["handleLegacySse", "handleSse", "handleStreamableHttp", "handleStatefulHttp", "handleStatelessHttp", "handleDeleteSession"];
     readonly finalize: ["audit", "metrics", "releaseSemaphore", "releaseQuota", "finalize"];
-    readonly error: ["error"];
+    readonly error: [];
 };
 export declare const httpRequestStateSchema: z.ZodObject<{
     decision: z.ZodObject<{
-        intent: z.ZodUnion<[z.ZodLiteral<"legacy-sse">, z.ZodLiteral<"sse">, z.ZodLiteral<"streamable-http">, z.ZodLiteral<"stateful-http">, z.ZodLiteral<"stateless-http">, z.ZodLiteral<"unknown">]>;
-        reasons: z.ZodArray<z.ZodString, "many">;
+        intent: z.ZodUnion<readonly [z.ZodLiteral<"legacy-sse">, z.ZodLiteral<"sse">, z.ZodLiteral<"streamable-http">, z.ZodLiteral<"stateful-http">, z.ZodLiteral<"stateless-http">, z.ZodLiteral<"delete-session">, z.ZodLiteral<"unknown">]>;
+        reasons: z.ZodArray<z.ZodString>;
         recommendation: z.ZodOptional<z.ZodObject<{
             httpStatus: z.ZodNumber;
             message: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            message: string;
-            httpStatus: number;
-        }, {
-            message: string;
-            httpStatus: number;
-        }>>;
+        }, z.core.$strip>>;
         debug: z.ZodOptional<z.ZodObject<{
             key: z.ZodNumber;
             channel: z.ZodNumber;
             flags: z.ZodNumber;
-        }, "strip", z.ZodTypeAny, {
-            key: number;
-            channel: number;
-            flags: number;
-        }, {
-            key: number;
-            channel: number;
-            flags: number;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        intent: "unknown" | "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
-        reasons: string[];
-        recommendation?: {
-            message: string;
-            httpStatus: number;
-        } | undefined;
-        debug?: {
-            key: number;
-            channel: number;
-            flags: number;
-        } | undefined;
-    }, {
-        intent: "unknown" | "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
-        reasons: string[];
-        recommendation?: {
-            message: string;
-            httpStatus: number;
-        } | undefined;
-        debug?: {
-            key: number;
-            channel: number;
-            flags: number;
-        } | undefined;
-    }>;
-    intent: z.ZodUnion<[z.ZodLiteral<"legacy-sse">, z.ZodLiteral<"sse">, z.ZodLiteral<"streamable-http">, z.ZodLiteral<"stateful-http">, z.ZodLiteral<"stateless-http">, z.ZodLiteral<"unknown">]>;
-    verifyResult: z.ZodUnion<[z.ZodObject<{
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    intent: z.ZodUnion<readonly [z.ZodLiteral<"legacy-sse">, z.ZodLiteral<"sse">, z.ZodLiteral<"streamable-http">, z.ZodLiteral<"stateful-http">, z.ZodLiteral<"stateless-http">, z.ZodLiteral<"delete-session">, z.ZodLiteral<"unknown">]>;
+    verifyResult: z.ZodUnion<readonly [z.ZodObject<{
         kind: z.ZodLiteral<"unauthorized">;
         prmMetadataHeader: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        kind: "unauthorized";
-        prmMetadataHeader: string;
-    }, {
-        kind: "unauthorized";
-        prmMetadataHeader: string;
-    }>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"authorized">;
         authorization: z.ZodObject<{
             token: z.ZodString;
             session: z.ZodOptional<z.ZodObject<{
                 id: z.ZodString;
-                payload: z.ZodObject<{
+                payload: z.ZodOptional<z.ZodObject<{
                     nodeId: z.ZodString;
                     authSig: z.ZodString;
                     uuid: z.ZodString;
                     iat: z.ZodNumber;
-                    protocol: z.ZodEnum<["legacy-sse", "sse", "streamable-http", "stateful-http", "stateless-http"]>;
-                }, "strip", z.ZodTypeAny, {
-                    uuid: string;
-                    nodeId: string;
-                    authSig: string;
-                    iat: number;
-                    protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
-                }, {
-                    uuid: string;
-                    nodeId: string;
-                    authSig: string;
-                    iat: number;
-                    protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
-                }>;
-            }, "strip", z.ZodTypeAny, {
-                id: string;
-                payload: {
-                    uuid: string;
-                    nodeId: string;
-                    authSig: string;
-                    iat: number;
-                    protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
-                };
-            }, {
-                id: string;
-                payload: {
-                    uuid: string;
-                    nodeId: string;
-                    authSig: string;
-                    iat: number;
-                    protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
-                };
-            }>>;
+                    protocol: z.ZodOptional<z.ZodEnum<{
+                        "legacy-sse": "legacy-sse";
+                        sse: "sse";
+                        "streamable-http": "streamable-http";
+                        "stateful-http": "stateful-http";
+                        "stateless-http": "stateless-http";
+                    }>>;
+                    isPublic: z.ZodOptional<z.ZodBoolean>;
+                    platformType: z.ZodOptional<z.ZodEnum<{
+                        unknown: "unknown";
+                        continue: "continue";
+                        openai: "openai";
+                        claude: "claude";
+                        gemini: "gemini";
+                        cursor: "cursor";
+                        cody: "cody";
+                        "generic-mcp": "generic-mcp";
+                        "ext-apps": "ext-apps";
+                    }>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
             user: z.ZodObject<{
                 iss: z.ZodString;
                 sid: z.ZodOptional<z.ZodString>;
                 sub: z.ZodString;
                 exp: z.ZodOptional<z.ZodNumber>;
                 iat: z.ZodOptional<z.ZodNumber>;
-                aud: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+                aud: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
                 email: z.ZodOptional<z.ZodString>;
                 username: z.ZodOptional<z.ZodString>;
                 preferred_username: z.ZodOptional<z.ZodString>;
                 name: z.ZodOptional<z.ZodString>;
                 picture: z.ZodOptional<z.ZodString>;
-            }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                iss: z.ZodString;
-                sid: z.ZodOptional<z.ZodString>;
-                sub: z.ZodString;
-                exp: z.ZodOptional<z.ZodNumber>;
-                iat: z.ZodOptional<z.ZodNumber>;
-                aud: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
-                email: z.ZodOptional<z.ZodString>;
-                username: z.ZodOptional<z.ZodString>;
-                preferred_username: z.ZodOptional<z.ZodString>;
-                name: z.ZodOptional<z.ZodString>;
-                picture: z.ZodOptional<z.ZodString>;
-            }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                iss: z.ZodString;
-                sid: z.ZodOptional<z.ZodString>;
-                sub: z.ZodString;
-                exp: z.ZodOptional<z.ZodNumber>;
-                iat: z.ZodOptional<z.ZodNumber>;
-                aud: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
-                email: z.ZodOptional<z.ZodString>;
-                username: z.ZodOptional<z.ZodString>;
-                preferred_username: z.ZodOptional<z.ZodString>;
-                name: z.ZodOptional<z.ZodString>;
-                picture: z.ZodOptional<z.ZodString>;
-            }, z.ZodTypeAny, "passthrough">>;
-        }, "strip", z.ZodTypeAny, {
-            token: string;
-            user: {
-                sub: string;
-                iss: string;
-                name?: string | undefined;
-                email?: string | undefined;
-                iat?: number | undefined;
-                sid?: string | undefined;
-                exp?: number | undefined;
-                aud?: string | string[] | undefined;
-                username?: string | undefined;
-                preferred_username?: string | undefined;
-                picture?: string | undefined;
-            } & {
-                [k: string]: unknown;
-            };
-            session?: {
-                id: string;
-                payload: {
-                    uuid: string;
-                    nodeId: string;
-                    authSig: string;
-                    iat: number;
-                    protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
-                };
-            } | undefined;
-        }, {
-            token: string;
-            user: {
-                sub: string;
-                iss: string;
-                name?: string | undefined;
-                email?: string | undefined;
-                iat?: number | undefined;
-                sid?: string | undefined;
-                exp?: number | undefined;
-                aud?: string | string[] | undefined;
-                username?: string | undefined;
-                preferred_username?: string | undefined;
-                picture?: string | undefined;
-            } & {
-                [k: string]: unknown;
-            };
-            session?: {
-                id: string;
-                payload: {
-                    uuid: string;
-                    nodeId: string;
-                    authSig: string;
-                    iat: number;
-                    protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
-                };
-            } | undefined;
-        }>;
-    }, "strip", z.ZodTypeAny, {
-        kind: "authorized";
-        authorization: {
-            token: string;
-            user: {
-                sub: string;
-                iss: string;
-                name?: string | undefined;
-                email?: string | undefined;
-                iat?: number | undefined;
-                sid?: string | undefined;
-                exp?: number | undefined;
-                aud?: string | string[] | undefined;
-                username?: string | undefined;
-                preferred_username?: string | undefined;
-                picture?: string | undefined;
-            } & {
-                [k: string]: unknown;
-            };
-            session?: {
-                id: string;
-                payload: {
-                    uuid: string;
-                    nodeId: string;
-                    authSig: string;
-                    iat: number;
-                    protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
-                };
-            } | undefined;
-        };
-    }, {
-        kind: "authorized";
-        authorization: {
-            token: string;
-            user: {
-                sub: string;
-                iss: string;
-                name?: string | undefined;
-                email?: string | undefined;
-                iat?: number | undefined;
-                sid?: string | undefined;
-                exp?: number | undefined;
-                aud?: string | string[] | undefined;
-                username?: string | undefined;
-                preferred_username?: string | undefined;
-                picture?: string | undefined;
-            } & {
-                [k: string]: unknown;
-            };
-            session?: {
-                id: string;
-                payload: {
-                    uuid: string;
-                    nodeId: string;
-                    authSig: string;
-                    iat: number;
-                    protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
-                };
-            } | undefined;
-        };
-    }>]>;
-}, "strip", z.ZodTypeAny, {
-    intent: "unknown" | "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
-    decision: {
-        intent: "unknown" | "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
-        reasons: string[];
-        recommendation?: {
-            message: string;
-            httpStatus: number;
-        } | undefined;
-        debug?: {
-            key: number;
-            channel: number;
-            flags: number;
-        } | undefined;
-    };
-    verifyResult: {
-        kind: "unauthorized";
-        prmMetadataHeader: string;
-    } | {
-        kind: "authorized";
-        authorization: {
-            token: string;
-            user: {
-                sub: string;
-                iss: string;
-                name?: string | undefined;
-                email?: string | undefined;
-                iat?: number | undefined;
-                sid?: string | undefined;
-                exp?: number | undefined;
-                aud?: string | string[] | undefined;
-                username?: string | undefined;
-                preferred_username?: string | undefined;
-                picture?: string | undefined;
-            } & {
-                [k: string]: unknown;
-            };
-            session?: {
-                id: string;
-                payload: {
-                    uuid: string;
-                    nodeId: string;
-                    authSig: string;
-                    iat: number;
-                    protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
-                };
-            } | undefined;
-        };
-    };
-}, {
-    intent: "unknown" | "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
-    decision: {
-        intent: "unknown" | "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
-        reasons: string[];
-        recommendation?: {
-            message: string;
-            httpStatus: number;
-        } | undefined;
-        debug?: {
-            key: number;
-            channel: number;
-            flags: number;
-        } | undefined;
-    };
-    verifyResult: {
-        kind: "unauthorized";
-        prmMetadataHeader: string;
-    } | {
-        kind: "authorized";
-        authorization: {
-            token: string;
-            user: {
-                sub: string;
-                iss: string;
-                name?: string | undefined;
-                email?: string | undefined;
-                iat?: number | undefined;
-                sid?: string | undefined;
-                exp?: number | undefined;
-                aud?: string | string[] | undefined;
-                username?: string | undefined;
-                preferred_username?: string | undefined;
-                picture?: string | undefined;
-            } & {
-                [k: string]: unknown;
-            };
-            session?: {
-                id: string;
-                payload: {
-                    uuid: string;
-                    nodeId: string;
-                    authSig: string;
-                    iat: number;
-                    protocol: "sse" | "legacy-sse" | "streamable-http" | "stateful-http" | "stateless-http";
-                };
-            } | undefined;
-        };
-    };
-}>;
+            }, z.core.$loose>;
+        }, z.core.$strip>;
+    }, z.core.$strip>]>;
+}, z.core.$strip>;
 declare const name: "http:request";
 declare global {
     interface ExtendFlows {
@@ -372,7 +80,10 @@ declare global {
 }
 export default class HttpRequestFlow extends FlowBase<typeof name> {
     logger: import("../../common").FrontMcpLogger;
+    private requestStartTime;
+    private requestId;
     static canActivate(request: ServerRequest, scope: ScopeEntry): boolean;
+    traceRequest(): Promise<void>;
     checkAuthorization(): Promise<void>;
     router(): Promise<void>;
     handleLegacySse(): Promise<void>;
@@ -380,5 +91,12 @@ export default class HttpRequestFlow extends FlowBase<typeof name> {
     handleStreamableHttp(): Promise<void>;
     handleStatefulHttp(): Promise<void>;
     handleStatelessHttp(): Promise<void>;
+    handleDeleteSession(): Promise<void>;
+    finalize(): Promise<void>;
+    /**
+     * Log an error that occurred during request processing.
+     * Called from stage handlers that catch errors.
+     */
+    private logError;
 }
 export {};