@langwatch/mcp-server 0.3.3 → 0.5.0

package/dist/discover-schema-3T52ORPB.js

@@ -0,0 +1,446 @@
+// src/schemas/filter-fields.ts
+var filterFields = [
+  {
+    field: "topics.topics",
+    description: "Main topic classification of the trace",
+    example: "billing"
+  },
+  {
+    field: "topics.subtopics",
+    description: "Subtopic classification",
+    example: "refund-request"
+  },
+  {
+    field: "metadata.user_id",
+    description: "User ID from trace metadata",
+    example: "user-123"
+  },
+  {
+    field: "metadata.thread_id",
+    description: "Conversation thread ID",
+    example: "thread-456"
+  },
+  {
+    field: "metadata.customer_id",
+    description: "Customer/organization ID",
+    example: "customer-789"
+  },
+  {
+    field: "metadata.labels",
+    description: "Custom labels attached to traces",
+    example: "production"
+  },
+  {
+    field: "metadata.key",
+    description: "Custom metadata key",
+    example: "environment"
+  },
+  {
+    field: "metadata.value",
+    description: "Custom metadata value (used with metadata.key)",
+    example: "staging"
+  },
+  {
+    field: "metadata.prompt_ids",
+    description: "Prompt IDs used in the trace"
+  },
+  {
+    field: "traces.error",
+    description: "Whether the trace has errors",
+    example: "true"
+  },
+  {
+    field: "spans.type",
+    description: "Span type (llm, tool, agent, chain, rag)",
+    example: "llm"
+  },
+  {
+    field: "spans.model",
+    description: "LLM model name used in spans",
+    example: "gpt-4o"
+  },
+  {
+    field: "evaluations.evaluator_id",
+    description: "Evaluator that ran on the trace"
+  },
+  {
+    field: "evaluations.evaluator_id.guardrails_only",
+    description: "Evaluator ID filtered to guardrails only"
+  },
+  {
+    field: "evaluations.passed",
+    description: "Whether evaluations passed",
+    example: "true"
+  },
+  {
+    field: "evaluations.score",
+    description: "Evaluation score (numeric)"
+  },
+  {
+    field: "evaluations.state",
+    description: "Evaluation state (processed, error, skipped)"
+  },
+  {
+    field: "evaluations.label",
+    description: "Evaluation label result"
+  },
+  {
+    field: "events.event_type",
+    description: "Type of event (thumbs_up_down, custom)",
+    example: "thumbs_up_down"
+  },
+  {
+    field: "events.metrics.key",
+    description: "Event metric key"
+  },
+  {
+    field: "events.metrics.value",
+    description: "Event metric value (numeric)"
+  },
+  {
+    field: "events.event_details.key",
+    description: "Event detail key"
+  },
+  {
+    field: "annotations.hasAnnotation",
+    description: "Whether trace has human annotations",
+    example: "true"
+  },
+  {
+    field: "sentiment.input_sentiment",
+    description: "Detected sentiment of input",
+    example: "positive"
+  }
+];
+
+// src/schemas/analytics-metrics.ts
+var analyticsMetrics = [
+  // metadata
+  {
+    category: "metadata",
+    name: "trace_id",
+    label: "Traces",
+    allowedAggregations: ["cardinality"],
+    description: "Count of unique traces"
+  },
+  {
+    category: "metadata",
+    name: "user_id",
+    label: "Users",
+    allowedAggregations: ["cardinality"],
+    description: "Count of unique users"
+  },
+  {
+    category: "metadata",
+    name: "thread_id",
+    label: "Threads",
+    allowedAggregations: ["cardinality"],
+    description: "Count of unique conversation threads"
+  },
+  {
+    category: "metadata",
+    name: "span_type",
+    label: "Span Type",
+    allowedAggregations: ["cardinality"],
+    description: "Count of spans, optionally filtered by span type"
+  },
+  // sentiment
+  {
+    category: "sentiment",
+    name: "input_sentiment",
+    label: "Input Sentiment Score",
+    allowedAggregations: ["avg", "sum", "min", "max", "median", "p99", "p95", "p90"],
+    description: "Sentiment analysis score of inputs"
+  },
+  {
+    category: "sentiment",
+    name: "thumbs_up_down",
+    label: "Thumbs Up/Down Score",
+    allowedAggregations: [
+      "terms",
+      "cardinality",
+      "avg",
+      "sum",
+      "min",
+      "max",
+      "median",
+      "p99",
+      "p95",
+      "p90"
+    ],
+    description: "User feedback score (-1 to 1)"
+  },
+  // performance
+  {
+    category: "performance",
+    name: "completion_time",
+    label: "Completion Time",
+    allowedAggregations: ["avg", "sum", "min", "max", "median", "p99", "p95", "p90"],
+    description: "Time to complete the trace (ms)"
+  },
+  {
+    category: "performance",
+    name: "first_token",
+    label: "Time to First Token",
+    allowedAggregations: ["avg", "sum", "min", "max", "median", "p99", "p95", "p90"],
+    description: "Time to first token (ms)"
+  },
+  {
+    category: "performance",
+    name: "total_cost",
+    label: "Total Cost",
+    allowedAggregations: ["avg", "sum", "min", "max", "median", "p99", "p95", "p90"],
+    description: "Cost per trace in USD"
+  },
+  {
+    category: "performance",
+    name: "prompt_tokens",
+    label: "Prompt Tokens",
+    allowedAggregations: ["avg", "sum", "min", "max", "median", "p99", "p95", "p90"],
+    description: "Input token count"
+  },
+  {
+    category: "performance",
+    name: "completion_tokens",
+    label: "Completion Tokens",
+    allowedAggregations: ["avg", "sum", "min", "max", "median", "p99", "p95", "p90"],
+    description: "Output token count"
+  },
+  {
+    category: "performance",
+    name: "total_tokens",
+    label: "Total Tokens",
+    allowedAggregations: ["avg", "sum", "min", "max", "median", "p99", "p95", "p90"],
+    description: "Total token count (input + output)"
+  },
+  {
+    category: "performance",
+    name: "tokens_per_second",
+    label: "Tokens per Second",
+    allowedAggregations: ["avg", "sum", "min", "max", "median", "p99", "p95", "p90"],
+    description: "Token generation speed"
+  },
+  // events
+  {
+    category: "events",
+    name: "event_type",
+    label: "Event Type",
+    allowedAggregations: ["cardinality"],
+    description: "Count of events, optionally filtered by event type"
+  },
+  {
+    category: "events",
+    name: "event_score",
+    label: "Event Score",
+    allowedAggregations: [
+      "terms",
+      "avg",
+      "sum",
+      "min",
+      "max",
+      "median",
+      "p99",
+      "p95",
+      "p90"
+    ],
+    description: "Numeric score from events (requires event_type key and metrics key)"
+  },
+  {
+    category: "events",
+    name: "event_details",
+    label: "Event Details",
+    allowedAggregations: ["cardinality"],
+    description: "Event detail key/value distribution (requires event_type key and details key)"
+  },
+  // evaluations
+  {
+    category: "evaluations",
+    name: "evaluation_score",
+    label: "Evaluation Score",
+    allowedAggregations: ["avg", "sum", "min", "max", "median", "p99", "p95", "p90"],
+    description: "Numeric evaluation score (requires evaluator_id key)"
+  },
+  {
+    category: "evaluations",
+    name: "evaluation_pass_rate",
+    label: "Evaluation Pass Rate",
+    allowedAggregations: ["avg", "sum", "min", "max", "median", "p99", "p95", "p90"],
+    description: "Percentage of traces passing evaluation (requires evaluator_id key)"
+  },
+  {
+    category: "evaluations",
+    name: "evaluation_runs",
+    label: "Evaluation Runs",
+    allowedAggregations: ["cardinality"],
+    description: "Count of evaluation executions"
+  },
+  // threads
+  {
+    category: "threads",
+    name: "average_duration_per_thread",
+    label: "Thread Duration",
+    allowedAggregations: ["avg"],
+    description: "Average duration of conversation threads (ms)"
+  }
+];
+
+// src/schemas/analytics-groups.ts
+var analyticsGroups = [
+  {
+    name: "topics.topics",
+    label: "Topic",
+    description: "Group by topic classification"
+  },
+  {
+    name: "metadata.user_id",
+    label: "User",
+    description: "Group by user ID"
+  },
+  {
+    name: "metadata.thread_id",
+    label: "Thread",
+    description: "Group by conversation thread"
+  },
+  {
+    name: "metadata.customer_id",
+    label: "Customer ID",
+    description: "Group by customer/organization"
+  },
+  {
+    name: "metadata.labels",
+    label: "Label",
+    description: "Group by custom labels"
+  },
+  {
+    name: "metadata.model",
+    label: "Model",
+    description: "Group by LLM model name"
+  },
+  {
+    name: "metadata.span_type",
+    label: "Span Type",
+    description: "Group by span type (llm, tool, agent, etc.)"
+  },
+  {
+    name: "sentiment.input_sentiment",
+    label: "Input Sentiment",
+    description: "Group by detected input sentiment (positive, negative, neutral)"
+  },
+  {
+    name: "sentiment.thumbs_up_down",
+    label: "Thumbs Up/Down",
+    description: "Group by user feedback (positive, negative, neutral)"
+  },
+  {
+    name: "events.event_type",
+    label: "Event Type",
+    description: "Group by event type"
+  },
+  {
+    name: "evaluations.evaluation_passed",
+    label: "Evaluation Passed",
+    description: "Group by evaluation pass/fail status"
+  },
+  {
+    name: "evaluations.evaluation_label",
+    label: "Evaluation Label",
+    description: "Group by evaluation label result"
+  },
+  {
+    name: "evaluations.evaluation_processing_state",
+    label: "Evaluation Processing State",
+    description: "Group by evaluation processing state"
+  },
+  {
+    name: "error.has_error",
+    label: "Contains Error",
+    description: "Group by whether the trace contains an error"
+  }
+];
+
+// src/tools/discover-schema.ts
+function formatSchema(category) {
+  const sections = [];
+  if (category === "filters" || category === "all") {
+    sections.push(formatFilters());
+  }
+  if (category === "metrics" || category === "all") {
+    sections.push(formatMetrics());
+  }
+  if (category === "aggregations" || category === "all") {
+    sections.push(formatAggregations());
+  }
+  if (category === "groups" || category === "all") {
+    sections.push(formatGroups());
+  }
+  return sections.join("\n\n");
+}
+function formatFilters() {
+  const lines = ["## Available Filter Fields", ""];
+  lines.push(
+    "Use these in the `filters` parameter of `search_traces` and `get_analytics`."
+  );
+  lines.push('Format: `{ "field_name": ["value1", "value2"] }`');
+  lines.push("");
+  for (const f of filterFields) {
+    lines.push(
+      `- **${f.field}**: ${f.description}${f.example ? ` (e.g., \`${f.example}\`)` : ""}`
+    );
+  }
+  return lines.join("\n");
+}
+function formatMetrics() {
+  const lines = ["## Available Metrics", ""];
+  lines.push(
+    "Use these in `get_analytics` as `metric` parameter in `category.name` format."
+  );
+  lines.push("");
+  const byCategory = /* @__PURE__ */ new Map();
+  for (const m of analyticsMetrics) {
+    const list = byCategory.get(m.category) || [];
+    list.push(m);
+    byCategory.set(m.category, list);
+  }
+  for (const [cat, metrics] of byCategory) {
+    lines.push(`### ${cat}`);
+    for (const m of metrics) {
+      lines.push(`- **${cat}.${m.name}** (${m.label}): ${m.description}`);
+      lines.push(`  Aggregations: ${m.allowedAggregations.join(", ")}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function formatAggregations() {
+  return [
+    "## Available Aggregation Types",
+    "",
+    "- **cardinality**: Count unique values",
+    "- **terms**: Distribution/breakdown of values",
+    "- **avg**: Average",
+    "- **sum**: Sum total",
+    "- **min**: Minimum",
+    "- **max**: Maximum",
+    "- **median**: 50th percentile",
+    "- **p90**: 90th percentile",
+    "- **p95**: 95th percentile",
+    "- **p99**: 99th percentile",
+    "",
+    "Note: Not all aggregations are available for all metrics. Check the metric's allowed aggregations."
+  ].join("\n");
+}
+function formatGroups() {
+  const lines = ["## Available Group-By Options", ""];
+  lines.push(
+    "Use these in the `groupBy` parameter of `get_analytics`."
+  );
+  lines.push("");
+  for (const g of analyticsGroups) {
+    lines.push(`- **${g.name}** (${g.label}): ${g.description}`);
+  }
+  return lines.join("\n");
+}
+export {
+  formatSchema
+};
+//# sourceMappingURL=discover-schema-3T52ORPB.js.map

package/dist/discover-schema-3T52ORPB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/filter-fields.ts","../src/schemas/analytics-metrics.ts","../src/schemas/analytics-groups.ts","../src/tools/discover-schema.ts"],"sourcesContent":["export interface FilterFieldInfo {\n  field: string;\n  description: string;\n  example?: string;\n}\n\nexport const filterFields: FilterFieldInfo[] = [\n  {\n    field: \"topics.topics\",\n    description: \"Main topic classification of the trace\",\n    example: \"billing\",\n  },\n  {\n    field: \"topics.subtopics\",\n    description: \"Subtopic classification\",\n    example: \"refund-request\",\n  },\n  {\n    field: \"metadata.user_id\",\n    description: \"User ID from trace metadata\",\n    example: \"user-123\",\n  },\n  {\n    field: \"metadata.thread_id\",\n    description: \"Conversation thread ID\",\n    example: \"thread-456\",\n  },\n  {\n    field: \"metadata.customer_id\",\n    description: \"Customer/organization ID\",\n    example: \"customer-789\",\n  },\n  {\n    field: \"metadata.labels\",\n    description: \"Custom labels attached to traces\",\n    example: \"production\",\n  },\n  {\n    field: \"metadata.key\",\n    description: \"Custom metadata key\",\n    example: \"environment\",\n  },\n  {\n    field: \"metadata.value\",\n    description: \"Custom metadata value (used with metadata.key)\",\n    example: \"staging\",\n  },\n  {\n    field: \"metadata.prompt_ids\",\n    description: \"Prompt IDs used in the trace\",\n  },\n  {\n    field: \"traces.error\",\n    description: \"Whether the trace has errors\",\n    example: \"true\",\n  },\n  {\n    field: \"spans.type\",\n    description: \"Span type (llm, tool, agent, chain, rag)\",\n    example: \"llm\",\n  },\n  {\n    field: \"spans.model\",\n    description: \"LLM model name used in spans\",\n    example: \"gpt-4o\",\n  },\n  {\n    field: \"evaluations.evaluator_id\",\n    description: \"Evaluator that ran on the trace\",\n  },\n  {\n    field: \"evaluations.evaluator_id.guardrails_only\",\n    description: \"Evaluator ID filtered to guardrails only\",\n  },\n  {\n    field: \"evaluations.passed\",\n    description: \"Whether evaluations passed\",\n    example: \"true\",\n  },\n  {\n    field: \"evaluations.score\",\n    description: \"Evaluation score (numeric)\",\n  },\n  {\n    field: \"evaluations.state\",\n    description: \"Evaluation state (processed, error, skipped)\",\n  },\n  {\n    field: \"evaluations.label\",\n    description: \"Evaluation label result\",\n  },\n  {\n    field: \"events.event_type\",\n    description: \"Type of event (thumbs_up_down, custom)\",\n    example: \"thumbs_up_down\",\n  },\n  {\n    field: \"events.metrics.key\",\n    description: \"Event metric key\",\n  },\n  {\n    field: \"events.metrics.value\",\n    description: \"Event metric value (numeric)\",\n  },\n  {\n    field: \"events.event_details.key\",\n    description: \"Event detail key\",\n  },\n  {\n    field: \"annotations.hasAnnotation\",\n    description: \"Whether trace has human annotations\",\n    example: \"true\",\n  },\n  {\n    field: \"sentiment.input_sentiment\",\n    description: \"Detected sentiment of input\",\n    example: \"positive\",\n  },\n];\n","export interface MetricInfo {\n  category: string;\n  name: string;\n  label: string;\n  allowedAggregations: string[];\n  description: string;\n}\n\nexport const analyticsMetrics: MetricInfo[] = [\n  // metadata\n  {\n    category: \"metadata\",\n    name: \"trace_id\",\n    label: \"Traces\",\n    allowedAggregations: [\"cardinality\"],\n    description: \"Count of unique traces\",\n  },\n  {\n    category: \"metadata\",\n    name: \"user_id\",\n    label: \"Users\",\n    allowedAggregations: [\"cardinality\"],\n    description: \"Count of unique users\",\n  },\n  {\n    category: \"metadata\",\n    name: \"thread_id\",\n    label: \"Threads\",\n    allowedAggregations: [\"cardinality\"],\n    description: \"Count of unique conversation threads\",\n  },\n  {\n    category: \"metadata\",\n    name: \"span_type\",\n    label: \"Span Type\",\n    allowedAggregations: [\"cardinality\"],\n    description: \"Count of spans, optionally filtered by span type\",\n  },\n  // sentiment\n  {\n    category: \"sentiment\",\n    name: \"input_sentiment\",\n    label: \"Input Sentiment Score\",\n    allowedAggregations: [\"avg\", \"sum\", \"min\", \"max\", \"median\", \"p99\", \"p95\", \"p90\"],\n    description: \"Sentiment analysis score of inputs\",\n  },\n  {\n    category: \"sentiment\",\n    name: \"thumbs_up_down\",\n    label: \"Thumbs Up/Down Score\",\n    allowedAggregations: [\n      \"terms\",\n      \"cardinality\",\n      \"avg\",\n      \"sum\",\n      \"min\",\n      \"max\",\n      \"median\",\n      \"p99\",\n      \"p95\",\n      \"p90\",\n    ],\n    description: \"User feedback score (-1 to 1)\",\n  },\n  // performance\n  {\n    category: \"performance\",\n    name: \"completion_time\",\n    label: \"Completion Time\",\n    allowedAggregations: [\"avg\", \"sum\", \"min\", \"max\", \"median\", \"p99\", \"p95\", \"p90\"],\n    description: \"Time to complete the trace (ms)\",\n  },\n  {\n    category: \"performance\",\n    name: \"first_token\",\n    label: \"Time to First Token\",\n    allowedAggregations: [\"avg\", \"sum\", \"min\", \"max\", \"median\", \"p99\", \"p95\", \"p90\"],\n    description: \"Time to first token (ms)\",\n  },\n  {\n    category: \"performance\",\n    name: \"total_cost\",\n    label: \"Total Cost\",\n    allowedAggregations: [\"avg\", \"sum\", \"min\", \"max\", \"median\", \"p99\", \"p95\", \"p90\"],\n    description: \"Cost per trace in USD\",\n  },\n  {\n    category: \"performance\",\n    name: \"prompt_tokens\",\n    label: \"Prompt Tokens\",\n    allowedAggregations: [\"avg\", \"sum\", \"min\", \"max\", \"median\", \"p99\", \"p95\", \"p90\"],\n    description: \"Input token count\",\n  },\n  {\n    category: \"performance\",\n    name: \"completion_tokens\",\n    label: \"Completion Tokens\",\n    allowedAggregations: [\"avg\", \"sum\", \"min\", \"max\", \"median\", \"p99\", \"p95\", \"p90\"],\n    description: \"Output token count\",\n  },\n  {\n    category: \"performance\",\n    name: \"total_tokens\",\n    label: \"Total Tokens\",\n    allowedAggregations: [\"avg\", \"sum\", \"min\", \"max\", \"median\", \"p99\", \"p95\", \"p90\"],\n    description: \"Total token count (input + output)\",\n  },\n  {\n    category: \"performance\",\n    name: \"tokens_per_second\",\n    label: \"Tokens per Second\",\n    allowedAggregations: [\"avg\", \"sum\", \"min\", \"max\", \"median\", \"p99\", \"p95\", \"p90\"],\n    description: \"Token generation speed\",\n  },\n  // events\n  {\n    category: \"events\",\n    name: \"event_type\",\n    label: \"Event Type\",\n    allowedAggregations: [\"cardinality\"],\n    description: \"Count of events, optionally filtered by event type\",\n  },\n  {\n    category: \"events\",\n    name: \"event_score\",\n    label: \"Event Score\",\n    allowedAggregations: [\n      \"terms\",\n      \"avg\",\n      \"sum\",\n      \"min\",\n      \"max\",\n      \"median\",\n      \"p99\",\n      \"p95\",\n      \"p90\",\n    ],\n    description: \"Numeric score from events (requires event_type key and metrics key)\",\n  },\n  {\n    category: \"events\",\n    name: \"event_details\",\n    label: \"Event Details\",\n    allowedAggregations: [\"cardinality\"],\n    description:\n      \"Event detail key/value distribution (requires event_type key and details key)\",\n  },\n  // evaluations\n  {\n    category: \"evaluations\",\n    name: \"evaluation_score\",\n    label: \"Evaluation Score\",\n    allowedAggregations: [\"avg\", \"sum\", \"min\", \"max\", \"median\", \"p99\", \"p95\", \"p90\"],\n    description: \"Numeric evaluation score (requires evaluator_id key)\",\n  },\n  {\n    category: \"evaluations\",\n    name: \"evaluation_pass_rate\",\n    label: \"Evaluation Pass Rate\",\n    allowedAggregations: [\"avg\", \"sum\", \"min\", \"max\", \"median\", \"p99\", \"p95\", \"p90\"],\n    description:\n      \"Percentage of traces passing evaluation (requires evaluator_id key)\",\n  },\n  {\n    category: \"evaluations\",\n    name: \"evaluation_runs\",\n    label: \"Evaluation Runs\",\n    allowedAggregations: [\"cardinality\"],\n    description: \"Count of evaluation executions\",\n  },\n  // threads\n  {\n    category: \"threads\",\n    name: \"average_duration_per_thread\",\n    label: \"Thread Duration\",\n    allowedAggregations: [\"avg\"],\n    description: \"Average duration of conversation threads (ms)\",\n  },\n];\n","export interface GroupByInfo {\n  name: string;\n  label: string;\n  description: string;\n}\n\nexport const analyticsGroups: GroupByInfo[] = [\n  {\n    name: \"topics.topics\",\n    label: \"Topic\",\n    description: \"Group by topic classification\",\n  },\n  {\n    name: \"metadata.user_id\",\n    label: \"User\",\n    description: \"Group by user ID\",\n  },\n  {\n    name: \"metadata.thread_id\",\n    label: \"Thread\",\n    description: \"Group by conversation thread\",\n  },\n  {\n    name: \"metadata.customer_id\",\n    label: \"Customer ID\",\n    description: \"Group by customer/organization\",\n  },\n  {\n    name: \"metadata.labels\",\n    label: \"Label\",\n    description: \"Group by custom labels\",\n  },\n  {\n    name: \"metadata.model\",\n    label: \"Model\",\n    description: \"Group by LLM model name\",\n  },\n  {\n    name: \"metadata.span_type\",\n    label: \"Span Type\",\n    description: \"Group by span type (llm, tool, agent, etc.)\",\n  },\n  {\n    name: \"sentiment.input_sentiment\",\n    label: \"Input Sentiment\",\n    description: \"Group by detected input sentiment (positive, negative, neutral)\",\n  },\n  {\n    name: \"sentiment.thumbs_up_down\",\n    label: \"Thumbs Up/Down\",\n    description: \"Group by user feedback (positive, negative, neutral)\",\n  },\n  {\n    name: \"events.event_type\",\n    label: \"Event Type\",\n    description: \"Group by event type\",\n  },\n  {\n    name: \"evaluations.evaluation_passed\",\n    label: \"Evaluation Passed\",\n    description: \"Group by evaluation pass/fail status\",\n  },\n  {\n    name: \"evaluations.evaluation_label\",\n    label: \"Evaluation Label\",\n    description: \"Group by evaluation label result\",\n  },\n  {\n    name: \"evaluations.evaluation_processing_state\",\n    label: \"Evaluation Processing State\",\n    description: \"Group by evaluation processing state\",\n  },\n  {\n    name: \"error.has_error\",\n    label: \"Contains Error\",\n    description: \"Group by whether the trace contains an error\",\n  },\n];\n","import { filterFields } from \"../schemas/filter-fields.js\";\nimport { analyticsMetrics } from \"../schemas/analytics-metrics.js\";\nimport { analyticsGroups } from \"../schemas/analytics-groups.js\";\n\nexport type Category =\n  | \"filters\"\n  | \"metrics\"\n  | \"aggregations\"\n  | \"groups\"\n  | \"all\";\n\n/**\n * Formats the LangWatch analytics schema into human-readable markdown.\n *\n * Returns documentation for the requested category of schema elements\n * (filter fields, metrics, aggregation types, or group-by options).\n */\nexport function formatSchema(category: Category): string {\n  const sections: string[] = [];\n\n  if (category === \"filters\" || category === \"all\") {\n    sections.push(formatFilters());\n  }\n  if (category === \"metrics\" || category === \"all\") {\n    sections.push(formatMetrics());\n  }\n  if (category === \"aggregations\" || category === \"all\") {\n    sections.push(formatAggregations());\n  }\n  if (category === \"groups\" || category === \"all\") {\n    sections.push(formatGroups());\n  }\n\n  return sections.join(\"\\n\\n\");\n}\n\nfunction formatFilters(): string {\n  const lines = [\"## Available Filter Fields\", \"\"];\n  lines.push(\n    \"Use these in the `filters` parameter of `search_traces` and `get_analytics`.\"\n  );\n  lines.push('Format: `{ \"field_name\": [\"value1\", \"value2\"] }`');\n  lines.push(\"\");\n  for (const f of filterFields) {\n    lines.push(\n      `- **${f.field}**: ${f.description}${f.example ? ` (e.g., \\`${f.example}\\`)` : \"\"}`\n    );\n  }\n  return lines.join(\"\\n\");\n}\n\nfunction formatMetrics(): string {\n  const lines = [\"## Available Metrics\", \"\"];\n  lines.push(\n    \"Use these in `get_analytics` as `metric` parameter in `category.name` format.\"\n  );\n  lines.push(\"\");\n\n  const byCategory = new Map<string, typeof analyticsMetrics>();\n  for (const m of analyticsMetrics) {\n    const list = byCategory.get(m.category) || [];\n    list.push(m);\n    byCategory.set(m.category, list);\n  }\n\n  for (const [cat, metrics] of byCategory) {\n    lines.push(`### ${cat}`);\n    for (const m of metrics) {\n      lines.push(`- **${cat}.${m.name}** (${m.label}): ${m.description}`);\n      lines.push(`  Aggregations: ${m.allowedAggregations.join(\", \")}`);\n    }\n    lines.push(\"\");\n  }\n  return lines.join(\"\\n\");\n}\n\nfunction formatAggregations(): string {\n  return [\n    \"## Available Aggregation Types\",\n    \"\",\n    \"- **cardinality**: Count unique values\",\n    \"- **terms**: Distribution/breakdown of values\",\n    \"- **avg**: Average\",\n    \"- **sum**: Sum total\",\n    \"- **min**: Minimum\",\n    \"- **max**: Maximum\",\n    \"- **median**: 50th percentile\",\n    \"- **p90**: 90th percentile\",\n    \"- **p95**: 95th percentile\",\n    \"- **p99**: 99th percentile\",\n    \"\",\n    \"Note: Not all aggregations are available for all metrics. Check the metric's allowed aggregations.\",\n  ].join(\"\\n\");\n}\n\nfunction formatGroups(): string {\n  const lines = [\"## Available Group-By Options\", \"\"];\n  lines.push(\n    \"Use these in the `groupBy` parameter of `get_analytics`.\"\n  );\n  lines.push(\"\");\n  for (const g of analyticsGroups) {\n    lines.push(`- **${g.name}** (${g.label}): ${g.description}`);\n  }\n  return lines.join(\"\\n\");\n}\n"],"mappings":"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","names":[]}

package/dist/get-analytics-BAVXTAPB.js

@@ -0,0 +1,55 @@
+import {
+  parseRelativeDate
+} from "./chunk-ZXKLPC2E.js";
+import {
+  getAnalyticsTimeseries
+} from "./chunk-JVWDWL3J.js";
+import "./chunk-AAQNA53E.js";
+
+// src/tools/get-analytics.ts
+async function handleGetAnalytics(params) {
+  const now = Date.now();
+  const startDate = params.startDate ? parseRelativeDate(params.startDate) : now - 7 * 864e5;
+  const endDate = params.endDate ? parseRelativeDate(params.endDate) : now;
+  const [category, name] = params.metric.includes(".") ? params.metric.split(".", 2) : ["metadata", params.metric];
+  const metricKey = `${category}.${name}`;
+  const aggregation = params.aggregation ?? "avg";
+  const result = await getAnalyticsTimeseries({
+    series: [{ metric: metricKey, aggregation }],
+    startDate,
+    endDate,
+    timeZone: params.timeZone ?? "UTC",
+    groupBy: params.groupBy,
+    filters: params.filters
+  });
+  const lines = [];
+  lines.push(`# Analytics: ${metricKey} (${aggregation})
+`);
+  lines.push(
+    `Period: ${new Date(startDate).toISOString().split("T")[0]} to ${new Date(endDate).toISOString().split("T")[0]}`
+  );
+  if (params.groupBy) lines.push(`Grouped by: ${params.groupBy}`);
+  lines.push("");
+  const currentPeriod = result.currentPeriod ?? [];
+  if (currentPeriod.length === 0) {
+    lines.push("No data available for this period.");
+  } else {
+    lines.push("| Date | Value |");
+    lines.push("|------|-------|");
+    for (const bucket of currentPeriod) {
+      const date = bucket.date;
+      const value = Object.entries(bucket).find(
+        ([k]) => k !== "date" && typeof bucket[k] === "number"
+      )?.[1] ?? "N/A";
+      lines.push(`| ${date} | ${value} |`);
+    }
+  }
+  lines.push(
+    "\n> Tip: Use `discover_schema` to see all available metrics and aggregation types."
+  );
+  return lines.join("\n");
+}
+export {
+  handleGetAnalytics
+};
+//# sourceMappingURL=get-analytics-BAVXTAPB.js.map

package/dist/get-analytics-BAVXTAPB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tools/get-analytics.ts"],"sourcesContent":["import { getAnalyticsTimeseries as apiGetAnalytics } from \"../langwatch-api.js\";\nimport { parseRelativeDate } from \"../utils/date-parsing.js\";\n\n/**\n * Handles the get_analytics MCP tool invocation.\n *\n * Queries analytics timeseries from LangWatch and formats the results\n * as an AI-readable markdown table.\n */\nexport async function handleGetAnalytics(params: {\n  metric: string;\n  aggregation?: string;\n  startDate?: string;\n  endDate?: string;\n  timeZone?: string;\n  groupBy?: string;\n  filters?: Record<string, string[]>;\n}): Promise<string> {\n  const now = Date.now();\n  const startDate = params.startDate\n    ? parseRelativeDate(params.startDate)\n    : now - 7 * 86400000;\n  const endDate = params.endDate ? parseRelativeDate(params.endDate) : now;\n\n  // Parse metric format \"category.name\"\n  const [category, name] = params.metric.includes(\".\")\n    ? params.metric.split(\".\", 2)\n    : [\"metadata\", params.metric];\n  const metricKey = `${category}.${name}`;\n  const aggregation = params.aggregation ?? \"avg\";\n\n  const result = await apiGetAnalytics({\n    series: [{ metric: metricKey, aggregation }],\n    startDate,\n    endDate,\n    timeZone: params.timeZone ?? \"UTC\",\n    groupBy: params.groupBy,\n    filters: params.filters,\n  });\n\n  const lines: string[] = [];\n  lines.push(`# Analytics: ${metricKey} (${aggregation})\\n`);\n  lines.push(\n    `Period: ${new Date(startDate).toISOString().split(\"T\")[0]} to ${new Date(endDate).toISOString().split(\"T\")[0]}`\n  );\n  if (params.groupBy) lines.push(`Grouped by: ${params.groupBy}`);\n  lines.push(\"\");\n\n  const currentPeriod = result.currentPeriod ?? [];\n  if (currentPeriod.length === 0) {\n    lines.push(\"No data available for this period.\");\n  } else {\n    lines.push(\"| Date | Value |\");\n    lines.push(\"|------|-------|\");\n    for (const bucket of currentPeriod) {\n      const date = bucket.date;\n      // Find the metric value - it's typically keyed by index\n      const value =\n        Object.entries(bucket).find(\n          ([k]) => k !== \"date\" && typeof bucket[k] === \"number\"\n        )?.[1] ?? \"N/A\";\n      lines.push(`| ${date} | ${value} |`);\n    }\n  }\n\n  lines.push(\n    \"\\n> Tip: Use `discover_schema` to see all available metrics and aggregation types.\"\n  );\n\n  return lines.join(\"\\n\");\n}\n"],"mappings":";;;;;;;;;AASA,eAAsB,mBAAmB,QAQrB;AAClB,QAAM,MAAM,KAAK,IAAI;AACrB,QAAM,YAAY,OAAO,YACrB,kBAAkB,OAAO,SAAS,IAClC,MAAM,IAAI;AACd,QAAM,UAAU,OAAO,UAAU,kBAAkB,OAAO,OAAO,IAAI;AAGrE,QAAM,CAAC,UAAU,IAAI,IAAI,OAAO,OAAO,SAAS,GAAG,IAC/C,OAAO,OAAO,MAAM,KAAK,CAAC,IAC1B,CAAC,YAAY,OAAO,MAAM;AAC9B,QAAM,YAAY,GAAG,QAAQ,IAAI,IAAI;AACrC,QAAM,cAAc,OAAO,eAAe;AAE1C,QAAM,SAAS,MAAM,uBAAgB;AAAA,IACnC,QAAQ,CAAC,EAAE,QAAQ,WAAW,YAAY,CAAC;AAAA,IAC3C;AAAA,IACA;AAAA,IACA,UAAU,OAAO,YAAY;AAAA,IAC7B,SAAS,OAAO;AAAA,IAChB,SAAS,OAAO;AAAA,EAClB,CAAC;AAED,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,gBAAgB,SAAS,KAAK,WAAW;AAAA,CAAK;AACzD,QAAM;AAAA,IACJ,WAAW,IAAI,KAAK,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC,OAAO,IAAI,KAAK,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC;AAAA,EAChH;AACA,MAAI,OAAO,QAAS,OAAM,KAAK,eAAe,OAAO,OAAO,EAAE;AAC9D,QAAM,KAAK,EAAE;AAEb,QAAM,gBAAgB,OAAO,iBAAiB,CAAC;AAC/C,MAAI,cAAc,WAAW,GAAG;AAC9B,UAAM,KAAK,oCAAoC;AAAA,EACjD,OAAO;AACL,UAAM,KAAK,kBAAkB;AAC7B,UAAM,KAAK,kBAAkB;AAC7B,eAAW,UAAU,eAAe;AAClC,YAAM,OAAO,OAAO;AAEpB,YAAM,QACJ,OAAO,QAAQ,MAAM,EAAE;AAAA,QACrB,CAAC,CAAC,CAAC,MAAM,MAAM,UAAU,OAAO,OAAO,CAAC,MAAM;AAAA,MAChD,IAAI,CAAC,KAAK;AACZ,YAAM,KAAK,KAAK,IAAI,MAAM,KAAK,IAAI;AAAA,IACrC;AAAA,EACF;AAEA,QAAM;AAAA,IACJ;AAAA,EACF;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;","names":[]}

package/dist/get-prompt-LKCPT26O.js

@@ -0,0 +1,48 @@
+import {
+  getPrompt
+} from "./chunk-JVWDWL3J.js";
+import "./chunk-AAQNA53E.js";
+
+// src/tools/get-prompt.ts
+async function handleGetPrompt(params) {
+  const prompt = await getPrompt(params.idOrHandle, params.version);
+  const lines = [];
+  lines.push(
+    `# Prompt: ${prompt.name || prompt.handle || prompt.id}
+`
+  );
+  if (prompt.handle) lines.push(`**Handle**: ${prompt.handle}`);
+  if (prompt.id) lines.push(`**ID**: ${prompt.id}`);
+  if (prompt.description) lines.push(`**Description**: ${prompt.description}`);
+  if (prompt.latestVersionNumber != null)
+    lines.push(`**Latest Version**: v${prompt.latestVersionNumber}`);
+  const version = prompt.versions?.[0] ?? prompt;
+  if (version.model) lines.push(`**Model**: ${version.model}`);
+  if (version.modelProvider)
+    lines.push(`**Provider**: ${version.modelProvider}`);
+  const messages = version.messages || prompt.prompt || [];
+  if (Array.isArray(messages) && messages.length > 0) {
+    lines.push("\n## Messages");
+    for (const msg of messages) {
+      lines.push(`
+### ${msg.role}`);
+      lines.push(msg.content);
+    }
+  }
+  if (prompt.versions && prompt.versions.length > 0) {
+    lines.push("\n## Version History");
+    for (const v of prompt.versions.slice(0, 10)) {
+      const versionNum = v.version ?? "?";
+      const commitMsg = v.commitMessage || "No message";
+      lines.push(`- **v${versionNum}**: ${commitMsg}`);
+    }
+    if (prompt.versions.length > 10) {
+      lines.push(`... and ${prompt.versions.length - 10} more versions`);
+    }
+  }
+  return lines.join("\n");
+}
+export {
+  handleGetPrompt
+};
+//# sourceMappingURL=get-prompt-LKCPT26O.js.map

package/dist/get-prompt-LKCPT26O.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tools/get-prompt.ts"],"sourcesContent":["import { getPrompt as apiGetPrompt } from \"../langwatch-api.js\";\n\n/**\n * Handles the get_prompt MCP tool invocation.\n *\n * Retrieves a specific prompt by ID or handle and formats it as\n * AI-readable markdown, including messages, model config, and version history.\n */\nexport async function handleGetPrompt(params: {\n  idOrHandle: string;\n  version?: number;\n}): Promise<string> {\n  const prompt = await apiGetPrompt(params.idOrHandle, params.version);\n\n  const lines: string[] = [];\n  lines.push(\n    `# Prompt: ${prompt.name || prompt.handle || prompt.id}\\n`\n  );\n\n  if (prompt.handle) lines.push(`**Handle**: ${prompt.handle}`);\n  if (prompt.id) lines.push(`**ID**: ${prompt.id}`);\n  if (prompt.description) lines.push(`**Description**: ${prompt.description}`);\n  if (prompt.latestVersionNumber != null)\n    lines.push(`**Latest Version**: v${prompt.latestVersionNumber}`);\n\n  // Show model config\n  const version = prompt.versions?.[0] ?? prompt;\n  if (version.model) lines.push(`**Model**: ${version.model}`);\n  if (version.modelProvider)\n    lines.push(`**Provider**: ${version.modelProvider}`);\n\n  // Show messages\n  const messages = version.messages || prompt.prompt || [];\n  if (Array.isArray(messages) && messages.length > 0) {\n    lines.push(\"\\n## Messages\");\n    for (const msg of messages) {\n      lines.push(`\\n### ${msg.role}`);\n      lines.push(msg.content);\n    }\n  }\n\n  // Show version history\n  if (prompt.versions && prompt.versions.length > 0) {\n    lines.push(\"\\n## Version History\");\n    for (const v of prompt.versions.slice(0, 10)) {\n      const versionNum = v.version ?? \"?\";\n      const commitMsg = v.commitMessage || \"No message\";\n      lines.push(`- **v${versionNum}**: ${commitMsg}`);\n    }\n    if (prompt.versions.length > 10) {\n      lines.push(`... and ${prompt.versions.length - 10} more versions`);\n    }\n  }\n\n  return lines.join(\"\\n\");\n}\n"],"mappings":";;;;;;AAQA,eAAsB,gBAAgB,QAGlB;AAClB,QAAM,SAAS,MAAM,UAAa,OAAO,YAAY,OAAO,OAAO;AAEnE,QAAM,QAAkB,CAAC;AACzB,QAAM;AAAA,IACJ,aAAa,OAAO,QAAQ,OAAO,UAAU,OAAO,EAAE;AAAA;AAAA,EACxD;AAEA,MAAI,OAAO,OAAQ,OAAM,KAAK,eAAe,OAAO,MAAM,EAAE;AAC5D,MAAI,OAAO,GAAI,OAAM,KAAK,WAAW,OAAO,EAAE,EAAE;AAChD,MAAI,OAAO,YAAa,OAAM,KAAK,oBAAoB,OAAO,WAAW,EAAE;AAC3E,MAAI,OAAO,uBAAuB;AAChC,UAAM,KAAK,wBAAwB,OAAO,mBAAmB,EAAE;AAGjE,QAAM,UAAU,OAAO,WAAW,CAAC,KAAK;AACxC,MAAI,QAAQ,MAAO,OAAM,KAAK,cAAc,QAAQ,KAAK,EAAE;AAC3D,MAAI,QAAQ;AACV,UAAM,KAAK,iBAAiB,QAAQ,aAAa,EAAE;AAGrD,QAAM,WAAW,QAAQ,YAAY,OAAO,UAAU,CAAC;AACvD,MAAI,MAAM,QAAQ,QAAQ,KAAK,SAAS,SAAS,GAAG;AAClD,UAAM,KAAK,eAAe;AAC1B,eAAW,OAAO,UAAU;AAC1B,YAAM,KAAK;AAAA,MAAS,IAAI,IAAI,EAAE;AAC9B,YAAM,KAAK,IAAI,OAAO;AAAA,IACxB;AAAA,EACF;AAGA,MAAI,OAAO,YAAY,OAAO,SAAS,SAAS,GAAG;AACjD,UAAM,KAAK,sBAAsB;AACjC,eAAW,KAAK,OAAO,SAAS,MAAM,GAAG,EAAE,GAAG;AAC5C,YAAM,aAAa,EAAE,WAAW;AAChC,YAAM,YAAY,EAAE,iBAAiB;AACrC,YAAM,KAAK,QAAQ,UAAU,OAAO,SAAS,EAAE;AAAA,IACjD;AACA,QAAI,OAAO,SAAS,SAAS,IAAI;AAC/B,YAAM,KAAK,WAAW,OAAO,SAAS,SAAS,EAAE,gBAAgB;AAAA,IACnE;AAAA,EACF;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;","names":[]}

