@langwatch/mcp-server 2.0.0 → 2.2.0

package/dist/search-traces-HSTQ6WTQ.js

@@ -0,0 +1,171 @@
+import {
+  formatEvaluationLines
+} from "./chunk-DMM3JQ42.js";
+import {
+  parseRelativeDate
+} from "./chunk-BIIKE3EI.js";
+import {
+  searchTraces
+} from "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+import "./chunk-SAS5OB7F.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-HSTQ6WTQ.js.map

package/dist/{set-model-provider-3WKT63ZN.js → set-model-provider-GF7NXUJA.js}

@@ -1,8 +1,8 @@
 import {
   setModelProvider
-} from "./chunk-SFB4MU6H.js";
-import "./chunk-A2LEVYQ5.js";
-import "./chunk-WT4PO4A3.js";
+} from "./chunk-SXFC3FNH.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
 import "./chunk-SAS5OB7F.js";
 
 // src/tools/set-model-provider.ts
@@ -31,4 +31,4 @@ async function handleSetModelProvider(params) {
 export {
   handleSetModelProvider
 };
-//# sourceMappingURL=set-model-provider-3WKT63ZN.js.map
+//# sourceMappingURL=set-model-provider-GF7NXUJA.js.map

package/dist/set-model-provider-KDQ7C4EZ.js

@@ -0,0 +1,33 @@
+import {
+  setModelProvider
+} from "./chunk-SXFC3FNH.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+
+// src/tools/set-model-provider.ts
+async function handleSetModelProvider(params) {
+  const providers = await setModelProvider(params);
+  const updated = providers[params.provider];
+  if (!updated) {
+    throw new Error(
+      `Model provider "${params.provider}" was not found in the response. The provider name may be invalid.`
+    );
+  }
+  const lines = [];
+  lines.push("Model provider updated successfully!\n");
+  lines.push(`**Provider**: ${params.provider}`);
+  lines.push(`**Status**: ${updated?.enabled ? "enabled" : "disabled"}`);
+  if (updated?.customKeys) {
+    const keyFields = Object.entries(updated.customKeys).map(([k, v]) => `${k}: ${v ? "set" : "not set"}`).join(", ");
+    lines.push(`**Keys**: ${keyFields}`);
+  }
+  if (params.defaultModel) {
+    const normalizedModel = params.defaultModel.includes("/") ? params.defaultModel : `${params.provider}/${params.defaultModel}`;
+    lines.push(`**Default Model**: ${normalizedModel}`);
+  }
+  return lines.join("\n");
+}
+export {
+  handleSetModelProvider
+};
+//# sourceMappingURL=set-model-provider-KDQ7C4EZ.js.map

package/dist/{update-agent-SMAEHLXH.js → update-agent-DWG43T2P.js}

@@ -1,8 +1,8 @@
 import {
   updateAgent
-} from "./chunk-TOXJQDIZ.js";
-import "./chunk-A2LEVYQ5.js";
-import "./chunk-WT4PO4A3.js";
+} from "./chunk-HGELNIVY.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
 import "./chunk-SAS5OB7F.js";
 
 // src/tools/update-agent.ts
