@introspection-ai/recipes 0.13.0 → 0.14.0

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

@@ -0,0 +1,400 @@
+import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
+import {
+  buildFallbackLiteral,
+  pickExampleLiteral
+} from "./chunk-XANPGTLI.js";
+import {
+  cyanText,
+  dimText,
+  extraDimText,
+  yellowText
+} from "./chunk-N46NEFAF.js";
+
+// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/cli/list-signature.js
+function formatFunctionSignature(name, options, outputSchema, formatOptions) {
+  const colorize = formatOptions?.colorize !== false;
+  const keyword = colorize ? extraDimText("function") : "function";
+  const formattedName = colorize ? cyanText(name) : name;
+  const paramsText = options.map((option) => formatInlineParameter(option, colorize)).join(", ");
+  const returnType = inferReturnTypeName(outputSchema) ?? formatOptions?.defaultReturnType;
+  const signature = `${keyword} ${formattedName}(${paramsText})`;
+  return returnType ? `${signature}: ${returnType};` : `${signature};`;
+}
+function formatOptionalSummary(hiddenOptions, options) {
+  const colorize = options?.colorize !== false;
+  const maxNames = 5;
+  const names = hiddenOptions.map((option) => option.property);
+  if (names.length === 0) {
+    return "";
+  }
+  const preview = names.slice(0, maxNames).join(", ");
+  const suffix = names.length > maxNames ? ", ..." : "";
+  const tint = colorize ? extraDimText : (value) => value;
+  return tint(`// optional (${names.length}): ${preview}${suffix}`);
+}
+function formatFlagUsage(options, extras, opts) {
+  const colorize = opts?.colorize !== false;
+  const entries = options.map((option) => ({
+    text: formatFlagLabel(option),
+    required: option.required
+  }));
+  if (extras) {
+    entries.push(...extras.map((extra) => ({
+      text: extra.text.trim(),
+      required: Boolean(extra.required)
+    })).filter((entry) => entry.text.length > 0));
+  }
+  const parts = entries.filter((entry) => entry.text.length > 0).map((entry) => entry.required ? entry.text : `[${entry.text}]`);
+  if (parts.length === 0) {
+    return "";
+  }
+  const rendered = parts.join(" ");
+  return colorize ? extraDimText(rendered) : rendered;
+}
+function formatFlagLabel(option) {
+  return `--${option.cliName} ${option.placeholder}`.trim();
+}
+function formatCallExpressionExample(serverName, toolName, options, extra) {
+  const assignments = options.map((option) => ({ option, literal: pickExampleLiteral(option) })).filter(({ option, literal }) => option.required || literal !== void 0).map(({ option, literal }) => {
+    const value = literal ?? buildFallbackLiteral(option);
+    return `${option.property}: ${value}`;
+  });
+  const args = assignments.join(", ");
+  const callSuffix = assignments.length > 0 ? `(${args})` : "()";
+  const selector = extra?.callSelector ?? serverName;
+  const expression = `${selector}.${toolName}${callSuffix}`;
+  const rendered = extra?.wrapExpression ? quoteShellExpression(expression) : expression;
+  return `mcporter call ${rendered}`;
+}
+function formatExampleBlock(examples, options) {
+  const maxExamples = options?.maxExamples ?? 1;
+  const maxLength = options?.maxLength ?? 80;
+  return Array.from(new Set(examples)).filter(Boolean).slice(0, maxExamples).map((example) => truncateExample(example, maxLength));
+}
+function truncateExample(example, maxLength) {
+  if (example.length <= maxLength) {
+    return example;
+  }
+  const openIndex = example.indexOf("(");
+  const closeIndex = example.lastIndexOf(")");
+  if (openIndex === -1 || closeIndex === -1 || closeIndex <= openIndex) {
+    return `${example.slice(0, Math.max(0, maxLength - 1))}\u2026`;
+  }
+  const prefix = example.slice(0, openIndex + 1);
+  const suffix = example.slice(closeIndex);
+  const available = maxLength - prefix.length - suffix.length - 5;
+  if (available <= 0) {
+    return `${prefix}...${suffix}`;
+  }
+  const args = example.slice(openIndex + 1, closeIndex).trim();
+  const shortened = args.slice(0, available).trimEnd().replace(/[\s,]+$/, "");
+  const ellipsis = shortened.length > 0 ? `${shortened}, ...` : "...";
+  return `${prefix}${ellipsis}${suffix}`;
+}
+function formatInlineParameter(option, colorize) {
+  const typeAnnotation = formatTypeAnnotation(option, colorize);
+  const optionalSuffix = option.required ? "" : "?";
+  return `${option.property}${optionalSuffix}: ${typeAnnotation}`;
+}
+function quoteShellExpression(expression) {
+  if (!expression.includes("'")) {
+    return `'${expression}'`;
+  }
+  const escaped = expression.replace(/(["\\$`])/g, "\\$1");
+  return `"${escaped}"`;
+}
+function inferReturnTypeName(schema) {
+  if (!schema || typeof schema !== "object") {
+    return void 0;
+  }
+  return inferSchemaDisplayType(schema);
+}
+function inferSchemaDisplayType(descriptor) {
+  const title = typeof descriptor.title === "string" ? descriptor.title.trim() : void 0;
+  if (title) {
+    return title;
+  }
+  const rawType = typeof descriptor.type === "string" ? descriptor.type : void 0;
+  const type = rawType === "integer" ? "number" : rawType;
+  if (!type && typeof descriptor.properties === "object") {
+    return "object";
+  }
+  if (!type && descriptor.items && typeof descriptor.items === "object") {
+    return `${inferSchemaDisplayType(descriptor.items)}[]`;
+  }
+  if (type === "array" && descriptor.items && typeof descriptor.items === "object") {
+    return `${inferSchemaDisplayType(descriptor.items)}[]`;
+  }
+  if (!type && Array.isArray(descriptor.enum)) {
+    const values = descriptor.enum.filter((entry) => typeof entry === "string");
+    if (values.length > 0) {
+      return values.map((entry) => JSON.stringify(entry)).join(" | ");
+    }
+  }
+  return type ?? "unknown";
+}
+function formatTypeAnnotation(option, colorize) {
+  let baseType;
+  if (option.enumValues && option.enumValues.length > 0) {
+    baseType = option.enumValues.map((value) => JSON.stringify(value)).join(" | ");
+  } else {
+    switch (option.type) {
+      case "number":
+        baseType = "number";
+        break;
+      case "boolean":
+        baseType = "boolean";
+        break;
+      case "array":
+        baseType = `${formatArrayItemType(option.arrayItemType)}[]`;
+        break;
+      case "object":
+        baseType = "Record<string, unknown>";
+        break;
+      case "string":
+        baseType = "string";
+        break;
+      default:
+        baseType = "unknown";
+        break;
+    }
+  }
+  const tint = colorize ? dimText : (value) => value;
+  const base = tint(baseType);
+  if (option.formatHint && option.type === "string" && (!option.enumValues || option.enumValues.length === 0)) {
+    const descriptionText = option.description?.toLowerCase() ?? "";
+    const hintLower = option.formatHint.toLowerCase();
+    const normalizedDescription = descriptionText.replace(/[\s_-]+/g, "");
+    const normalizedHint = hintLower.replace(/[\s_-]+/g, "");
+    const hasHintInDescription = descriptionText.includes(hintLower) || normalizedDescription.includes(normalizedHint);
+    if (hasHintInDescription) {
+      return base;
+    }
+    return `${base} ${tint(`/* ${option.formatHint} */`)}`;
+  }
+  return base;
+}
+function formatArrayItemType(type) {
+  switch (type) {
+    case "string":
+      return "string";
+    case "number":
+      return "number";
+    case "boolean":
+      return "boolean";
+    case "object":
+      return "Record<string, unknown>";
+    default:
+      return "unknown";
+  }
+}
+
+// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/cli/list-doc-comments.js
+var DEFAULT_WRAP_WIDTH = 100;
+function buildDocComment(description, options, opts) {
+  const colorize = opts?.colorize !== false;
+  const descriptionLines = description?.split(/\r?\n/) ?? [];
+  const paramDocs = options.filter((option) => option.description);
+  if (descriptionLines.every((line) => line.trim().length === 0) && paramDocs.length === 0) {
+    return void 0;
+  }
+  const tint = colorize ? extraDimText : (value) => value;
+  const highlightParam = colorize ? (value) => yellowText(value) : (value) => value;
+  const highlightName = colorize ? (value) => cyanText(value) : (value) => value;
+  const lines = [];
+  lines.push(tint("/**"));
+  let hasDescription = false;
+  for (const line of descriptionLines) {
+    const trimmed = line.trimEnd();
+    if (trimmed.trim().length > 0) {
+      const wrapped = wrapCommentText(trimmed);
+      for (const segment of wrapped) {
+        lines.push(tint(` * ${segment}`));
+      }
+      hasDescription = true;
+    }
+  }
+  if (hasDescription && paramDocs.length > 0) {
+    lines.push(tint(" *"));
+  }
+  for (const option of paramDocs) {
+    const optionLines = formatParamDoc(option, DEFAULT_WRAP_WIDTH, {
+      colorize,
+      highlightParam,
+      highlightName
+    });
+    lines.push(...optionLines);
+  }
+  lines.push(tint(" */"));
+  return lines;
+}
+function formatParamDoc(option, wrapWidth, config) {
+  const { colorize, highlightParam, highlightName } = config;
+  const descriptionLines = option.description?.split(/\r?\n/) ?? [""];
+  const optionalSuffix = option.required ? "" : "?";
+  const plainLabel = `@param ${option.property}${optionalSuffix}`;
+  const continuationPrefix = colorize ? extraDimText(` * ${" ".repeat(plainLabel.length + 1)}`) : ` * ${" ".repeat(plainLabel.length + 1)}`;
+  const rendered = [];
+  descriptionLines.forEach((entry, index) => {
+    const suffix = entry.trimEnd();
+    if (index === 0) {
+      const lineParts = [
+        colorize ? extraDimText(" * ") : " * ",
+        highlightParam("@param "),
+        highlightName(`${option.property}${optionalSuffix}`)
+      ];
+      if (suffix.length > 0) {
+        const wrapped = wrapCommentText(suffix, wrapWidth - plainLabel.length - 1);
+        if (wrapped.length > 0) {
+          lineParts.push(colorize ? extraDimText(` ${wrapped[0]}`) : ` ${wrapped[0]}`);
+          rendered.push(lineParts.join(""));
+          for (const continuation of wrapped.slice(1)) {
+            rendered.push(`${continuationPrefix}${colorize ? extraDimText(continuation) : continuation}`);
+          }
+          return;
+        }
+      }
+      rendered.push(lineParts.join(""));
+      return;
+    }
+    if (suffix.length > 0) {
+      const wrapped = wrapCommentText(suffix, wrapWidth - plainLabel.length - 1);
+      if (wrapped.length === 0) {
+        return;
+      }
+      const [first, ...rest] = wrapped;
+      if (!first) {
+        return;
+      }
+      rendered.push(`${continuationPrefix}${colorize ? extraDimText(first) : first}`);
+      for (const segment of rest) {
+        rendered.push(`${continuationPrefix}${colorize ? extraDimText(segment) : segment}`);
+      }
+    }
+  });
+  return rendered;
+}
+function wrapCommentText(text, width = DEFAULT_WRAP_WIDTH) {
+  if (!text) {
+    return [];
+  }
+  const words = text.split(/\s+/).filter(Boolean);
+  if (words.length === 0) {
+    return [];
+  }
+  const lines = [];
+  let current = words[0] ?? "";
+  for (let index = 1; index < words.length; index += 1) {
+    const word = words[index];
+    if (!word) {
+      continue;
+    }
+    if (`${current} ${word}`.length > width) {
+      lines.push(current);
+      current = word;
+    } else {
+      current += ` ${word}`;
+    }
+  }
+  lines.push(current);
+  return lines;
+}
+
+// node_modules/.pnpm/mcporter@0.12.3/node_modules/mcporter/dist/cli/list-detail-helpers.js
+var DEFAULT_MIN_VISIBLE_PARAMS = 5;
+function selectDisplayOptions(options, requiredOnly, minVisible = DEFAULT_MIN_VISIBLE_PARAMS) {
+  if (!requiredOnly || options.length <= minVisible) {
+    return { displayOptions: options, hiddenOptions: [] };
+  }
+  const included = /* @__PURE__ */ new Set();
+  options.forEach((option, index) => {
+    if (option.required) {
+      included.add(index);
+    }
+  });
+  let includedCount = included.size;
+  if (includedCount < minVisible) {
+    for (let index = 0; index < options.length && includedCount < minVisible; index += 1) {
+      if (included.has(index)) {
+        continue;
+      }
+      included.add(index);
+      includedCount += 1;
+    }
+  }
+  const displayOptions = options.filter((_option, index) => included.has(index));
+  const hiddenOptions = options.filter((_option, index) => !included.has(index));
+  return { displayOptions, hiddenOptions };
+}
+function buildToolDoc(input) {
+  const { serverName, toolName, description, outputSchema, options, requiredOnly, colorize = true, exampleMaxLength, flagExtras, defaultReturnType } = input;
+  const { displayOptions, hiddenOptions } = selectDisplayOptions(options, requiredOnly);
+  const docLines = buildDocComment(description, options, { colorize });
+  const signature = formatFunctionSignature(toolName, displayOptions, outputSchema, {
+    colorize,
+    defaultReturnType
+  });
+  const tsSignature = formatFunctionSignature(toolName, displayOptions, outputSchema, {
+    colorize: false,
+    defaultReturnType
+  });
+  const flagUsage = formatFlagUsage(displayOptions, flagExtras, { colorize });
+  const optionalSummary = hiddenOptions.length > 0 ? formatOptionalSummary(hiddenOptions, { colorize }) : void 0;
+  const optionDocs = options.map((option) => buildOptionDoc(option, { colorize }));
+  const callExample = formatCallExpressionExample(serverName, toolName, displayOptions.length > 0 ? displayOptions : options, { callSelector: input.callSelector, wrapExpression: input.wrapExampleExpression });
+  const examples = callExample ? formatExampleBlock([callExample], { maxExamples: 1, maxLength: exampleMaxLength ?? 80 }) : [];
+  return {
+    docLines,
+    signature,
+    tsSignature,
+    flagUsage,
+    optionalSummary,
+    examples,
+    displayOptions,
+    hiddenOptions,
+    optionDocs
+  };
+}
+function buildOptionDoc(option, opts) {
+  return {
+    option,
+    flagLabel: formatFlagLabel(option),
+    description: formatOptionDescription(option, opts)
+  };
+}
+function formatOptionDescription(option, opts) {
+  const colorize = opts?.colorize ?? false;
+  const tint = colorize ? extraDimText : (value) => value;
+  let description = option.description ? option.description : `Set ${option.property}.`;
+  const detailParts = [];
+  if (option.enumValues && option.enumValues.length > 0) {
+    detailParts.push(`choices: ${option.enumValues.join(", ")}`);
+  }
+  if (option.defaultValue !== void 0) {
+    detailParts.push(`default: ${formatHelpValue(option.defaultValue)}`);
+  }
+  if (option.exampleValue) {
+    detailParts.push(`example: ${option.exampleValue}`);
+  }
+  if (detailParts.length > 0) {
+    description += ` (${detailParts.join("; ")})`;
+  }
+  return tint(description);
+}
+function formatHelpValue(value) {
+  if (Array.isArray(value)) {
+    return value.map((entry) => String(entry)).join(", ");
+  }
+  if (value instanceof Date) {
+    return value.toISOString();
+  }
+  if (value && typeof value === "object") {
+    return JSON.stringify(value);
+  }
+  return String(value);
+}
+
+export {
+  formatExampleBlock,
+  buildToolDoc
+};

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

@@ -0,0 +1,45 @@
+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/terminal.js
+var forceColorRaw = process.env.FORCE_COLOR?.toLowerCase();
+var forceDisableColor = forceColorRaw === "0" || forceColorRaw === "false";
+var forceEnableColor = forceColorRaw === "1" || forceColorRaw === "true" || forceColorRaw === "2" || forceColorRaw === "3";
+var hasNoColor = process.env.NO_COLOR !== void 0;
+var stdoutStream = process.stdout;
+var supportsAnsiColor = !hasNoColor && (forceEnableColor || !forceDisableColor && Boolean(stdoutStream?.isTTY));
+function colorize(code, text) {
+  if (!supportsAnsiColor) {
+    return text;
+  }
+  return `\x1B[${code}m${text}\x1B[0m`;
+}
+var dimText = (text) => colorize(90, text);
+var yellowText = (text) => colorize(33, text);
+var redText = (text) => colorize(31, text);
+var extraDimText = (text) => {
+  if (!supportsAnsiColor) {
+    return text;
+  }
+  return `\x1B[38;5;244m${text}\x1B[0m`;
+};
+var cyanText = (text) => colorize(36, text);
+var boldText = (text) => {
+  if (!supportsAnsiColor) {
+    return text;
+  }
+  return `\x1B[1m${text}\x1B[0m`;
+};
+var isCI = Boolean(process.env.CI && process.env.CI !== "0" && process.env.CI.toLowerCase() !== "false");
+var spinnerDisabled = process.env.MCPORTER_NO_SPINNER === "1";
+var supportsSpinner = Boolean(stdoutStream?.isTTY && !isCI && !spinnerDisabled);
+
+export {
+  supportsAnsiColor,
+  dimText,
+  yellowText,
+  redText,
+  extraDimText,
+  cyanText,
+  boldText,
+  supportsSpinner
+};