@langwatch/mcp-server 2.0.0 → 2.2.0

package/dist/rerun-run-plan-TG2V4WM4.js

@@ -0,0 +1,22 @@
+import {
+  formatRunPlanRun
+} from "./chunk-RABYBFX5.js";
+import {
+  rerunRunPlan
+} from "./chunk-PTDR56Z3.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+import "./chunk-SAS5OB7F.js";
+
+// src/tools/rerun-run-plan.ts
+async function handleRerunRunPlan(params) {
+  const result = await rerunRunPlan(params.id, {
+    parameters: params.parameters,
+    note: params.note
+  });
+  return formatRunPlanRun(result);
+}
+export {
+  handleRerunRunPlan
+};
+//# sourceMappingURL=rerun-run-plan-TG2V4WM4.js.map

package/dist/rerun-run-plan-ZI5OY3VA.js

@@ -0,0 +1,21 @@
+import {
+  formatRunPlanRun
+} from "./chunk-RABYBFX5.js";
+import {
+  rerunRunPlan
+} from "./chunk-PTDR56Z3.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+
+// src/tools/rerun-run-plan.ts
+async function handleRerunRunPlan(params) {
+  const result = await rerunRunPlan(params.id, {
+    parameters: params.parameters,
+    note: params.note
+  });
+  return formatRunPlanRun(result);
+}
+export {
+  handleRerunRunPlan
+};
+//# sourceMappingURL=rerun-run-plan-ZI5OY3VA.js.map

package/dist/revoke-api-key-3J3ZA4UB.js

@@ -0,0 +1,15 @@
+import {
+  revokeApiKey
+} from "./chunk-UNJM3BIL.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+
+// src/tools/revoke-api-key.ts
+async function handleRevokeApiKey(params) {
+  await revokeApiKey(params.id);
+  return `API key ${params.id} revoked successfully.`;
+}
+export {
+  handleRevokeApiKey
+};
+//# sourceMappingURL=revoke-api-key-3J3ZA4UB.js.map

package/dist/{revoke-api-key-FTRTZMOF.js → revoke-api-key-SFMEFWJC.js}

@@ -1,8 +1,8 @@
 import {
   revokeApiKey
-} from "./chunk-TJCXFNDT.js";
-import "./chunk-A2LEVYQ5.js";
-import "./chunk-WT4PO4A3.js";
+} from "./chunk-UNJM3BIL.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
 import "./chunk-SAS5OB7F.js";
 
 // src/tools/revoke-api-key.ts