package/dist/get-scenario-3SCDW4Z6.js

@@ -0,0 +1,33 @@
+import {
+  getScenario
+} from "./chunk-K2YFPOSD.js";
+import "./chunk-JVWDWL3J.js";
+import "./chunk-AAQNA53E.js";
+
+// src/tools/get-scenario.ts
+async function handleGetScenario(params) {
+  const scenario = await getScenario(params.scenarioId);
+  if (params.format === "json") {
+    return JSON.stringify(scenario, null, 2);
+  }
+  const lines = [];
+  lines.push(`# Scenario: ${scenario.name}
+`);
+  lines.push(`**ID**: ${scenario.id}`);
+  lines.push(`**Situation**: ${scenario.situation}`);
+  if (Array.isArray(scenario.criteria) && scenario.criteria.length > 0) {
+    lines.push("\n## Criteria");
+    for (const criterion of scenario.criteria) {
+      lines.push(`- ${criterion}`);
+    }
+  }
+  if (Array.isArray(scenario.labels) && scenario.labels.length > 0) {
+    lines.push(`
+**Labels**: ${scenario.labels.join(", ")}`);
+  }
+  return lines.join("\n");
+}
+export {
+  handleGetScenario
+};
+//# sourceMappingURL=get-scenario-3SCDW4Z6.js.map