@@ -18,4 +18,4 @@ async function handleUpdateAgent(params) {
 export {
   handleUpdateAgent
 };
-//# sourceMappingURL=update-agent-SMAEHLXH.js.map
+//# sourceMappingURL=update-agent-DWG43T2P.js.map

package/dist/update-agent-MXNOBS4H.js

@@ -0,0 +1,20 @@
+import {
+  updateAgent
+} from "./chunk-YCARO42Z.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+
+// src/tools/update-agent.ts
+async function handleUpdateAgent(params) {
+  const { id, ...data } = params;
+  const agent = await updateAgent({ id, ...data });
+  return `Agent updated successfully!
+
+**Name**: ${agent.name}
+**ID**: ${agent.id}
+**Type**: ${agent.type}`;
+}
+export {
+  handleUpdateAgent
+};
+//# sourceMappingURL=update-agent-MXNOBS4H.js.map

package/dist/update-dashboard-widget-CJKJLCDY.js

@@ -0,0 +1,71 @@
+import {
+  assertDashboardExists,
+  getDashboardWidget,
+  normalizeDashboardWidgetQueries,
+  updateDashboardWidget
+} from "./chunk-5FNCQRCX.js";
+import "./chunk-K2I7Z3LZ.js";
+import {
+  getCurrentProject
+} from "./chunk-B4J3PJLX.js";
+import {
+  LangWatchApiError
+} from "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+import "./chunk-SAS5OB7F.js";
+
+// src/tools/update-dashboard-widget.ts
+async function handleUpdateDashboardWidget(params) {
+  const { dashboardId, widgetId, name, code, description } = params;
+  if (name === void 0 && code === void 0 && params.queries === void 0 && description === void 0) {
+    throw new Error("Provide at least one of name, code, queries or description to change.");
+  }
+  const queries = params.queries === void 0 ? void 0 : normalizeDashboardWidgetQueries({ queries: params.queries });
+  const project = await getCurrentProject();
+  await assertDashboardExists({ projectId: project.id, dashboardId });
+  const current = await getWidgetOnDashboard({ projectId: project.id, widgetId, dashboardId });
+  const widget = await updateDashboardWidget({
+    projectId: project.id,
+    widgetId: current.id,
+    ...name === void 0 ? {} : { name },
+    ...code === void 0 ? {} : { code },
+    ...queries === void 0 ? {} : { queries },
+    ...description === void 0 ? {} : { description }
+  });
+  return [
+    `Widget "${widget.name}" updated on dashboard "${dashboardId}".`,
+    `**Widget ID**: ${widget.id}`,
+    `**Queries**: ${widget.definition.queries.map((query) => query.name).join(", ") || "(none)"}`,
+    "",
+    "```json",
+    JSON.stringify(widget, null, 2),
+    "```"
+  ].join("\n");
+}
+async function getWidgetOnDashboard({
+  projectId,
+  widgetId,
+  dashboardId
+}) {
+  let widget;
+  try {
+    widget = await getDashboardWidget({ projectId, widgetId });
+  } catch (error) {
+    if (error instanceof LangWatchApiError && error.status === 404) {
+      throw new Error(
+        `No widget with ID "${widgetId}" was found in this project. Use the widget ID add_dashboard_widget returned.`
+      );
+    }
+    throw error;
+  }
+  if (widget.dashboardId !== dashboardId) {
+    throw new Error(
+      `Widget "${widgetId}" is not on dashboard "${dashboardId}". Pass the dashboard the widget was added to.`
+    );
+  }
+  return widget;
+}
+export {
+  handleUpdateDashboardWidget
+};
+//# sourceMappingURL=update-dashboard-widget-CJKJLCDY.js.map

package/dist/update-dashboard-widget-CYQDS2NR.js

@@ -0,0 +1,70 @@
+import {
+  assertDashboardExists,
+  getDashboardWidget,
+  normalizeDashboardWidgetQueries,
+  updateDashboardWidget
+} from "./chunk-5FNCQRCX.js";
+import "./chunk-K2I7Z3LZ.js";
+import {
+  getCurrentProject
+} from "./chunk-B4J3PJLX.js";
+import {
+  LangWatchApiError
+} from "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+
+// src/tools/update-dashboard-widget.ts
+async function handleUpdateDashboardWidget(params) {
+  const { dashboardId, widgetId, name, code, description } = params;
+  if (name === void 0 && code === void 0 && params.queries === void 0 && description === void 0) {
+    throw new Error("Provide at least one of name, code, queries or description to change.");
+  }
+  const queries = params.queries === void 0 ? void 0 : normalizeDashboardWidgetQueries({ queries: params.queries });
+  const project = await getCurrentProject();
+  await assertDashboardExists({ projectId: project.id, dashboardId });
+  const current = await getWidgetOnDashboard({ projectId: project.id, widgetId, dashboardId });
+  const widget = await updateDashboardWidget({
+    projectId: project.id,
+    widgetId: current.id,
+    ...name === void 0 ? {} : { name },
+    ...code === void 0 ? {} : { code },
+    ...queries === void 0 ? {} : { queries },
+    ...description === void 0 ? {} : { description }
+  });
+  return [
+    `Widget "${widget.name}" updated on dashboard "${dashboardId}".`,
+    `**Widget ID**: ${widget.id}`,
+    `**Queries**: ${widget.definition.queries.map((query) => query.name).join(", ") || "(none)"}`,
+    "",
+    "```json",
+    JSON.stringify(widget, null, 2),
+    "```"
+  ].join("\n");
+}
+async function getWidgetOnDashboard({
+  projectId,
+  widgetId,
+  dashboardId
+}) {
+  let widget;
+  try {
+    widget = await getDashboardWidget({ projectId, widgetId });
+  } catch (error) {
+    if (error instanceof LangWatchApiError && error.status === 404) {
+      throw new Error(
+        `No widget with ID "${widgetId}" was found in this project. Use the widget ID add_dashboard_widget returned.`
+      );
+    }
+    throw error;
+  }
+  if (widget.dashboardId !== dashboardId) {
+    throw new Error(
+      `Widget "${widgetId}" is not on dashboard "${dashboardId}". Pass the dashboard the widget was added to.`
+    );
+  }
+  return widget;
+}
+export {
+  handleUpdateDashboardWidget
+};
+//# sourceMappingURL=update-dashboard-widget-CYQDS2NR.js.map

package/dist/update-dataset-DQH3OHOU.js

@@ -0,0 +1,22 @@
+import {
+  formatDatasetMutationDetails
+} from "./chunk-7AQLPVFL.js";
+import {
+  updateDataset
+} from "./chunk-7VNSRCXO.js";
+import "./chunk-FOKVY3BK.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+
+// src/tools/update-dataset.ts
+async function handleUpdateDataset(params) {
+  const result = await updateDataset(params);
+  const lines = [];
+  lines.push("Dataset updated successfully!\n");
+  lines.push(...formatDatasetMutationDetails(result));
+  return lines.join("\n");
+}
+export {
+  handleUpdateDataset
+};
+//# sourceMappingURL=update-dataset-DQH3OHOU.js.map

package/dist/{update-dataset-BDUK7TUO.js → update-dataset-SQZ6T4WX.js}

@@ -1,12 +1,12 @@
 import {
   formatDatasetMutationDetails
-} from "./chunk-WVI5CJ6S.js";
-import "./chunk-NUFPTHKU.js";
+} from "./chunk-7AQLPVFL.js";
 import {
   updateDataset
-} from "./chunk-77BNWQ3U.js";
-import "./chunk-A2LEVYQ5.js";
-import "./chunk-WT4PO4A3.js";
+} from "./chunk-7VNSRCXO.js";
+import "./chunk-FOKVY3BK.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
 import "./chunk-SAS5OB7F.js";
 
 // src/tools/update-dataset.ts