@@ -13,4 +13,4 @@ async function handleRevokeApiKey(params) {
 export {
   handleRevokeApiKey
 };
-//# sourceMappingURL=revoke-api-key-FTRTZMOF.js.map
+//# sourceMappingURL=revoke-api-key-SFMEFWJC.js.map

package/dist/run-agent-W4VJP72Z.js

@@ -0,0 +1,75 @@
+import {
+  runAgent
+} from "./chunk-HGELNIVY.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+import "./chunk-SAS5OB7F.js";
+
+// src/tools/run-agent.ts
+import { z } from "zod";
+var jsonObjectSchema = z.looseObject({});
+function outputLines(result) {
+  const output = result.output;
+  if (output !== void 0) {
+    return ["**Output:**", typeof output === "string" ? output : JSON.stringify(output, null, 2)];
+  }
+  return ["**Result:**", JSON.stringify(result, null, 2)];
+}
+function connectedLines(result) {
+  const lines = [];
+  const instance = result.instance;
+  const durationMs = result.durationMs;
+  if (instance?.hostname) {
+    const label = instance.label ? ` (${instance.label})` : "";
+    lines.push(`
+**Instance:** ${instance.hostname}${label}`);
+  }
+  if (typeof durationMs === "number") lines.push(`**Duration:** ${durationMs} ms`);
+  const session = result.session;
+  if (session !== void 0 && session !== null) {
+    lines.push("**Session:**");
+    lines.push(JSON.stringify(session, null, 2));
+  }
+  return lines;
+}
+async function handleRunAgent({
+  id,
+  input,
+  message,
+  parameters,
+  threadId
+}) {
+  let parsedInput = {};
+  if (input) {
+    let decoded;
+    try {
+      decoded = JSON.parse(input);
+    } catch {
+      return "Error: `input` must be a valid JSON object.";
+    }
+    const result2 = jsonObjectSchema.safeParse(decoded);
+    if (!result2.success) {
+      return "Error: `input` must be a valid JSON object.";
+    }
+    parsedInput = result2.data;
+  }
+  const { agentType, result } = await runAgent({
+    id,
+    input: parsedInput,
+    message,
+    parameters,
+    threadId
+  });
+  const lines = [];
+  lines.push(`Agent executed successfully (type: ${agentType}).
+`);
+  if (typeof result === "object" && result !== null) {
+    lines.push(...outputLines(result));
+    if (agentType === "connected") lines.push(...connectedLines(result));
+  }
+  return lines.join("\n");
+}
+export {
+  handleRunAgent
+};
+//# sourceMappingURL=run-agent-W4VJP72Z.js.map

package/dist/run-agent-YNV6ZHW4.js

@@ -0,0 +1,74 @@
+import {
+  runAgent
+} from "./chunk-YCARO42Z.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+
+// src/tools/run-agent.ts
+import { z } from "zod";
+var jsonObjectSchema = z.looseObject({});
+function outputLines(result) {
+  const output = result.output;
+  if (output !== void 0) {
+    return ["**Output:**", typeof output === "string" ? output : JSON.stringify(output, null, 2)];
+  }
+  return ["**Result:**", JSON.stringify(result, null, 2)];
+}
+function connectedLines(result) {
+  const lines = [];
+  const instance = result.instance;
+  const durationMs = result.durationMs;
+  if (instance?.hostname) {
+    const label = instance.label ? ` (${instance.label})` : "";
+    lines.push(`
+**Instance:** ${instance.hostname}${label}`);
+  }
+  if (typeof durationMs === "number") lines.push(`**Duration:** ${durationMs} ms`);
+  const session = result.session;
+  if (session !== void 0 && session !== null) {
+    lines.push("**Session:**");
+    lines.push(JSON.stringify(session, null, 2));
+  }
+  return lines;
+}
+async function handleRunAgent({
+  id,
+  input,
+  message,
+  parameters,
+  threadId
+}) {
+  let parsedInput = {};
+  if (input) {
+    let decoded;
+    try {
+      decoded = JSON.parse(input);
+    } catch {
+      return "Error: `input` must be a valid JSON object.";
+    }
+    const result2 = jsonObjectSchema.safeParse(decoded);
+    if (!result2.success) {
+      return "Error: `input` must be a valid JSON object.";
+    }
+    parsedInput = result2.data;
+  }
+  const { agentType, result } = await runAgent({
+    id,
+    input: parsedInput,
+    message,
+    parameters,
+    threadId
+  });
+  const lines = [];
+  lines.push(`Agent executed successfully (type: ${agentType}).
+`);
+  if (typeof result === "object" && result !== null) {
+    lines.push(...outputLines(result));
+    if (agentType === "connected") lines.push(...connectedLines(result));
+  }
+  return lines.join("\n");
+}
+export {
+  handleRunAgent
+};
+//# sourceMappingURL=run-agent-YNV6ZHW4.js.map

package/dist/run-plan-6C77GWG4.js

@@ -0,0 +1,38 @@
+import {
+  formatRunPlanRun
+} from "./chunk-RABYBFX5.js";
+import {
+  runRunPlan
+} from "./chunk-PTDR56Z3.js";
+import {
+  toWireTargets
+} from "./chunk-O7EMWEVJ.js";
+import {
+  toWireAttachments
+} from "./chunk-U24EACC4.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+
+// src/tools/run-plan.ts
+async function handleRunPlan(params) {
+  const result = await runRunPlan({
+    name: params.name,
+    config: {
+      scope: params.scope,
+      targets: toWireTargets(params.targets),
+      repeatCount: params.repeatCount,
+      simulatorModel: params.simulatorModel,
+      judgeModel: params.judgeModel,
+      scenarioIds: params.scenarioIds,
+      ...params.evaluators !== void 0 ? { evaluators: toWireAttachments(params.evaluators) } : {}
+    },
+    idempotencyKey: params.idempotencyKey,
+    parameters: params.parameters,
+    note: params.note
+  });
+  return formatRunPlanRun(result);
+}
+export {
+  handleRunPlan
+};
+//# sourceMappingURL=run-plan-6C77GWG4.js.map

package/dist/run-plan-PAARQSI4.js

@@ -0,0 +1,39 @@
+import {
+  formatRunPlanRun
+} from "./chunk-RABYBFX5.js";
+import {
+  runRunPlan
+} from "./chunk-PTDR56Z3.js";
+import {
+  toWireTargets
+} from "./chunk-O7EMWEVJ.js";
+import {
+  toWireAttachments
+} from "./chunk-U24EACC4.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+import "./chunk-SAS5OB7F.js";
+
+// src/tools/run-plan.ts
+async function handleRunPlan(params) {
+  const result = await runRunPlan({
+    name: params.name,
+    config: {
+      scope: params.scope,
+      targets: toWireTargets(params.targets),
+      repeatCount: params.repeatCount,
+      simulatorModel: params.simulatorModel,
+      judgeModel: params.judgeModel,
+      scenarioIds: params.scenarioIds,
+      ...params.evaluators !== void 0 ? { evaluators: toWireAttachments(params.evaluators) } : {}
+    },
+    idempotencyKey: params.idempotencyKey,
+    parameters: params.parameters,
+    note: params.note
+  });
+  return formatRunPlanRun(result);
+}
+export {
+  handleRunPlan
+};
+//# sourceMappingURL=run-plan-PAARQSI4.js.map

package/dist/run-query-KJDH544C.js

@@ -0,0 +1,47 @@
+import {
+  markdownTable,
+  runQuery
+} from "./chunk-SUPUUC4W.js";
+import "./chunk-FOKVY3BK.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+import "./chunk-SAS5OB7F.js";
+
+// src/tools/run-query.ts
+var RUN_QUERY_ROW_CAP = 50;
+async function handleRunQuery(params) {
+  const result = await runQuery(params);
+  const headers = result.columns.map((column) => column.name);
+  const shown = result.rows.slice(0, RUN_QUERY_ROW_CAP);
+  const lines = [];
+  lines.push(
+    markdownTable({
+      headers,
+      rows: shown,
+      emptyMessage: "The statement ran and returned no rows."
+    })
+  );
+  lines.push("");
+  lines.push(
+    `Returned ${result.rows.length} row${result.rows.length === 1 ? "" : "s"} in ${result.statistics.elapsedMs}ms.`
+  );
+  if (result.rows.length > shown.length) {
+    lines.push(
+      `Showing the first ${shown.length}. Aggregate further, or export every row with \`langwatch query "<statement>" --format jsonl\`.`
+    );
+  }
+  if (result.truncated) {
+    lines.push(
+      "The result hit a response ceiling and was cut short, so this is not the whole answer."
+    );
+  }
+  for (const diagnostic of result.diagnostics) {
+    lines.push(`${diagnostic.code}: ${diagnostic.message}`);
+  }
+  return lines.join("\n");
+}
+export {
+  RUN_QUERY_ROW_CAP,
+  handleRunQuery
+};
+//# sourceMappingURL=run-query-KJDH544C.js.map

package/dist/run-query-T4QW2Z5O.js

@@ -0,0 +1,46 @@
+import {
+  markdownTable,
+  runQuery
+} from "./chunk-SUPUUC4W.js";
+import "./chunk-FOKVY3BK.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+
+// src/tools/run-query.ts
+var RUN_QUERY_ROW_CAP = 50;
+async function handleRunQuery(params) {
+  const result = await runQuery(params);
+  const headers = result.columns.map((column) => column.name);
+  const shown = result.rows.slice(0, RUN_QUERY_ROW_CAP);
+  const lines = [];
+  lines.push(
+    markdownTable({
+      headers,
+      rows: shown,
+      emptyMessage: "The statement ran and returned no rows."
+    })
+  );
+  lines.push("");
+  lines.push(
+    `Returned ${result.rows.length} row${result.rows.length === 1 ? "" : "s"} in ${result.statistics.elapsedMs}ms.`
+  );
+  if (result.rows.length > shown.length) {
+    lines.push(
+      `Showing the first ${shown.length}. Aggregate further, or export every row with \`langwatch query "<statement>" --format jsonl\`.`
+    );
+  }
+  if (result.truncated) {
+    lines.push(
+      "The result hit a response ceiling and was cut short, so this is not the whole answer."
+    );
+  }
+  for (const diagnostic of result.diagnostics) {
+    lines.push(`${diagnostic.code}: ${diagnostic.message}`);
+  }
+  return lines.join("\n");
+}
+export {
+  RUN_QUERY_ROW_CAP,
+  handleRunQuery
+};
+//# sourceMappingURL=run-query-T4QW2Z5O.js.map

package/dist/run-test-suite-SQJELEZX.js

@@ -0,0 +1,26 @@
+import {
+  formatRunPlanRun
+} from "./chunk-RABYBFX5.js";
+import {
+  toWireTargets
+} from "./chunk-O7EMWEVJ.js";
+import {
+  runTestSuite
+} from "./chunk-VMWJD732.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+import "./chunk-SAS5OB7F.js";
+
+// src/tools/run-test-suite.ts
+async function handleRunTestSuite(params) {
+  const { targets, ...rest } = params;
+  const result = await runTestSuite({
+    ...rest,
+    targets: toWireTargets(targets)
+  });
+  return formatRunPlanRun(result);
+}
+export {
+  handleRunTestSuite
+};
+//# sourceMappingURL=run-test-suite-SQJELEZX.js.map

package/dist/run-test-suite-STB6NUJM.js

@@ -0,0 +1,25 @@
+import {
+  formatRunPlanRun
+} from "./chunk-RABYBFX5.js";
+import {
+  toWireTargets
+} from "./chunk-O7EMWEVJ.js";
+import {
+  runTestSuite
+} from "./chunk-VMWJD732.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+
+// src/tools/run-test-suite.ts
+async function handleRunTestSuite(params) {
+  const { targets, ...rest } = params;
+  const result = await runTestSuite({
+    ...rest,
+    targets: toWireTargets(targets)
+  });
+  return formatRunPlanRun(result);
+}
+export {
+  handleRunTestSuite
+};
+//# sourceMappingURL=run-test-suite-STB6NUJM.js.map

package/dist/{run-workflow-QPXC627O.js → run-workflow-D6PQNBI6.js}

@@ -1,8 +1,8 @@
 import {
   runWorkflow
-} from "./chunk-5CCZFUXS.js";
-import "./chunk-A2LEVYQ5.js";
-import "./chunk-WT4PO4A3.js";
+} from "./chunk-NKMTIHIJ.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
 import "./chunk-SAS5OB7F.js";
 
 // src/tools/run-workflow.ts