package/dist/get-scenario-3SCDW4Z6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tools/get-scenario.ts"],"sourcesContent":["import { getScenario as apiGetScenario } from \"../langwatch-api-scenarios.js\";\n\n/**\n * Handles the get_scenario MCP tool invocation.\n *\n * Retrieves a specific scenario by ID and formats it as\n * AI-readable markdown or raw JSON.\n */\nexport async function handleGetScenario(params: {\n  scenarioId: string;\n  format?: \"digest\" | \"json\";\n}): Promise<string> {\n  const scenario = await apiGetScenario(params.scenarioId);\n\n  if (params.format === \"json\") {\n    return JSON.stringify(scenario, null, 2);\n  }\n\n  const lines: string[] = [];\n  lines.push(`# Scenario: ${scenario.name}\\n`);\n  lines.push(`**ID**: ${scenario.id}`);\n  lines.push(`**Situation**: ${scenario.situation}`);\n\n  if (Array.isArray(scenario.criteria) && scenario.criteria.length > 0) {\n    lines.push(\"\\n## Criteria\");\n    for (const criterion of scenario.criteria) {\n      lines.push(`- ${criterion}`);\n    }\n  }\n\n  if (Array.isArray(scenario.labels) && scenario.labels.length > 0) {\n    lines.push(`\\n**Labels**: ${scenario.labels.join(\", \")}`);\n  }\n\n  return lines.join(\"\\n\");\n}\n"],"mappings":";;;;;;;AAQA,eAAsB,kBAAkB,QAGpB;AAClB,QAAM,WAAW,MAAM,YAAe,OAAO,UAAU;AAEvD,MAAI,OAAO,WAAW,QAAQ;AAC5B,WAAO,KAAK,UAAU,UAAU,MAAM,CAAC;AAAA,EACzC;AAEA,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,eAAe,SAAS,IAAI;AAAA,CAAI;AAC3C,QAAM,KAAK,WAAW,SAAS,EAAE,EAAE;AACnC,QAAM,KAAK,kBAAkB,SAAS,SAAS,EAAE;AAEjD,MAAI,MAAM,QAAQ,SAAS,QAAQ,KAAK,SAAS,SAAS,SAAS,GAAG;AACpE,UAAM,KAAK,eAAe;AAC1B,eAAW,aAAa,SAAS,UAAU;AACzC,YAAM,KAAK,KAAK,SAAS,EAAE;AAAA,IAC7B;AAAA,EACF;AAEA,MAAI,MAAM,QAAQ,SAAS,MAAM,KAAK,SAAS,OAAO,SAAS,GAAG;AAChE,UAAM,KAAK;AAAA,cAAiB,SAAS,OAAO,KAAK,IAAI,CAAC,EAAE;AAAA,EAC1D;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;","names":[]}