@@ -20,4 +20,4 @@ async function handleUpdateDataset(params) {
 export {
   handleUpdateDataset
 };
-//# sourceMappingURL=update-dataset-BDUK7TUO.js.map
+//# sourceMappingURL=update-dataset-SQZ6T4WX.js.map

package/dist/{update-dataset-record-4ZSDRBSW.js → update-dataset-record-3AT4IPBC.js}

@@ -1,8 +1,8 @@
 import {
   updateDatasetRecord
-} from "./chunk-77BNWQ3U.js";
-import "./chunk-A2LEVYQ5.js";
-import "./chunk-WT4PO4A3.js";
+} from "./chunk-7VNSRCXO.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
 import "./chunk-SAS5OB7F.js";
 
 // src/tools/update-dataset-record.ts
@@ -17,4 +17,4 @@ async function handleUpdateDatasetRecord(params) {
 export {
   handleUpdateDatasetRecord
 };
-//# sourceMappingURL=update-dataset-record-4ZSDRBSW.js.map
+//# sourceMappingURL=update-dataset-record-3AT4IPBC.js.map

package/dist/update-dataset-record-7PLDGTMR.js

@@ -0,0 +1,19 @@
+import {
+  updateDatasetRecord
+} from "./chunk-7VNSRCXO.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+
+// src/tools/update-dataset-record.ts
+async function handleUpdateDatasetRecord(params) {
+  const result = await updateDatasetRecord(params);
+  const lines = [];
+  lines.push("Record updated successfully!\n");
+  lines.push(`**Record ID**: ${result.id}`);
+  lines.push(`**Entry**: ${JSON.stringify(result.entry)}`);
+  return lines.join("\n");
+}
+export {
+  handleUpdateDatasetRecord
+};
+//# sourceMappingURL=update-dataset-record-7PLDGTMR.js.map

package/dist/update-evaluator-4LFTKFPT.js

@@ -0,0 +1,24 @@
+import {
+  getEvaluatorType,
+  updateEvaluator
+} from "./chunk-3OCG3QPU.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+
+// src/tools/update-evaluator.ts
+async function handleUpdateEvaluator(params) {
+  const { evaluatorId, ...data } = params;
+  const result = await updateEvaluator({ id: evaluatorId, ...data });
+  const evaluatorType = getEvaluatorType(result);
+  const lines = [];
+  lines.push("Evaluator updated successfully!\n");
+  lines.push(`**ID**: ${result.id}`);
+  if (result.slug) lines.push(`**Slug**: ${result.slug}`);
+  lines.push(`**Name**: ${result.name}`);
+  if (evaluatorType) lines.push(`**Evaluator Type**: ${evaluatorType}`);
+  return lines.join("\n");
+}
+export {
+  handleUpdateEvaluator
+};
+//# sourceMappingURL=update-evaluator-4LFTKFPT.js.map

package/dist/{update-evaluator-LS6TIBY7.js → update-evaluator-IGTX6PX4.js}

@@ -1,9 +1,9 @@
 import {
   getEvaluatorType,
   updateEvaluator
-} from "./chunk-CDYQOY5U.js";
-import "./chunk-A2LEVYQ5.js";
-import "./chunk-WT4PO4A3.js";
+} from "./chunk-3OCG3QPU.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
 import "./chunk-SAS5OB7F.js";
 
 // src/tools/update-evaluator.ts
