@frontmcp/sdk 0.4.0 → 0.5.0

package/src/common/utils/decide-request-intent.utils.js

@@ -10,6 +10,7 @@ exports.intentSchema = zod_1.z.union([
     zod_1.z.literal('streamable-http'),
     zod_1.z.literal('stateful-http'),
     zod_1.z.literal('stateless-http'),
+    zod_1.z.literal('delete-session'),
     zod_1.z.literal('unknown'),
 ]);
 exports.decisionSchema = zod_1.z.object({
@@ -53,12 +54,13 @@ bit 10     LEGACY_EN                   (config: enableLegacySSE)
 ----------------------------------------------------------------------------- */
 // --- Channels ---------------------------------------------------------------
 const CH_OTHER = 0b000;
-const CH_GET_SSE = 0b001;
+const CH_GET_SSE = 0b001; // GET / + SSE (not handled, forward to next middleware)
 const CH_POST_INIT_JSON = 0b010;
 const CH_POST_INIT_SSE = 0b011;
 const CH_POST_JSON = 0b100;
 const CH_POST_SSE = 0b101;
-const CH_POST_MESSAGE = 0b110; // NEW: POST /message (legacy bridge)
+const CH_POST_MESSAGE = 0b110; // POST /message (legacy bridge)
+const CH_GET_SSE_PATH = 0b111; // GET /sse path (legacy SSE initialize)
 const CH_MASK = 0b00000111;
 // --- Flags ------------------------------------------------------------------
 const B_HAS_SESSION = 1 << 3; // 8
@@ -86,6 +88,10 @@ function pathOf(req) {
         return String(raw).split('?')[0] || '/';
     }
 }
+// Check if path is the legacy SSE path (/sse)
+function isLegacySsePath(path) {
+    return path === '/sse' || path.endsWith('/sse');
+}
 /** Optionally extract transportType from base64 JSON session id, if you embed it. */
 function tryDecodeTransportType(sessionId) {
     if (!sessionId)
@@ -110,20 +116,23 @@ function computeBitmap(req, cfg) {
     const acceptSSE = wantsSSE(accept);
     const acceptJSON = wantsJSON(accept) || (!accept && cfg.tolerateMissingAccept);
     const init = method === 'POST' && isInitialize(req.body);
-    const postToMessage = method === 'POST' && path === '/message';
+    const postToMessage = method === 'POST' && (path === '/message' || path.endsWith('/message'));
+    const getToSsePath = method === 'GET' && isLegacySsePath(path);
     const channel = method === 'POST' && postToMessage
         ? CH_POST_MESSAGE
-        : method === 'GET' && acceptSSE
-            ? CH_GET_SSE
-            : method === 'POST' && init && acceptSSE
-                ? CH_POST_INIT_SSE
-                : method === 'POST' && init && acceptJSON
-                    ? CH_POST_INIT_JSON
-                    : method === 'POST' && !init && acceptSSE
-                        ? CH_POST_SSE
-                        : method === 'POST' && !init && acceptJSON
-                            ? CH_POST_JSON
-                            : CH_OTHER;
+        : getToSsePath && acceptSSE
+            ? CH_GET_SSE_PATH // GET /sse → legacy SSE channel
+            : method === 'GET' && acceptSSE
+                ? CH_GET_SSE // GET / + SSE → forward to next middleware (unknown)
+                : method === 'POST' && init && acceptSSE
+                    ? CH_POST_INIT_SSE
+                    : method === 'POST' && init && acceptJSON
+                        ? CH_POST_INIT_JSON
+                        : method === 'POST' && !init && acceptSSE
+                            ? CH_POST_SSE
+                            : method === 'POST' && !init && acceptJSON
+                                ? CH_POST_JSON
+                                : CH_OTHER;
     let flags = 0;
     if (sessionId)
         flags |= B_HAS_SESSION;
@@ -145,21 +154,47 @@ function computeBitmap(req, cfg) {
 }
 // --- Rules (merged semantics) -----------------------------------------------
 const RULES = [
-    // A) Legacy SSE (GET SSE without session) → requires legacy enabled
+    // A) Legacy SSE via GET /sse path (without session) → requires legacy enabled
     {
         care: CH_MASK | B_HAS_SESSION | B_LEGACY_EN,
-        match: CH_GET_SSE | B_LEGACY_EN, // HAS_SESSION must be 0; it's in 'care' but not in 'match'
-        outcome: { intent: 'legacy-sse', reason: 'GET SSE without Mcp-Session-Id → legacy SSE.' },
+        match: CH_GET_SSE_PATH | B_LEGACY_EN, // HAS_SESSION must be 0; it's in 'care' but not in 'match'
+        outcome: { intent: 'legacy-sse', reason: 'GET /sse without Mcp-Session-Id → legacy SSE.' },
     },
     {
         care: CH_MASK | B_HAS_SESSION | B_LEGACY_EN,
-        match: CH_GET_SSE /* legacy disabled; HAS_SESSION=0 */,
+        match: CH_GET_SSE_PATH /* legacy disabled; HAS_SESSION=0 */,
         outcome: {
             intent: 'unknown',
             reason: 'Legacy SSE disabled.',
             recommendation: { httpStatus: 405, message: 'Legacy SSE disabled' },
         },
     },
+    // A2) GET / + SSE (not /sse path) with session ID → SSE listener for streamable-http
+    // Per MCP 2025-11-25 spec, clients can open SSE stream via GET with session ID
+    {
+        care: CH_MASK | B_HAS_SESSION | B_SSE_LISTENER_EN | B_STREAMABLE_EN,
+        match: CH_GET_SSE | B_HAS_SESSION | B_SSE_LISTENER_EN | B_STREAMABLE_EN,
+        outcome: { intent: 'streamable-http', reason: 'GET / with session ID → SSE listener for streamable-http.' },
+    },
+    // A2b) GET / + SSE with session but listener/streamable disabled
+    {
+        care: CH_MASK | B_HAS_SESSION | B_SSE_LISTENER_EN,
+        match: CH_GET_SSE | B_HAS_SESSION /* listener disabled */,
+        outcome: {
+            intent: 'unknown',
+            reason: 'SSE listener disabled for GET / requests.',
+            recommendation: { httpStatus: 405, message: 'SSE listener disabled' },
+        },
+    },
+    // A2c) GET / + SSE without session → forward to next middleware
+    {
+        care: CH_MASK | B_HAS_SESSION,
+        match: CH_GET_SSE /* no session */,
+        outcome: {
+            intent: 'unknown',
+            reason: 'GET / with SSE requires session for MCP transport.',
+        },
+    },
     // B) Legacy SSE: POST /message WITH session id
     {
         care: CH_MASK | B_HAS_SESSION | B_LEGACY_EN,
@@ -175,10 +210,10 @@ const RULES = [
             recommendation: { httpStatus: 405, message: 'Legacy SSE disabled' },
         },
     },
-    // C) Modern SSE (GET SSE with session) → requires SSE listener enabled
+    // C) Modern SSE (GET /sse with session) → requires SSE listener enabled
     {
         care: CH_MASK | B_SSE_LISTENER_EN | B_HAS_SESSION,
-        match: CH_GET_SSE | B_HAS_SESSION /* listener disabled */,
+        match: CH_GET_SSE_PATH | B_HAS_SESSION /* listener disabled */,
         outcome: {
             intent: 'unknown',
             reason: 'SSE listener disabled.',
@@ -187,10 +222,16 @@ const RULES = [
     },
     {
         care: CH_MASK | B_SSE_LISTENER_EN | B_HAS_SESSION,
-        match: CH_GET_SSE | B_SSE_LISTENER_EN | B_HAS_SESSION,
-        outcome: { intent: 'sse', reason: 'GET SSE with Mcp-Session-Id.' },
+        match: CH_GET_SSE_PATH | B_SSE_LISTENER_EN | B_HAS_SESSION,
+        outcome: { intent: 'sse', reason: 'GET /sse with Mcp-Session-Id.' },
     },
     // D) Initialize (POST → SSE)
+    // D1) Stateless initialize (no session, stateless enabled) - must come before streamable rules
+    {
+        care: CH_MASK | B_HAS_SESSION | B_STATELESS_EN,
+        match: CH_POST_INIT_SSE | B_STATELESS_EN /* no session */,
+        outcome: { intent: 'stateless-http', reason: 'Stateless initialize (no session).' },
+    },
     {
         care: CH_MASK | B_STREAMABLE_EN,
         match: CH_POST_INIT_SSE /* streamable disabled */,
@@ -206,6 +247,12 @@ const RULES = [
         outcome: { intent: 'streamable-http', reason: 'Initialize with SSE.' },
     },
     // E) Initialize (POST → JSON)
+    // E1) Stateless initialize JSON (no session, stateless enabled) - must come before stateful rules
+    {
+        care: CH_MASK | B_HAS_SESSION | B_STATELESS_EN,
+        match: CH_POST_INIT_JSON | B_STATELESS_EN /* no session */,
+        outcome: { intent: 'stateless-http', reason: 'Stateless initialize JSON (no session).' },
+    },
     {
         care: CH_MASK | B_STREAMABLE_EN,
         match: CH_POST_INIT_JSON /* streamable disabled */,
@@ -292,9 +339,27 @@ const RULES = [
 // --- Public API --------------------------------------------------------------
 function decideIntent(req, cfg) {
     const reasons = [];
+    const method = req.method.toUpperCase();
+    // Handle HTTP DELETE for session termination (MCP 2025-11-25 spec)
+    if (method === 'DELETE') {
+        const sessionId = h(req, 'mcp-session-id');
+        if (!sessionId) {
+            return {
+                intent: 'unknown',
+                reasons: ['DELETE requires Mcp-Session-Id header.'],
+                recommendation: { httpStatus: 400, message: 'Session ID required for DELETE' },
+                debug: { key: 0, channel: 0, flags: 0 },
+            };
+        }
+        return {
+            intent: 'delete-session',
+            reasons: ['DELETE with Mcp-Session-Id → session termination.'],
+            debug: { key: 0, channel: 0, flags: sessionId ? B_HAS_SESSION : 0 },
+        };
+    }
     const { key, channel, flags, init } = computeBitmap(req, cfg);
     // Optional strict Accept validation for POST (incl. /message)
-    if (req.method.toUpperCase() === 'POST') {
+    if (method === 'POST') {
         const accept = h(req, 'accept');
         const acceptsSSE = wantsSSE(accept);
         const acceptsJSON = wantsJSON(accept) || (!accept && cfg.tolerateMissingAccept);

package/src/common/utils/decide-request-intent.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"decide-request-intent.utils.js","sourceRoot":"","sources":["../../../../src/common/utils/decide-request-intent.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport {ServerRequest} from \"../interfaces\";\n\n/* --------------------------------- Schemas --------------------------------- */\n\nexport const intentSchema = z.union([\n  z.literal('legacy-sse'),\n  z.literal('sse'),\n  z.literal('streamable-http'),\n  z.literal('stateful-http'),\n  z.literal('stateless-http'),\n  z.literal('unknown'),\n]);\n\nexport const decisionSchema = z.object({\n  intent: intentSchema,\n  reasons: z.array(z.string()),\n  recommendation: z\n    .object({\n      httpStatus: z.number(),\n      message: z.string(),\n    })\n    .optional(),\n  // Echo back bits for debugging/telemetry if you like\n  debug: z\n    .object({\n      key: z.number(),\n      channel: z.number(),\n      flags: z.number(),\n    })\n    .optional(),\n});\n\nexport type HttpRequestIntent =\n  | 'legacy-sse'\n  | 'sse'\n  | 'streamable-http'\n  | 'stateful-http'\n  | 'stateless-http';\n\nexport type Intent = HttpRequestIntent | 'unknown';\n\nexport type Decision = {\n  intent: Intent;\n  reasons: string[];\n  recommendation?: { httpStatus: number; message: string };\n  // Echo back bits for debugging/telemetry if you like\n  debug?: { key: number; channel: number; flags: number };\n};\n\nexport interface Config {\n  enableLegacySSE: boolean;\n  enableSseListener: boolean;\n  enableStreamableHttp: boolean;\n  enableStatefulHttp: boolean;\n  enableStatelessHttp: boolean;\n  requireSessionForStreamable: boolean;\n  tolerateMissingAccept: boolean;\n}\n\n/* ------------------------------- Bit layout ---------------------------------\n\nbits 0..2  CHANNEL\n           000 OTHER\n           001 GET_SSE                 (GET + Accept: text/event-stream)\n           010 POST_INIT_JSON          (POST initialize + Accept: application/json or default JSON)\n           011 POST_INIT_SSE           (POST initialize + Accept: text/event-stream)\n           100 POST_JSON               (POST non-init + Accept: application/json or default JSON)\n           101 POST_SSE                (POST non-init + Accept: text/event-stream)\n           110 POST_MESSAGE            (POST to /message)  ← legacy bridge\n\nbit 3      HAS_SESSION                 (Mcp-Session-Id present)\nbit 4      STATELESS_EN                (config: enableStatelessHttp)\nbit 5      REQ_SESSION                 (config: requireSessionForStreamable)\nbit 6      LEGACY_HINT                 (x-legacy-sse=true OR session.transportType=legacy-sse)\nbit 7      SSE_LISTENER_EN             (config: enableSseListener)\nbit 8      STREAMABLE_EN               (config: enableStreamableHttp)\nbit 9      STATEFUL_EN                 (config: enableStatefulHttp)\nbit 10     LEGACY_EN                   (config: enableLegacySSE)\n\n----------------------------------------------------------------------------- */\n\n// --- Channels ---------------------------------------------------------------\n\nconst CH_OTHER = 0b000;\nconst CH_GET_SSE = 0b001;\nconst CH_POST_INIT_JSON = 0b010;\nconst CH_POST_INIT_SSE = 0b011;\nconst CH_POST_JSON = 0b100;\nconst CH_POST_SSE = 0b101;\nconst CH_POST_MESSAGE = 0b110; // NEW: POST /message (legacy bridge)\n\nconst CH_MASK = 0b00000111;\n\n// --- Flags ------------------------------------------------------------------\n\nconst B_HAS_SESSION = 1 << 3; // 8\nconst B_STATELESS_EN = 1 << 4; // 16\nconst B_REQ_SESSION = 1 << 5; // 32\nconst B_LEGACY_HINT = 1 << 6; // 64 (kept for telemetry; not required by merged rules)\nconst B_SSE_LISTENER_EN = 1 << 7; // 128\nconst B_STREAMABLE_EN = 1 << 8; // 256\nconst B_STATEFUL_EN = 1 << 9; // 512\nconst B_LEGACY_EN = 1 << 10; // 1024\n\n// --- Minimal helpers ---------------------------------------------------------\n\nconst h = (req: ServerRequest, name: string) =>\n  Object.entries(req.headers).find(([k]) => k.toLowerCase() === name.toLowerCase())?.[1];\n\nconst wantsSSE = (accept?: string) => (accept ?? '').toLowerCase().includes('text/event-stream');\nconst wantsJSON = (accept?: string) => (accept ?? '').toLowerCase().includes('application/json');\nconst isInitialize = (body: unknown) =>\n  !!body && typeof body === 'object' && (body as any).method === 'initialize';\n\n// Robust path extractor (supports absolute/relative)\nfunction pathOf(req: ServerRequest): string {\n  const anyReq = req as any;\n  const raw = anyReq.path ?? anyReq.pathname ?? anyReq.url ?? '/';\n  try {\n    const u = new URL(String(raw), 'http://local');\n    return u.pathname || '/';\n  } catch {\n    return String(raw).split('?')[0] || '/';\n  }\n}\n\n/** Optionally extract transportType from base64 JSON session id, if you embed it. */\nfunction tryDecodeTransportType(sessionId?: string): string | undefined {\n  if (!sessionId) return;\n  try {\n    const b64 = sessionId.replace(/-/g, '+').replace(/_/g, '/');\n    const obj = JSON.parse(Buffer.from(b64, 'base64').toString('utf8'));\n    return obj?.transportType;\n  } catch {\n    return;\n  }\n}\n\n// --- Build the 11-bit key ----------------------------------------------------\n\nfunction computeBitmap(req: ServerRequest, cfg: Config) {\n  const method = req.method.toUpperCase();\n  const accept = h(req, 'accept');\n  const sessionId = h(req, 'mcp-session-id');\n  const legacyHeader = h(req, 'x-legacy-sse') === 'true';\n  const transportType = tryDecodeTransportType(sessionId);\n  const path = pathOf(req);\n\n  const acceptSSE = wantsSSE(accept);\n  const acceptJSON = wantsJSON(accept) || (!accept && cfg.tolerateMissingAccept);\n  const init = method === 'POST' && isInitialize(req.body);\n  const postToMessage = method === 'POST' && path === '/message';\n\n  const channel =\n    method === 'POST' && postToMessage\n      ? CH_POST_MESSAGE\n      : method === 'GET' && acceptSSE\n        ? CH_GET_SSE\n        : method === 'POST' && init && acceptSSE\n          ? CH_POST_INIT_SSE\n          : method === 'POST' && init && acceptJSON\n            ? CH_POST_INIT_JSON\n            : method === 'POST' && !init && acceptSSE\n              ? CH_POST_SSE\n              : method === 'POST' && !init && acceptJSON\n                ? CH_POST_JSON\n                : CH_OTHER;\n\n  let flags = 0;\n  if (sessionId) flags |= B_HAS_SESSION;\n  if (cfg.enableStatelessHttp) flags |= B_STATELESS_EN;\n  if (cfg.requireSessionForStreamable) flags |= B_REQ_SESSION;\n  if (legacyHeader || transportType === 'legacy-sse') flags |= B_LEGACY_HINT; // informational\n  if (cfg.enableSseListener) flags |= B_SSE_LISTENER_EN;\n  if (cfg.enableStreamableHttp) flags |= B_STREAMABLE_EN;\n  if (cfg.enableStatefulHttp) flags |= B_STATEFUL_EN;\n  if (cfg.enableLegacySSE) flags |= B_LEGACY_EN;\n\n  return { key: (channel & CH_MASK) | flags, channel, flags, init };\n}\n\n// --- Rule definition ---------------------------------------------------------\n\ntype Rule = {\n  care: number; // which bits matter\n  match: number; // the exact bit pattern to match (after masking)\n  outcome: Omit<Decision, 'reasons' | 'debug'> & { reason: string };\n};\n\n// --- Rules (merged semantics) -----------------------------------------------\n\nconst RULES: Rule[] = [\n  // A) Legacy SSE (GET SSE without session) → requires legacy enabled\n  {\n    care: CH_MASK | B_HAS_SESSION | B_LEGACY_EN,\n    match: CH_GET_SSE | B_LEGACY_EN, // HAS_SESSION must be 0; it's in 'care' but not in 'match'\n    outcome: { intent: 'legacy-sse', reason: 'GET SSE without Mcp-Session-Id → legacy SSE.' },\n  },\n  {\n    care: CH_MASK | B_HAS_SESSION | B_LEGACY_EN,\n    match: CH_GET_SSE /* legacy disabled; HAS_SESSION=0 */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'Legacy SSE disabled.',\n      recommendation: { httpStatus: 405, message: 'Legacy SSE disabled' },\n    },\n  },\n\n  // B) Legacy SSE: POST /message WITH session id\n  {\n    care: CH_MASK | B_HAS_SESSION | B_LEGACY_EN,\n    match: CH_POST_MESSAGE | B_HAS_SESSION | B_LEGACY_EN,\n    outcome: { intent: 'legacy-sse', reason: 'POST /message with Mcp-Session-Id → legacy SSE bridge.' },\n  },\n  {\n    care: CH_MASK | B_HAS_SESSION | B_LEGACY_EN,\n    match: CH_POST_MESSAGE | B_HAS_SESSION /* legacy disabled */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'Legacy /message endpoint disabled.',\n      recommendation: { httpStatus: 405, message: 'Legacy SSE disabled' },\n    },\n  },\n\n  // C) Modern SSE (GET SSE with session) → requires SSE listener enabled\n  {\n    care: CH_MASK | B_SSE_LISTENER_EN | B_HAS_SESSION,\n    match: CH_GET_SSE | B_HAS_SESSION /* listener disabled */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'SSE listener disabled.',\n      recommendation: { httpStatus: 405, message: 'SSE listener disabled' },\n    },\n  },\n  {\n    care: CH_MASK | B_SSE_LISTENER_EN | B_HAS_SESSION,\n    match: CH_GET_SSE | B_SSE_LISTENER_EN | B_HAS_SESSION,\n    outcome: { intent: 'sse', reason: 'GET SSE with Mcp-Session-Id.' },\n  },\n\n  // D) Initialize (POST → SSE)\n  {\n    care: CH_MASK | B_STREAMABLE_EN,\n    match: CH_POST_INIT_SSE /* streamable disabled */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'Streamable HTTP disabled.',\n      recommendation: { httpStatus: 405, message: 'Streamable HTTP disabled' },\n    },\n  },\n  {\n    care: CH_MASK | B_STREAMABLE_EN,\n    match: CH_POST_INIT_SSE | B_STREAMABLE_EN,\n    outcome: { intent: 'streamable-http', reason: 'Initialize with SSE.' },\n  },\n\n  // E) Initialize (POST → JSON)\n  {\n    care: CH_MASK | B_STREAMABLE_EN,\n    match: CH_POST_INIT_JSON /* streamable disabled */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'JSON mode disabled.',\n      recommendation: { httpStatus: 405, message: 'JSON mode disabled' },\n    },\n  },\n  {\n    care: CH_MASK | B_STREAMABLE_EN,\n    match: CH_POST_INIT_JSON | B_STREAMABLE_EN,\n    outcome: { intent: 'stateful-http', reason: 'Initialize with JSON.' },\n  },\n\n  // F) POST non-init → SSE\n  {\n    care: CH_MASK | B_REQ_SESSION | B_HAS_SESSION | B_STATELESS_EN,\n    match: CH_POST_SSE | B_REQ_SESSION /* !HAS_SESSION & !STATELESS_EN */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'POST SSE requires session.',\n      recommendation: { httpStatus: 400, message: 'Initialize required (no Mcp-Session-Id)' },\n    },\n  },\n  {\n    care: CH_MASK | B_STREAMABLE_EN,\n    match: CH_POST_SSE /* streamable disabled */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'Streamable HTTP disabled.',\n      recommendation: { httpStatus: 405, message: 'Streamable HTTP disabled' },\n    },\n  },\n  {\n    care: CH_MASK | B_HAS_SESSION | B_STATELESS_EN,\n    match: CH_POST_SSE | B_STATELESS_EN /* no session */,\n    outcome: { intent: 'stateless-http', reason: 'Stateless short-lived SSE.' },\n  },\n  {\n    care: CH_MASK,\n    match: CH_POST_SSE,\n    outcome: { intent: 'streamable-http', reason: 'Short-lived SSE for this request.' },\n  },\n\n  // G) POST non-init → JSON\n  {\n    care: CH_MASK | B_REQ_SESSION | B_HAS_SESSION | B_STATELESS_EN,\n    match: CH_POST_JSON | B_REQ_SESSION /* !HAS_SESSION & !STATELESS_EN */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'POST JSON requires session.',\n      recommendation: { httpStatus: 400, message: 'Initialize required (no Mcp-Session-Id)' },\n    },\n  },\n  {\n    care: CH_MASK | B_STATEFUL_EN | B_STREAMABLE_EN,\n    match: CH_POST_JSON /* neither enabled */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'JSON mode disabled.',\n      recommendation: { httpStatus: 405, message: 'JSON mode disabled' },\n    },\n  },\n  {\n    care: CH_MASK | B_HAS_SESSION | B_STATELESS_EN,\n    match: CH_POST_JSON | B_STATELESS_EN /* no session */,\n    outcome: { intent: 'stateless-http', reason: 'Stateless JSON request.' },\n  },\n  {\n    care: CH_MASK,\n    match: CH_POST_JSON,\n    outcome: { intent: 'stateful-http', reason: 'Aggregated JSON response.' },\n  },\n\n  // H) Fallback\n  {\n    care: CH_MASK,\n    match: CH_OTHER,\n    outcome: {\n      intent: 'unknown',\n      reason: 'Method/Accept not allowed.',\n      recommendation: { httpStatus: 405, message: 'Method/Accept not allowed' },\n    },\n  },\n];\n\n// --- Public API --------------------------------------------------------------\n\nexport function decideIntent(req: ServerRequest, cfg: Config): Decision {\n  const reasons: string[] = [];\n  const { key, channel, flags, init } = computeBitmap(req, cfg);\n\n  // Optional strict Accept validation for POST (incl. /message)\n  if (req.method.toUpperCase() === 'POST') {\n    const accept = h(req, 'accept');\n    const acceptsSSE = wantsSSE(accept);\n    const acceptsJSON = wantsJSON(accept) || (!accept && cfg.tolerateMissingAccept);\n    if (!acceptsSSE && !acceptsJSON) {\n      return {\n        intent: 'unknown',\n        reasons: ['Client must accept application/json or text/event-stream.'],\n        recommendation: { httpStatus: 406, message: 'Not acceptable' },\n        debug: { key, channel, flags },\n      };\n    }\n  }\n\n  for (const rule of RULES) {\n    if ((key & rule.care) === rule.match) {\n      const { reason, ...rest } = rule.outcome;\n      reasons.push(reason);\n      if (init) reasons.push('Initialize body detected.');\n      return { ...rest, reasons, debug: { key, channel, flags } };\n    }\n  }\n\n  return {\n    intent: 'unknown',\n    reasons: ['No matching rule.'],\n    recommendation: { httpStatus: 500, message: 'Unroutable request' },\n    debug: { key, channel, flags },\n  };\n}"]}
+{"version":3,"file":"decide-request-intent.utils.js","sourceRoot":"","sources":["../../../../src/common/utils/decide-request-intent.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { ServerRequest } from '../interfaces';\n\n/* --------------------------------- Schemas --------------------------------- */\n\nexport const intentSchema = z.union([\n  z.literal('legacy-sse'),\n  z.literal('sse'),\n  z.literal('streamable-http'),\n  z.literal('stateful-http'),\n  z.literal('stateless-http'),\n  z.literal('delete-session'),\n  z.literal('unknown'),\n]);\n\nexport const decisionSchema = z.object({\n  intent: intentSchema,\n  reasons: z.array(z.string()),\n  recommendation: z\n    .object({\n      httpStatus: z.number(),\n      message: z.string(),\n    })\n    .optional(),\n  // Echo back bits for debugging/telemetry if you like\n  debug: z\n    .object({\n      key: z.number(),\n      channel: z.number(),\n      flags: z.number(),\n    })\n    .optional(),\n});\n\nexport type HttpRequestIntent =\n  | 'legacy-sse'\n  | 'sse'\n  | 'streamable-http'\n  | 'stateful-http'\n  | 'stateless-http'\n  | 'delete-session';\n\nexport type Intent = HttpRequestIntent | 'unknown';\n\nexport type Decision = {\n  intent: Intent;\n  reasons: string[];\n  recommendation?: { httpStatus: number; message: string };\n  // Echo back bits for debugging/telemetry if you like\n  debug?: { key: number; channel: number; flags: number };\n};\n\nexport interface Config {\n  enableLegacySSE: boolean;\n  enableSseListener: boolean;\n  enableStreamableHttp: boolean;\n  enableStatefulHttp: boolean;\n  enableStatelessHttp: boolean;\n  requireSessionForStreamable: boolean;\n  tolerateMissingAccept: boolean;\n}\n\n/* ------------------------------- Bit layout ---------------------------------\n\nbits 0..2  CHANNEL\n           000 OTHER\n           001 GET_SSE                 (GET + Accept: text/event-stream)\n           010 POST_INIT_JSON          (POST initialize + Accept: application/json or default JSON)\n           011 POST_INIT_SSE           (POST initialize + Accept: text/event-stream)\n           100 POST_JSON               (POST non-init + Accept: application/json or default JSON)\n           101 POST_SSE                (POST non-init + Accept: text/event-stream)\n           110 POST_MESSAGE            (POST to /message)  ← legacy bridge\n\nbit 3      HAS_SESSION                 (Mcp-Session-Id present)\nbit 4      STATELESS_EN                (config: enableStatelessHttp)\nbit 5      REQ_SESSION                 (config: requireSessionForStreamable)\nbit 6      LEGACY_HINT                 (x-legacy-sse=true OR session.transportType=legacy-sse)\nbit 7      SSE_LISTENER_EN             (config: enableSseListener)\nbit 8      STREAMABLE_EN               (config: enableStreamableHttp)\nbit 9      STATEFUL_EN                 (config: enableStatefulHttp)\nbit 10     LEGACY_EN                   (config: enableLegacySSE)\n\n----------------------------------------------------------------------------- */\n\n// --- Channels ---------------------------------------------------------------\n\nconst CH_OTHER = 0b000;\nconst CH_GET_SSE = 0b001; // GET / + SSE (not handled, forward to next middleware)\nconst CH_POST_INIT_JSON = 0b010;\nconst CH_POST_INIT_SSE = 0b011;\nconst CH_POST_JSON = 0b100;\nconst CH_POST_SSE = 0b101;\nconst CH_POST_MESSAGE = 0b110; // POST /message (legacy bridge)\nconst CH_GET_SSE_PATH = 0b111; // GET /sse path (legacy SSE initialize)\n\nconst CH_MASK = 0b00000111;\n\n// --- Flags ------------------------------------------------------------------\n\nconst B_HAS_SESSION = 1 << 3; // 8\nconst B_STATELESS_EN = 1 << 4; // 16\nconst B_REQ_SESSION = 1 << 5; // 32\nconst B_LEGACY_HINT = 1 << 6; // 64 (kept for telemetry; not required by merged rules)\nconst B_SSE_LISTENER_EN = 1 << 7; // 128\nconst B_STREAMABLE_EN = 1 << 8; // 256\nconst B_STATEFUL_EN = 1 << 9; // 512\nconst B_LEGACY_EN = 1 << 10; // 1024\n\n// --- Minimal helpers ---------------------------------------------------------\n\nconst h = (req: ServerRequest, name: string) =>\n  Object.entries(req.headers).find(([k]) => k.toLowerCase() === name.toLowerCase())?.[1];\n\nconst wantsSSE = (accept?: string) => (accept ?? '').toLowerCase().includes('text/event-stream');\nconst wantsJSON = (accept?: string) => (accept ?? '').toLowerCase().includes('application/json');\nconst isInitialize = (body: unknown) => !!body && typeof body === 'object' && (body as any).method === 'initialize';\n\n// Robust path extractor (supports absolute/relative)\nfunction pathOf(req: ServerRequest): string {\n  const anyReq = req as any;\n  const raw = anyReq.path ?? anyReq.pathname ?? anyReq.url ?? '/';\n  try {\n    const u = new URL(String(raw), 'http://local');\n    return u.pathname || '/';\n  } catch {\n    return String(raw).split('?')[0] || '/';\n  }\n}\n\n// Check if path is the legacy SSE path (/sse)\nfunction isLegacySsePath(path: string): boolean {\n  return path === '/sse' || path.endsWith('/sse');\n}\n\n/** Optionally extract transportType from base64 JSON session id, if you embed it. */\nfunction tryDecodeTransportType(sessionId?: string): string | undefined {\n  if (!sessionId) return;\n  try {\n    const b64 = sessionId.replace(/-/g, '+').replace(/_/g, '/');\n    const obj = JSON.parse(Buffer.from(b64, 'base64').toString('utf8'));\n    return obj?.transportType;\n  } catch {\n    return;\n  }\n}\n\n// --- Build the 11-bit key ----------------------------------------------------\n\nfunction computeBitmap(req: ServerRequest, cfg: Config) {\n  const method = req.method.toUpperCase();\n  const accept = h(req, 'accept');\n  const sessionId = h(req, 'mcp-session-id');\n  const legacyHeader = h(req, 'x-legacy-sse') === 'true';\n  const transportType = tryDecodeTransportType(sessionId);\n  const path = pathOf(req);\n\n  const acceptSSE = wantsSSE(accept);\n  const acceptJSON = wantsJSON(accept) || (!accept && cfg.tolerateMissingAccept);\n  const init = method === 'POST' && isInitialize(req.body);\n  const postToMessage = method === 'POST' && (path === '/message' || path.endsWith('/message'));\n  const getToSsePath = method === 'GET' && isLegacySsePath(path);\n\n  const channel =\n    method === 'POST' && postToMessage\n      ? CH_POST_MESSAGE\n      : getToSsePath && acceptSSE\n      ? CH_GET_SSE_PATH // GET /sse → legacy SSE channel\n      : method === 'GET' && acceptSSE\n      ? CH_GET_SSE // GET / + SSE → forward to next middleware (unknown)\n      : method === 'POST' && init && acceptSSE\n      ? CH_POST_INIT_SSE\n      : method === 'POST' && init && acceptJSON\n      ? CH_POST_INIT_JSON\n      : method === 'POST' && !init && acceptSSE\n      ? CH_POST_SSE\n      : method === 'POST' && !init && acceptJSON\n      ? CH_POST_JSON\n      : CH_OTHER;\n\n  let flags = 0;\n  if (sessionId) flags |= B_HAS_SESSION;\n  if (cfg.enableStatelessHttp) flags |= B_STATELESS_EN;\n  if (cfg.requireSessionForStreamable) flags |= B_REQ_SESSION;\n  if (legacyHeader || transportType === 'legacy-sse') flags |= B_LEGACY_HINT; // informational\n  if (cfg.enableSseListener) flags |= B_SSE_LISTENER_EN;\n  if (cfg.enableStreamableHttp) flags |= B_STREAMABLE_EN;\n  if (cfg.enableStatefulHttp) flags |= B_STATEFUL_EN;\n  if (cfg.enableLegacySSE) flags |= B_LEGACY_EN;\n\n  return { key: (channel & CH_MASK) | flags, channel, flags, init };\n}\n\n// --- Rule definition ---------------------------------------------------------\n\ntype Rule = {\n  care: number; // which bits matter\n  match: number; // the exact bit pattern to match (after masking)\n  outcome: Omit<Decision, 'reasons' | 'debug'> & { reason: string };\n};\n\n// --- Rules (merged semantics) -----------------------------------------------\n\nconst RULES: Rule[] = [\n  // A) Legacy SSE via GET /sse path (without session) → requires legacy enabled\n  {\n    care: CH_MASK | B_HAS_SESSION | B_LEGACY_EN,\n    match: CH_GET_SSE_PATH | B_LEGACY_EN, // HAS_SESSION must be 0; it's in 'care' but not in 'match'\n    outcome: { intent: 'legacy-sse', reason: 'GET /sse without Mcp-Session-Id → legacy SSE.' },\n  },\n  {\n    care: CH_MASK | B_HAS_SESSION | B_LEGACY_EN,\n    match: CH_GET_SSE_PATH /* legacy disabled; HAS_SESSION=0 */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'Legacy SSE disabled.',\n      recommendation: { httpStatus: 405, message: 'Legacy SSE disabled' },\n    },\n  },\n\n  // A2) GET / + SSE (not /sse path) with session ID → SSE listener for streamable-http\n  // Per MCP 2025-11-25 spec, clients can open SSE stream via GET with session ID\n  {\n    care: CH_MASK | B_HAS_SESSION | B_SSE_LISTENER_EN | B_STREAMABLE_EN,\n    match: CH_GET_SSE | B_HAS_SESSION | B_SSE_LISTENER_EN | B_STREAMABLE_EN,\n    outcome: { intent: 'streamable-http', reason: 'GET / with session ID → SSE listener for streamable-http.' },\n  },\n  // A2b) GET / + SSE with session but listener/streamable disabled\n  {\n    care: CH_MASK | B_HAS_SESSION | B_SSE_LISTENER_EN,\n    match: CH_GET_SSE | B_HAS_SESSION /* listener disabled */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'SSE listener disabled for GET / requests.',\n      recommendation: { httpStatus: 405, message: 'SSE listener disabled' },\n    },\n  },\n  // A2c) GET / + SSE without session → forward to next middleware\n  {\n    care: CH_MASK | B_HAS_SESSION,\n    match: CH_GET_SSE /* no session */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'GET / with SSE requires session for MCP transport.',\n    },\n  },\n\n  // B) Legacy SSE: POST /message WITH session id\n  {\n    care: CH_MASK | B_HAS_SESSION | B_LEGACY_EN,\n    match: CH_POST_MESSAGE | B_HAS_SESSION | B_LEGACY_EN,\n    outcome: { intent: 'legacy-sse', reason: 'POST /message with Mcp-Session-Id → legacy SSE bridge.' },\n  },\n  {\n    care: CH_MASK | B_HAS_SESSION | B_LEGACY_EN,\n    match: CH_POST_MESSAGE | B_HAS_SESSION /* legacy disabled */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'Legacy /message endpoint disabled.',\n      recommendation: { httpStatus: 405, message: 'Legacy SSE disabled' },\n    },\n  },\n\n  // C) Modern SSE (GET /sse with session) → requires SSE listener enabled\n  {\n    care: CH_MASK | B_SSE_LISTENER_EN | B_HAS_SESSION,\n    match: CH_GET_SSE_PATH | B_HAS_SESSION /* listener disabled */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'SSE listener disabled.',\n      recommendation: { httpStatus: 405, message: 'SSE listener disabled' },\n    },\n  },\n  {\n    care: CH_MASK | B_SSE_LISTENER_EN | B_HAS_SESSION,\n    match: CH_GET_SSE_PATH | B_SSE_LISTENER_EN | B_HAS_SESSION,\n    outcome: { intent: 'sse', reason: 'GET /sse with Mcp-Session-Id.' },\n  },\n\n  // D) Initialize (POST → SSE)\n  // D1) Stateless initialize (no session, stateless enabled) - must come before streamable rules\n  {\n    care: CH_MASK | B_HAS_SESSION | B_STATELESS_EN,\n    match: CH_POST_INIT_SSE | B_STATELESS_EN /* no session */,\n    outcome: { intent: 'stateless-http', reason: 'Stateless initialize (no session).' },\n  },\n  {\n    care: CH_MASK | B_STREAMABLE_EN,\n    match: CH_POST_INIT_SSE /* streamable disabled */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'Streamable HTTP disabled.',\n      recommendation: { httpStatus: 405, message: 'Streamable HTTP disabled' },\n    },\n  },\n  {\n    care: CH_MASK | B_STREAMABLE_EN,\n    match: CH_POST_INIT_SSE | B_STREAMABLE_EN,\n    outcome: { intent: 'streamable-http', reason: 'Initialize with SSE.' },\n  },\n\n  // E) Initialize (POST → JSON)\n  // E1) Stateless initialize JSON (no session, stateless enabled) - must come before stateful rules\n  {\n    care: CH_MASK | B_HAS_SESSION | B_STATELESS_EN,\n    match: CH_POST_INIT_JSON | B_STATELESS_EN /* no session */,\n    outcome: { intent: 'stateless-http', reason: 'Stateless initialize JSON (no session).' },\n  },\n  {\n    care: CH_MASK | B_STREAMABLE_EN,\n    match: CH_POST_INIT_JSON /* streamable disabled */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'JSON mode disabled.',\n      recommendation: { httpStatus: 405, message: 'JSON mode disabled' },\n    },\n  },\n  {\n    care: CH_MASK | B_STREAMABLE_EN,\n    match: CH_POST_INIT_JSON | B_STREAMABLE_EN,\n    outcome: { intent: 'stateful-http', reason: 'Initialize with JSON.' },\n  },\n\n  // F) POST non-init → SSE\n  {\n    care: CH_MASK | B_REQ_SESSION | B_HAS_SESSION | B_STATELESS_EN,\n    match: CH_POST_SSE | B_REQ_SESSION /* !HAS_SESSION & !STATELESS_EN */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'POST SSE requires session.',\n      recommendation: { httpStatus: 400, message: 'Initialize required (no Mcp-Session-Id)' },\n    },\n  },\n  {\n    care: CH_MASK | B_STREAMABLE_EN,\n    match: CH_POST_SSE /* streamable disabled */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'Streamable HTTP disabled.',\n      recommendation: { httpStatus: 405, message: 'Streamable HTTP disabled' },\n    },\n  },\n  {\n    care: CH_MASK | B_HAS_SESSION | B_STATELESS_EN,\n    match: CH_POST_SSE | B_STATELESS_EN /* no session */,\n    outcome: { intent: 'stateless-http', reason: 'Stateless short-lived SSE.' },\n  },\n  {\n    care: CH_MASK,\n    match: CH_POST_SSE,\n    outcome: { intent: 'streamable-http', reason: 'Short-lived SSE for this request.' },\n  },\n\n  // G) POST non-init → JSON\n  {\n    care: CH_MASK | B_REQ_SESSION | B_HAS_SESSION | B_STATELESS_EN,\n    match: CH_POST_JSON | B_REQ_SESSION /* !HAS_SESSION & !STATELESS_EN */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'POST JSON requires session.',\n      recommendation: { httpStatus: 400, message: 'Initialize required (no Mcp-Session-Id)' },\n    },\n  },\n  {\n    care: CH_MASK | B_STATEFUL_EN | B_STREAMABLE_EN,\n    match: CH_POST_JSON /* neither enabled */,\n    outcome: {\n      intent: 'unknown',\n      reason: 'JSON mode disabled.',\n      recommendation: { httpStatus: 405, message: 'JSON mode disabled' },\n    },\n  },\n  {\n    care: CH_MASK | B_HAS_SESSION | B_STATELESS_EN,\n    match: CH_POST_JSON | B_STATELESS_EN /* no session */,\n    outcome: { intent: 'stateless-http', reason: 'Stateless JSON request.' },\n  },\n  {\n    care: CH_MASK,\n    match: CH_POST_JSON,\n    outcome: { intent: 'stateful-http', reason: 'Aggregated JSON response.' },\n  },\n\n  // H) Fallback\n  {\n    care: CH_MASK,\n    match: CH_OTHER,\n    outcome: {\n      intent: 'unknown',\n      reason: 'Method/Accept not allowed.',\n      recommendation: { httpStatus: 405, message: 'Method/Accept not allowed' },\n    },\n  },\n];\n\n// --- Public API --------------------------------------------------------------\n\nexport function decideIntent(req: ServerRequest, cfg: Config): Decision {\n  const reasons: string[] = [];\n  const method = req.method.toUpperCase();\n\n  // Handle HTTP DELETE for session termination (MCP 2025-11-25 spec)\n  if (method === 'DELETE') {\n    const sessionId = h(req, 'mcp-session-id');\n    if (!sessionId) {\n      return {\n        intent: 'unknown',\n        reasons: ['DELETE requires Mcp-Session-Id header.'],\n        recommendation: { httpStatus: 400, message: 'Session ID required for DELETE' },\n        debug: { key: 0, channel: 0, flags: 0 },\n      };\n    }\n    return {\n      intent: 'delete-session',\n      reasons: ['DELETE with Mcp-Session-Id → session termination.'],\n      debug: { key: 0, channel: 0, flags: sessionId ? B_HAS_SESSION : 0 },\n    };\n  }\n\n  const { key, channel, flags, init } = computeBitmap(req, cfg);\n\n  // Optional strict Accept validation for POST (incl. /message)\n  if (method === 'POST') {\n    const accept = h(req, 'accept');\n    const acceptsSSE = wantsSSE(accept);\n    const acceptsJSON = wantsJSON(accept) || (!accept && cfg.tolerateMissingAccept);\n    if (!acceptsSSE && !acceptsJSON) {\n      return {\n        intent: 'unknown',\n        reasons: ['Client must accept application/json or text/event-stream.'],\n        recommendation: { httpStatus: 406, message: 'Not acceptable' },\n        debug: { key, channel, flags },\n      };\n    }\n  }\n\n  for (const rule of RULES) {\n    if ((key & rule.care) === rule.match) {\n      const { reason, ...rest } = rule.outcome;\n      reasons.push(reason);\n      if (init) reasons.push('Initialize body detected.');\n      return { ...rest, reasons, debug: { key, channel, flags } };\n    }\n  }\n\n  return {\n    intent: 'unknown',\n    reasons: ['No matching rule.'],\n    recommendation: { httpStatus: 500, message: 'Unroutable request' },\n    debug: { key, channel, flags },\n  };\n}\n"]}

package/src/completion/flows/complete.flow.d.ts

@@ -0,0 +1,74 @@
+import { FlowBase, FlowRunOptions } from '../../common';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    request: z.ZodObject<{
+        method: z.ZodLiteral<"completion/complete">;
+        params: z.ZodObject<{
+            _meta: z.ZodOptional<z.ZodObject<{
+                progressToken: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            }, z.core.$loose>>;
+            ref: z.ZodUnion<readonly [z.ZodObject<{
+                type: z.ZodLiteral<"ref/prompt">;
+                name: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"ref/resource">;
+                uri: z.ZodString;
+            }, z.core.$strip>]>;
+            argument: z.ZodObject<{
+                name: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strip>;
+            context: z.ZodOptional<z.ZodObject<{
+                arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, z.core.$strip>>;
+        }, z.core.$loose>;
+    }, z.core.$strip>;
+    ctx: z.ZodUnknown;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodObject<{
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    completion: z.ZodObject<{
+        values: z.ZodArray<z.ZodString>;
+        total: z.ZodOptional<z.ZodNumber>;
+        hasMore: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>;
+}, z.core.$loose>;
+declare const stateSchema: z.ZodObject<{
+    ref: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"ref/prompt">;
+        name: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"ref/resource">;
+        uri: z.ZodString;
+    }, z.core.$strip>], "type">;
+    argument: z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>;
+    output: z.ZodObject<{
+        _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        completion: z.ZodObject<{
+            values: z.ZodArray<z.ZodString>;
+            total: z.ZodOptional<z.ZodNumber>;
+            hasMore: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+declare const plan: {
+    readonly pre: ["parseInput"];
+    readonly execute: ["complete"];
+    readonly finalize: ["finalize"];
+};
+declare global {
+    interface ExtendFlows {
+        'completion:complete': FlowRunOptions<CompleteFlow, typeof plan, typeof inputSchema, typeof outputSchema, typeof stateSchema>;
+    }
+}
+declare const name: "completion:complete";
+export default class CompleteFlow extends FlowBase<typeof name> {
+    logger: import("../../common").FrontMcpLogger;
+    parseInput(): Promise<void>;
+    complete(): Promise<void>;
+    finalize(): Promise<void>;
+}
+export {};

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

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

@@ -0,0 +1 @@
+{"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"]}