@@ -34,4 +34,4 @@ async function handleRunWorkflow(params) {
 export {
   handleRunWorkflow
 };
-//# sourceMappingURL=run-workflow-QPXC627O.js.map
+//# sourceMappingURL=run-workflow-D6PQNBI6.js.map

package/dist/{run-agent-6SM4XNA7.js → run-workflow-SP32SO5M.js}

@@ -1,12 +1,11 @@
 import {
-  runAgent
-} from "./chunk-TOXJQDIZ.js";
-import "./chunk-A2LEVYQ5.js";
-import "./chunk-WT4PO4A3.js";
-import "./chunk-SAS5OB7F.js";
+  runWorkflow
+} from "./chunk-NKMTIHIJ.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
 
-// src/tools/run-agent.ts
-async function handleRunAgent(params) {
+// src/tools/run-workflow.ts
+async function handleRunWorkflow(params) {
   let parsedInput = {};
   if (params.input) {
     try {
@@ -15,9 +14,9 @@ async function handleRunAgent(params) {
       return "Error: `input` must be a valid JSON object.";
     }
   }
-  const { agentType, result } = await runAgent(params.id, parsedInput);
+  const result = await runWorkflow(params.id, parsedInput);
   const lines = [];
-  lines.push(`Agent executed successfully (type: ${agentType}).
+  lines.push(`Workflow "${params.id}" executed successfully.
 `);
   if (typeof result === "object" && result !== null) {
     const output = result.output;
@@ -32,6 +31,6 @@ async function handleRunAgent(params) {
   return lines.join("\n");
 }
 export {
-  handleRunAgent
+  handleRunWorkflow
 };
-//# sourceMappingURL=run-agent-6SM4XNA7.js.map
+//# sourceMappingURL=run-workflow-SP32SO5M.js.map

package/dist/search-traces-HCBGOG6R.js

@@ -0,0 +1,170 @@
+import {
+  formatEvaluationLines
+} from "./chunk-DMM3JQ42.js";
+import {
+  parseRelativeDate
+} from "./chunk-BIIKE3EI.js";
+import {
+  searchTraces
+} from "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+
+// src/utils/trace-id-shape.ts
+var HEX_ONLY = /^[0-9a-f]+$/i;
+var MIN_TRACE_ID_LENGTH = 8;
+var PREFIXED_TRACE_ID = /^trace_[A-Za-z0-9_-]{8,}$/;
+function looksLikeTraceId(query) {
+  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;
+}
+
+// src/tools/search-traces.ts
+var HOUR_MS = 36e5;
+var DAY_MS = 864e5;
+var TEXT_SEARCH_WINDOW_MS = DAY_MS;
+var ID_LOOKUP_WINDOW_MS = 90 * DAY_MS;
+function previewLine({
+  label,
+  text
+}) {
+  const value = text?.value ? String(text.value) : "N/A";
+  return `- **${label}**: ${value.slice(0, 100)}${value.length > 100 ? "..." : ""}`;
+}
+function traceLines(trace) {
+  const lines = [`### Trace: ${trace.trace_id}`];
+  if (trace.formatted_trace) {
+    lines.push(trace.formatted_trace);
+  } else {
+    lines.push(previewLine({ label: "Input", text: trace.input }));
+    lines.push(previewLine({ label: "Output", text: trace.output }));
+  }
+  if (trace.timestamps) {
+    lines.push(`- **Time**: ${trace.timestamps.started_at || "N/A"}`);
+  }
+  if (trace.error) {
+    lines.push(`- **Error**: ${JSON.stringify(trace.error)}`);
+  }
+  if (trace.evaluations && trace.evaluations.length > 0) {
+    lines.push(...formatEvaluationLines(trace.evaluations));
+  }
+  lines.push("");
+  return lines;
+}
+function describeSpan({ ms }) {
+  if (ms % DAY_MS === 0) {
+    const days = ms / DAY_MS;
+    return days === 1 ? "24 hours" : `${days} days`;
+  }
+  const hours = Math.round(ms / HOUR_MS);
+  return hours === 1 ? "1 hour" : `${hours} hours`;
+}
+function suggestWiderWindow({ spanMs }) {
+  if (spanMs < 7 * DAY_MS) return "7d";
+  if (spanMs < 30 * DAY_MS) return "30d";
+  if (spanMs < 90 * DAY_MS) return "90d";
+  return void 0;
+}
+function buildEmptyResult({
+  query,
+  traceIds,
+  spanMs,
+  windowWasDefaulted,
+  startDate,
+  endDate
+}) {
+  const hasTraceIds = (traceIds?.length ?? 0) > 0;
+  const lines = [
+    hasTraceIds ? "No traces matched the requested trace ids in the searched window." : "No traces found matching your query.",
+    ""
+  ];
+  const range = `${new Date(startDate).toISOString()} to ${new Date(endDate).toISOString()}`;
+  lines.push(
+    windowWasDefaulted ? `Searched the last ${describeSpan({ ms: spanMs })} (the default): ${range}.` : `Searched ${range}.`
+  );
+  lines.push("", "Tips:");
+  if (query && looksLikeTraceId(query)) {
+    lines.push(
+      `- "${query}" looks like a trace id. Free text never matches trace ids \u2014 use \`get_trace\` with traceId: "${query}".`
+    );
+  }
+  const wider = suggestWiderWindow({ spanMs });
+  if (wider) {
+    lines.push(
+      `- Widen the window with startDate, e.g. startDate: "${wider}". Accepts h (hours), d (days), w (weeks), m (30-day months), or an ISO date.`
+    );
+  }
+  if (hasTraceIds) {
+    lines.push(
+      "- Retry with an earlier startDate, or relax the query and filters if you supplied them.",
+      "- Looking up one full id? `get_trace` has no time window. A unique 8\u201331 character hex prefix searches the last 90 days."
+    );
+  } else {
+    lines.push(
+      "- Looking up a known trace id? `get_trace` takes a traceId. A full id has no time window; a unique 8\u201331 character hex prefix searches the last 90 days.",
+      "- To fetch several known trace ids at once, pass `traceIds` instead of `query`."
+    );
+  }
+  return lines.join("\n");
+}
+async function handleSearchTraces(params) {
+  const now = Date.now();
+  const hasTraceIds = (params.traceIds?.length ?? 0) > 0;
+  const defaultSpanMs = hasTraceIds ? ID_LOOKUP_WINDOW_MS : TEXT_SEARCH_WINDOW_MS;
+  const endDate = params.endDate !== void 0 ? parseRelativeDate(params.endDate) : now;
+  const startDate = params.startDate !== void 0 ? parseRelativeDate(params.startDate) : endDate - defaultSpanMs;
+  if (startDate >= endDate) {
+    throw new Error(
+      `Invalid trace search window: startDate (${new Date(startDate).toISOString()}) must be before endDate (${new Date(endDate).toISOString()}).`
+    );
+  }
+  const format = params.format ?? "digest";
+  const result = await searchTraces({
+    query: params.query,
+    traceIds: params.traceIds,
+    filters: params.filters,
+    // Forwarded as itself: the filter language and the free-text query are two
+    // different searches, and the server combines them.
+    ...params.filter ? { filter: params.filter } : {},
+    startDate,
+    endDate,
+    pageSize: params.pageSize ?? 25,
+    scrollId: params.scrollId,
+    format
+  });
+  const traces = result.traces ?? [];
+  if (traces.length === 0) {
+    return buildEmptyResult({
+      query: params.query,
+      traceIds: params.traceIds,
+      spanMs: endDate - startDate,
+      windowWasDefaulted: params.startDate === void 0,
+      startDate,
+      endDate
+    });
+  }
+  if (format === "json") {
+    return JSON.stringify(result, null, 2);
+  }
+  const lines = [];
+  lines.push(`Found ${result.pagination?.totalHits ?? traces.length} traces:
+`);
+  for (const trace of traces) {
+    lines.push(...traceLines(trace));
+  }
+  if (result.pagination?.scrollId) {
+    lines.push(
+      `
+**More results available.** Use scrollId: "${result.pagination.scrollId}" to get next page.`
+    );
+  }
+  lines.push(
+    '\n> Tip: Use `get_trace` with a traceId for full details. Use `search_traces` with `format: "json"` for raw data. Use `discover_schema` to see available filter fields.'
+  );
+  return lines.join("\n");
+}
+export {
+  handleSearchTraces
+};
+//# sourceMappingURL=search-traces-HCBGOG6R.js.map