@@ -22,4 +22,4 @@ async function handleUpdateEvaluator(params) {
 export {
   handleUpdateEvaluator
 };
-//# sourceMappingURL=update-evaluator-LS6TIBY7.js.map
+//# sourceMappingURL=update-evaluator-IGTX6PX4.js.map

package/dist/{update-project-LKVYXENH.js → update-project-PLJIOZS6.js}

@@ -1,8 +1,8 @@
 import {
   updateProject
-} from "./chunk-7RHG56OH.js";
-import "./chunk-A2LEVYQ5.js";
-import "./chunk-WT4PO4A3.js";
+} from "./chunk-B4J3PJLX.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
 import "./chunk-SAS5OB7F.js";
 
 // src/tools/update-project.ts
@@ -22,4 +22,4 @@ async function handleUpdateProject(params) {
 export {
   handleUpdateProject
 };
-//# sourceMappingURL=update-project-LKVYXENH.js.map
+//# sourceMappingURL=update-project-PLJIOZS6.js.map

package/dist/update-project-QVHSJRUP.js

@@ -0,0 +1,24 @@
+import {
+  updateProject
+} from "./chunk-B4J3PJLX.js";
+import "./chunk-UWLE5T2F.js";
+import "./chunk-H6WGMG2T.js";
+
+// src/tools/update-project.ts
+async function handleUpdateProject(params) {
+  const project = await updateProject(params);
+  const lines = [];
+  lines.push(`Project updated successfully!
+`);
+  lines.push(`**Name**: ${project.name}`);
+  lines.push(`**ID**: ${project.id}`);
+  lines.push(`**Slug**: ${project.slug}`);
+  lines.push(`**Language**: ${project.language}`);
+  lines.push(`**Framework**: ${project.framework}`);
+  lines.push(`**PII Redaction**: ${project.piiRedactionLevel}`);
+  return lines.join("\n");
+}
+export {
+  handleUpdateProject
+};
+//# sourceMappingURL=update-project-QVHSJRUP.js.map