@langwatch/mcp-server 2.1.0 → 3.0.0

package/src/utils/format-evaluations.ts

@@ -9,12 +9,12 @@ export interface EvaluationSummary {
 /** Formats a trace's evaluation results as markdown bullet lines, one per evaluation. */
 export function formatEvaluationLines(evaluations: EvaluationSummary[]): string[] {
   return evaluations.map((evaluation) => {
-    const status =
-      evaluation.passed === true
-        ? "PASSED"
-        : evaluation.passed === false
-          ? "FAILED"
-          : "N/A";
+    let status = "N/A";
+    if (evaluation.passed === true) {
+      status = "PASSED";
+    } else if (evaluation.passed === false) {
+      status = "FAILED";
+    }
     return `- **${evaluation.name || evaluation.evaluator_id}**: ${status}${evaluation.score != null ? ` (score: ${evaluation.score})` : ""}${evaluation.label ? ` [${evaluation.label}]` : ""}`;
   });
 }

package/src/utils/markdown-table.ts

@@ -0,0 +1,58 @@
+/**
+ * One markdown table renderer for caller-chosen columns. Cells are captured content, so they are
+ * escaped: one pipe in a cell would split the row for every reader.
+ */
+
+import { escapeMarkdown } from "./escape-markdown.ts";
+
+/** Longest a single cell is rendered before it is cut. */
+const MAX_CELL_LENGTH = 200;
+
+/** One cell: escaped, flattened to a line, and bounded. */
+export function markdownCell(value: unknown): string {
+  if (value === null || value === undefined) return "";
+  const text = cellText(value);
+  const escaped = escapeMarkdown(text);
+  return escaped.length > MAX_CELL_LENGTH ? `${escaped.slice(0, MAX_CELL_LENGTH - 1)}…` : escaped;
+}
+
+/**
+ * A markdown table, or a line saying there is nothing to show. `rows` are read by header, so a row
+ * missing a key renders an empty cell rather than shifting every cell after it one column left.
+ */
+export function markdownTable({
+  headers,
+  rows,
+  emptyMessage = "No rows.",
+}: {
+  headers: readonly string[];
+  rows: readonly Record<string, unknown>[];
+  emptyMessage?: string;
+}): string {
+  if (headers.length === 0 || rows.length === 0) return emptyMessage;
+  const lines = [
+    `| ${headers.map(markdownCell).join(" | ")} |`,
+    `| ${headers.map(() => "---").join(" | ")} |`,
+  ];
+  for (const row of rows) {
+    lines.push(`| ${headers.map((header) => markdownCell(row[header])).join(" | ")} |`);
+  }
+  return lines.join("\n");
+}
+
+function cellText(value: {}): string {
+  switch (typeof value) {
+    case "string":
+      return value;
+    case "number":
+    case "boolean":
+    case "bigint":
+      return String(value);
+    case "symbol":
+      return value.toString();
+    case "function":
+      return value.name;
+    default:
+      return JSON.stringify(value);
+  }
+}

package/src/utils/trace-id-shape.ts

@@ -0,0 +1,20 @@
+/**
+ * Whether a free-text query looks like a trace id. Advisory only: it adds a sentence to an
+ * empty result (ADR-164). Restates the platform's trace-id constants; no server code is shared.
+ */
+
+/** Hex-only, matching the server's prefix resolver. */
+const HEX_ONLY = /^[0-9a-f]+$/i;
+
+/** Shortest hex string worth calling an id; no upper bound (CLI truncates to 20, OTel is 32). */
+const MIN_TRACE_ID_LENGTH = 8;
+
+/** The `trace_`-prefixed form the collector accepts (`trace_` + nanoid). */
+const PREFIXED_TRACE_ID = /^trace_[A-Za-z0-9_-]{8,}$/;
+
+export function looksLikeTraceId(query: string): boolean {
+  const candidate = query.trim();
+  if (candidate.includes(" ")) return false;
+  if (PREFIXED_TRACE_ID.test(candidate)) return true;
+  return HEX_ONLY.test(candidate) && candidate.length >= MIN_TRACE_ID_LENGTH;
+}

package/tsconfig.app.json

@@ -0,0 +1,24 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "composite": false,
+    "noEmit": true,
+    "tsBuildInfoFile": "dist/tsconfig.app.tsbuildinfo"
+  },
+  "include": ["**/*.ts"],
+  "exclude": ["node_modules", "./dist/**/*", "./example/**/*"],
+  "references": [
+    {
+      "path": "../../modules/evaluator/contract/tsconfig.build.json"
+    },
+    {
+      "path": "../../packages/redaction/tsconfig.build.json"
+    },
+    {
+      "path": "../../packages/handled-error/tsconfig.build.json"
+    },
+    {
+      "path": "../../packages/egress/tsconfig.build.json"
+    }
+  ]
+}

package/tsconfig.json

@@ -1,18 +1,18 @@
 {
+  "extends": "../../tsconfig.shared.json",
   "compilerOptions": {
-    "target": "ES2022",
+    // This package emits declarations only (tsup writes the JavaScript), so
+    // `noEmit` from the shared base is turned back off for them.
+    "noEmit": false,
+    "emitDeclarationOnly": true,
     "module": "ESNext",
     "declaration": true,
     "declarationMap": true,
     "outDir": "./dist",
-    "strict": true,
     "esModuleInterop": true,
     "resolveJsonModule": true,
     "allowJs": true,
     "checkJs": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "moduleResolution": "bundler",
     "rootDir": "../..",
     // The evaluator catalog we import (services/langevals/ts-integration/evaluators.generated.ts)
     // is Zod-first and imports `zod`, but lives outside this package's
@@ -27,13 +27,15 @@
     "ignoreDeprecations": "6.0",
     "isolatedModules": true,
     "jsx": "preserve",
-    "incremental": true,
     "noUncheckedIndexedAccess": true,
-    "tsBuildInfoFile": "./tsconfig.tsbuildinfo"
+    "tsBuildInfoFile": "dist/tsconfig.typecheck.tsbuildinfo",
+    "composite": true
   },
-  "include": [
-    ".eslintrc.cjs",
-    "**/*.ts",
-  ],
-  "exclude": ["node_modules", "./dist/**/*", "./example/**/*"]
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.app.json"
+    }
+  ]
 }