@introspection-ai/recipes 0.18.0 → 0.19.0

package/dist/mcp-chunks/{chunk-7KA2VJVZ.js → chunk-NCXEJ35U.js}

@@ -4,12 +4,12 @@ import {
   extraDimText,
   redText,
   yellowText
-} from "./chunk-N46NEFAF.js";
+} from "./chunk-XUF6KARU.js";
 import {
   analyzeConnectionError
-} from "./chunk-UKYNQGNE.js";
+} from "./chunk-DEUU7WSN.js";
 
-// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/cli/path-utils.js
+// node_modules/.pnpm/mcporter@0.13.0/node_modules/mcporter/dist/cli/path-utils.js
 import os from "node:os";
 import path from "node:path";
 function formatPathForDisplay(filePath) {
@@ -19,7 +19,7 @@ function formatPathForDisplay(filePath) {
   return displayPath;
 }
 
-// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/cli/list-format.js
+// node_modules/.pnpm/mcporter@0.13.0/node_modules/mcporter/dist/cli/list-format.js
 function renderServerListRow(result, timeoutMs, options = {}) {
   const description = result.server.description ? dimText(` \u2014 ${result.server.description}`) : "";
   const durationLabel = dimText(`${(result.durationMs / 1e3).toFixed(1)}s`);
@@ -30,7 +30,7 @@ function renderServerListRow(result, timeoutMs, options = {}) {
   if (result.status === "ok") {
     const toolSuffix = result.tools.length === 0 ? "no tools reported" : `${result.tools.length === 1 ? "1 tool" : `${result.tools.length} tools`}`;
     return {
-      line: `${prefix} (${toolSuffix}, ${durationLabel})${sourceSuffix}`,
+      line: `${prefix} (${toolSuffix}, ${durationLabel}${formatProtocolSuffix(result.connectionInfo, options.verbose)})${sourceSuffix}`,
       summary: toolSuffix,
       category: "ok"
     };
@@ -45,6 +45,11 @@ function renderServerListRow(result, timeoutMs, options = {}) {
     issue: advice.issue
   };
 }
+function formatProtocolSuffix(info, verbose) {
+  if (!verbose || !info?.protocolVersion)
+    return "";
+  return `, ${info.protocolVersion}${info.era ? ` ${info.era}` : ""}`;
+}
 function formatSourceSuffix(sourceOrSources, inline = false, options = {}) {
   const sources = Array.isArray(sourceOrSources) ? [...sourceOrSources] : sourceOrSources ? [sourceOrSources] : [];
   if (sources.length === 0) {

package/dist/mcp-chunks/{chunk-5QOSCSQB.js → chunk-NZOIX6XW.js}

@@ -1,9 +1,9 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 import {
   analyzeConnectionError
-} from "./chunk-UKYNQGNE.js";
+} from "./chunk-DEUU7WSN.js";
 
-// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/result-utils.js
+// node_modules/.pnpm/mcporter@0.13.0/node_modules/mcporter/dist/result-utils.js
 function extractEnvelope(raw) {
   return collectEnvelopeFields(raw, { content: null, structuredContent: null }, 0);
 }

package/dist/mcp-chunks/{chunk-XANPGTLI.js → chunk-P3RN22HQ.js}

@@ -1,6 +1,6 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 
-// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/cli/generate/tools.js
+// node_modules/.pnpm/mcporter@0.13.0/node_modules/mcporter/dist/cli/generate/tools.js
 function resolveSchemaType(value) {
   if (value === "integer") {
     return "number";
@@ -34,14 +34,21 @@ function buildToolMetadataList(tools, options = {}) {
     result.sort((left, right) => left.tool.name.localeCompare(right.tool.name));
   }
   const methods = /* @__PURE__ */ new Map();
+  const kept = [];
   for (const entry of result) {
     const previous = methods.get(entry.methodName);
-    if (previous) {
-      throw new Error(`Generated proxy method collision '${entry.methodName}' for tools '${previous}' and '${entry.tool.name}'.`);
+    if (previous !== void 0) {
+      if (previous === entry.tool.name)
+        continue;
+      if (options.onCollision !== "skip") {
+        throw new Error(`Generated proxy method collision '${entry.methodName}' for tools '${previous}' and '${entry.tool.name}'.`);
+      }
+      continue;
     }
     methods.set(entry.methodName, entry.tool.name);
+    kept.push(entry);
   }
-  return result;
+  return kept;
 }
 function buildEmbeddedSchemaMap(tools) {
   const result = {};

package/dist/mcp-chunks/{chunk-IABRYROW.js → chunk-PKOJCYNA.js}

@@ -1,9 +1,9 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 import {
   buildToolMetadataList
-} from "./chunk-XANPGTLI.js";
+} from "./chunk-P3RN22HQ.js";
 
-// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/cli/tool-cache.js
+// node_modules/.pnpm/mcporter@0.13.0/node_modules/mcporter/dist/cli/tool-cache.js
 var runtimeCache = /* @__PURE__ */ new WeakMap();
 function cacheKey(serverName, options) {
   const includeSchema = options.includeSchema !== false;
@@ -31,7 +31,7 @@ async function loadToolMetadata(runtime, serverName, options = {}) {
     allowCachedAuth: options.allowCachedAuth ?? true,
     disableOAuth: options.disableOAuth
   };
-  const promise = runtime.listTools(serverName, listOptions).then((tools) => buildToolMetadataList(tools, { sort: false })).catch((error) => {
+  const promise = runtime.listTools(serverName, listOptions).then((tools) => buildToolMetadataList(tools, { sort: false, onCollision: "skip" })).catch((error) => {
     cache?.delete(key);
     throw error;
   });

package/dist/mcp-chunks/{chunk-BNV3TPE4.js → chunk-QJACOI2W.js}

@@ -1,6 +1,9 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
+import {
+  raceWithTimeout
+} from "./chunk-ETWN4IIA.js";
 
-// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/cli/timeouts.js
+// node_modules/.pnpm/mcporter@0.13.0/node_modules/mcporter/dist/cli/timeouts.js
 var DEFAULT_LIST_TIMEOUT_MS = 3e4;
 var DEFAULT_CALL_TIMEOUT_MS = 6e4;
 var POSITIVE_INTEGER_PATTERN = /^[1-9]\d*$/;
@@ -28,18 +31,7 @@ function withTimeout(promise, timeoutMs) {
   if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
     return promise;
   }
-  return new Promise((resolve, reject) => {
-    const timer = setTimeout(() => {
-      reject(new Error("Timeout"));
-    }, timeoutMs);
-    promise.then((value) => {
-      clearTimeout(timer);
-      resolve(value);
-    }, (error) => {
-      clearTimeout(timer);
-      reject(error);
-    });
-  });
+  return raceWithTimeout(promise, timeoutMs);
 }
 function consumeTimeoutFlag(args, index, options) {
   const flagName = options?.flagName ?? "--timeout";

package/dist/mcp-chunks/{chunk-UNKB4SBV.js → chunk-RBVYCKCD.js}

@@ -2,9 +2,9 @@ import { createRequire as __createRequire } from "node:module"; const require =
 import {
   createPrefixedConsoleLogger,
   resolveLogLevelFromEnv
-} from "./chunk-6W5QFASN.js";
+} from "./chunk-GFYTST6N.js";
 
-// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/cli/logger-context.js
+// node_modules/.pnpm/mcporter@0.13.0/node_modules/mcporter/dist/cli/logger-context.js
 var activeLogLevel = resolveLogLevelFromEnv();
 var activeLogger = createPrefixedConsoleLogger("mcporter", activeLogLevel);
 function getActiveLogLevel() {

package/dist/mcp-chunks/{chunk-DHBE7UBH.js → chunk-SB2UUURE.js}

@@ -1,18 +1,21 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 import {
   buildToolDoc
-} from "./chunk-MZ2NARG7.js";
+} from "./chunk-54EWGONA.js";
 import {
   buildEmbeddedSchemaMap
-} from "./chunk-XANPGTLI.js";
+} from "./chunk-P3RN22HQ.js";
 import {
   parsePositiveInteger
-} from "./chunk-BNV3TPE4.js";
+} from "./chunk-QJACOI2W.js";
+import {
+  stableJsonStringify
+} from "./chunk-UHOKCTZT.js";
 import {
   MCPORTER_VERSION
-} from "./chunk-4SQKWYFF.js";
+} from "./chunk-SFREPU3D.js";
 
-// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/cli/generate/flag-parser.js
+// node_modules/.pnpm/mcporter@0.13.0/node_modules/mcporter/dist/cli/generate/flag-parser.js
 function extractGeneratorFlags(args, options = {}) {
   const result = {};
   let index = 0;
@@ -54,12 +57,12 @@ function extractGeneratorFlags(args, options = {}) {
   return result;
 }
 
-// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/cli/generate/template.js
+// node_modules/.pnpm/mcporter@0.13.0/node_modules/mcporter/dist/cli/generate/template.js
 import { realpathSync } from "node:fs";
 import fs2 from "node:fs/promises";
 import path from "node:path";
 
-// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/cli/generate/fs-helpers.js
+// node_modules/.pnpm/mcporter@0.13.0/node_modules/mcporter/dist/cli/generate/fs-helpers.js
 import fs from "node:fs/promises";
 async function markExecutable(filePath) {
   try {
@@ -90,7 +93,7 @@ function shouldIgnorePosixPermissionError(error) {
   return code === "EPERM" || code === "EINVAL" || code === "ENOSYS" || code === "EACCES";
 }
 
-// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/cli/generate/template-help.js
+// node_modules/.pnpm/mcporter@0.13.0/node_modules/mcporter/dist/cli/generate/template-help.js
 function renderEmbeddedHelpSource() {
   return `function configureGeneratedCommandHelp(command: Command): void {
 	command.configureHelp({
@@ -204,39 +207,7 @@ function quickStartExamples(): Array<[string, string]> {
 `;
 }
 
-// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/cli/generate/stable-json.js
-function stableJsonStringify(value, space) {
-  const json = JSON.stringify(sortJsonValue(value), void 0, space);
-  if (json === void 0) {
-    throw new TypeError("Cannot serialize unsupported JSON root value.");
-  }
-  return json;
-}
-function sortJsonValue(value) {
-  if (Array.isArray(value)) {
-    return value.map((entry) => sortJsonValue(entry));
-  }
-  if (!isPlainObject(value)) {
-    return value;
-  }
-  const result = {};
-  for (const key of Object.keys(value).toSorted()) {
-    const entry = value[key];
-    if (entry !== void 0) {
-      result[key] = sortJsonValue(entry);
-    }
-  }
-  return result;
-}
-function isPlainObject(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const prototype = Object.getPrototypeOf(value);
-  return prototype === Object.prototype || prototype === null;
-}
-
-// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/cli/generate/template.js
+// node_modules/.pnpm/mcporter@0.13.0/node_modules/mcporter/dist/cli/generate/template.js
 async function writeTemplate(input) {
   const resolvedOutput = input.outputPath ? path.resolve(input.outputPath) : path.resolve(process.cwd(), `${input.serverName}.ts`);
   const runtimeScriptPath = input.runtimeScriptPath ? path.resolve(input.runtimeScriptPath) : resolvedOutput;
@@ -744,7 +715,6 @@ export {
   extractGeneratorFlags,
   markExecutable,
   safeCopyFile,
-  stableJsonStringify,
   writeTemplate,
   readPackageMetadata
 };

package/dist/mcp-chunks/{chunk-4SQKWYFF.js → chunk-SFREPU3D.js}

@@ -1,6 +1,6 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 
-// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/version.js
+// node_modules/.pnpm/mcporter@0.13.0/node_modules/mcporter/dist/version.js
 import { createRequire } from "node:module";
 var MCPORTER_VERSION = (() => {
   try {

package/dist/mcp-chunks/{chunk-BZIQOWE6.js → chunk-SRZZQ6TL.js}

@@ -1,31 +1,13 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 import {
-  analyzeConnectionError
-} from "./chunk-UKYNQGNE.js";
+  isUnauthorizedError
+} from "./chunk-7DH57OKF.js";
 import {
+  IssuerMismatchError,
   auth
-} from "./chunk-P3PSC54P.js";
+} from "./chunk-YPJ5EHXR.js";
 
-// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/runtime-oauth-support.js
-function maybeEnableOAuth(definition, logger) {
-  if (definition.auth === "oauth" || definition.auth === "refreshable_bearer") {
-    return void 0;
-  }
-  if (definition.command.kind !== "http") {
-    return void 0;
-  }
-  logger.info(`Detected OAuth requirement for '${definition.name}'. Launching browser flow...`);
-  return {
-    ...definition,
-    auth: "oauth"
-  };
-}
-function isUnauthorizedError(error) {
-  const issue = analyzeConnectionError(error);
-  return issue.kind === "auth";
-}
-
-// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/runtime/oauth.js
+// node_modules/.pnpm/mcporter@0.13.0/node_modules/mcporter/dist/runtime/oauth.js
 var DEFAULT_OAUTH_CODE_TIMEOUT_MS = 3e5;
 var OAUTH_FLOW_ERROR = /* @__PURE__ */ Symbol("oauth-flow-error");
 var POST_AUTH_CONNECT_ERROR = /* @__PURE__ */ Symbol("post-auth-connect-error");
@@ -108,7 +90,7 @@ async function connectWithAuth(client, transport, session, logger, options = {})
   };
   while (true) {
     try {
-      await attemptTransportConnect(client, state);
+      await attemptTransportConnect(client, state, options.signal);
       if (session && !state.hasCompletedAuthFlow && options.serverUrl) {
         await completeProactiveAuthorization(state.activeTransport, session, logger, {
           serverName,
@@ -154,8 +136,12 @@ async function connectWithAuth(client, transport, session, logger, options = {})
     }
   }
 }
-async function attemptTransportConnect(client, state) {
-  await client.connect(state.activeTransport);
+async function attemptTransportConnect(client, state, signal) {
+  if (signal) {
+    await client.connect(state.activeTransport, { signal });
+  } else {
+    await client.connect(state.activeTransport);
+  }
   return state.activeTransport;
 }
 function shouldRetryAuthorization(_state, unauthorized, session) {
@@ -175,12 +161,12 @@ async function completeAuthorizationChallenge(transport, session, logger, connec
   if (session.hasAuthorizationRedirectStarted?.() === false) {
     throw new OAuthAuthorizationNotStartedError(options.serverName ?? "unknown", connectError);
   }
-  const code = await waitForAuthorizationCodeWithTimeout(session, logger, options.serverName, options.oauthTimeoutMs ?? DEFAULT_OAUTH_CODE_TIMEOUT_MS);
+  const response = await waitForAuthorizationResponseWithTimeout(session, logger, options.serverName, options.oauthTimeoutMs ?? DEFAULT_OAUTH_CODE_TIMEOUT_MS);
   if (typeof transport.finishAuth !== "function") {
     logger.warn("Transport does not support finishAuth; cannot complete OAuth flow automatically.");
     throw connectError;
   }
-  await transport.finishAuth(code);
+  await finishAuthorization(transport, response, options.serverName);
   if (!options.recreateTransport) {
     return transport;
   }
@@ -214,17 +200,17 @@ async function completeProactiveAuthorization(transport, session, logger, option
     if (typeof transport.finishAuth !== "function") {
       throw new Error("Transport does not support finishAuth; cannot complete OAuth flow automatically.");
     }
-    const code = await waitForAuthorizationCodeWithTimeout(session, logger, options.serverName, options.oauthTimeoutMs ?? DEFAULT_OAUTH_CODE_TIMEOUT_MS);
-    await transport.finishAuth(code);
+    const response = await waitForAuthorizationResponseWithTimeout(session, logger, options.serverName, options.oauthTimeoutMs ?? DEFAULT_OAUTH_CODE_TIMEOUT_MS);
+    await finishAuthorization(transport, response, options.serverName);
     await session.close().catch(() => {
     });
   } catch (error) {
     throw markOAuthFlowError(error);
   }
 }
-function waitForAuthorizationCodeWithTimeout(session, logger, serverName, timeoutMs = DEFAULT_OAUTH_CODE_TIMEOUT_MS) {
+function waitForAuthorizationResponseWithTimeout(session, logger, serverName, timeoutMs = DEFAULT_OAUTH_CODE_TIMEOUT_MS) {
   if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
-    return session.waitForAuthorizationCode();
+    return readAuthorizationResponse(session);
   }
   const displayName = serverName ?? "unknown";
   return new Promise((resolve, reject) => {
@@ -233,15 +219,30 @@ function waitForAuthorizationCodeWithTimeout(session, logger, serverName, timeou
       logger.warn(error.message);
       reject(error);
     }, timeoutMs);
-    session.waitForAuthorizationCode().then((code) => {
+    readAuthorizationResponse(session).then((response) => {
       clearTimeout(timer);
-      resolve(code);
+      resolve(response);
     }, (error) => {
       clearTimeout(timer);
       reject(error);
     });
   });
 }
+async function readAuthorizationResponse(session) {
+  if (session.waitForAuthorizationResponse)
+    return session.waitForAuthorizationResponse();
+  return { code: await session.waitForAuthorizationCode() };
+}
+async function finishAuthorization(transport, response, serverName) {
+  try {
+    await transport.finishAuth?.(response.code, response.iss);
+  } catch (error) {
+    if (error instanceof IssuerMismatchError && error.kind === "authorization_response") {
+      throw new Error(`OAuth issuer validation failed for '${serverName ?? "unknown"}': expected ${JSON.stringify(error.expected)}, got ${JSON.stringify(error.received)}; the authorization code was not redeemed.`, { cause: error });
+    }
+    throw error;
+  }
+}
 function parseOAuthTimeout(raw) {
   if (!raw) {
     return DEFAULT_OAUTH_CODE_TIMEOUT_MS;
@@ -257,8 +258,6 @@ function resolveOAuthTimeoutFromEnv() {
 }
 
 export {
-  maybeEnableOAuth,
-  isUnauthorizedError,
   OAuthTimeoutError,
   isOAuthFlowError,
   isPostAuthConnectError,

package/dist/mcp-chunks/{chunk-M3TPODXI.js → chunk-UENXT3NE.js}

@@ -1,6 +1,6 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 
-// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/cli/http-utils.js
+// node_modules/.pnpm/mcporter@0.13.0/node_modules/mcporter/dist/cli/http-utils.js
 var DOMAIN_WITH_PATH_PATTERN = /^[A-Za-z0-9](?:[A-Za-z0-9.-]*)(?::\d+)?\//;
 function normalizeHttpUrlCandidate(value) {
   if (!value) {

package/dist/mcp-chunks/chunk-UHOKCTZT.js

@@ -0,0 +1,37 @@
+import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
+
+// node_modules/.pnpm/mcporter@0.13.0/node_modules/mcporter/dist/stable-json.js
+function stableJsonStringify(value, space) {
+  const json = JSON.stringify(sortJsonValue(value), void 0, space);
+  if (json === void 0) {
+    throw new TypeError("Cannot serialize unsupported JSON root value.");
+  }
+  return json;
+}
+function sortJsonValue(value) {
+  if (Array.isArray(value)) {
+    return value.map((entry) => sortJsonValue(entry));
+  }
+  if (!isPlainObject(value)) {
+    return value;
+  }
+  const result = {};
+  for (const key of Object.keys(value).toSorted()) {
+    const entry = value[key];
+    if (entry !== void 0) {
+      result[key] = sortJsonValue(entry);
+    }
+  }
+  return result;
+}
+function isPlainObject(value) {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}
+
+export {
+  stableJsonStringify
+};

package/dist/mcp-chunks/{chunk-E22DYOW5.js → chunk-WWO5WGH5.js}

@@ -1,20 +1,20 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 import {
   __configInternals
-} from "./chunk-2U4BSDC4.js";
+} from "./chunk-L4VKBFYI.js";
 import {
   withFileLock,
   writeTextFileAtomic
-} from "./chunk-2XL7MG7R.js";
+} from "./chunk-7A63PAGP.js";
 import {
   expandHome
-} from "./chunk-ECIVB7P4.js";
+} from "./chunk-HAO6PL7Z.js";
 import {
   canonicalKeepAliveName,
   resolveLifecycle
-} from "./chunk-LS7PMWSR.js";
+} from "./chunk-6D6KPSXN.js";
 
-// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/cli/adhoc-server.js
+// node_modules/.pnpm/mcporter@0.13.0/node_modules/mcporter/dist/cli/adhoc-server.js
 import fs from "node:fs/promises";
 import path from "node:path";
 var TEMP_SOURCE = { kind: "local", path: "<adhoc>" };