@langwatch/mcp-server 0.5.0 → 0.6.0

package/src/tools/create-evaluator.ts

@@ -0,0 +1,33 @@
+import {
+  createEvaluator as apiCreateEvaluator,
+  getEvaluatorType,
+} from "../langwatch-api-evaluators.js";
+
+/**
+ * Handles the platform_create_evaluator MCP tool invocation.
+ *
+ * Creates a new evaluator in the LangWatch project and returns a
+ * confirmation with the created evaluator's details.
+ */
+export async function handleCreateEvaluator(params: {
+  name: string;
+  config: Record<string, unknown>;
+}): Promise<string> {
+  const result = await apiCreateEvaluator(params);
+
+  const evaluatorType = getEvaluatorType(result);
+
+  const lines: string[] = [];
+  lines.push("Evaluator created 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}`);
+  lines.push(`**Kind**: ${result.type}`);
+
+  if (Array.isArray(result.fields) && result.fields.length > 0) {
+    lines.push(`**Input Fields**: ${result.fields.map((f) => f.identifier).join(", ")}`);
+  }
+
+  return lines.join("\n");
+}

package/src/tools/create-prompt.ts

@@ -1,7 +1,23 @@
 import { createPrompt as apiCreatePrompt } from "../langwatch-api.js";
 
+const HANDLE_PATTERN = /^[a-z0-9_-]+(?:\/[a-z0-9_-]+)?$/;
+
 /**
- * Handles the create_prompt MCP tool invocation.
+ * Converts a human-readable name into a URL-friendly handle.
+ *
+ * Lowercases the input, replaces non-alphanumeric runs with hyphens,
+ * and strips leading/trailing hyphens. May return an empty string
+ * for inputs with no alphanumeric characters — callers must validate.
+ */
+function toHandle(name: string): string {
+  return name
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-|-$/g, "");
+}
+
+/**
+ * Handles the platform_create_prompt MCP tool invocation.
  *
  * Creates a new prompt in the LangWatch project and returns a
  * confirmation with the created prompt's details.
@@ -11,17 +27,26 @@ export async function handleCreatePrompt(params: {
   handle?: string;
   messages: Array<{ role: string; content: string }>;
   model: string;
-  modelProvider: string;
-  description?: string;
 }): Promise<string> {
-  const result = await apiCreatePrompt(params);
+  const handle = params.handle?.trim() || toHandle(params.name);
+  if (!handle || !HANDLE_PATTERN.test(handle)) {
+    throw new Error(
+      `Invalid prompt handle "${handle || ""}". Handle must match ${HANDLE_PATTERN}. Provide a valid \`handle\` explicitly.`
+    );
+  }
+
+  const result = await apiCreatePrompt({
+    handle,
+    messages: params.messages,
+    model: params.model,
+  });
 
   const lines: string[] = [];
   lines.push("Prompt created successfully!\n");
   if (result.id) lines.push(`**ID**: ${result.id}`);
   if (result.handle) lines.push(`**Handle**: ${result.handle}`);
   lines.push(`**Name**: ${result.name || params.name}`);
-  lines.push(`**Model**: ${params.model} (${params.modelProvider})`);
+  lines.push(`**Model**: ${params.model}`);
   if (result.latestVersionNumber != null)
     lines.push(`**Version**: v${result.latestVersionNumber}`);
 

package/src/tools/create-scenario.ts

@@ -1,7 +1,7 @@
 import { createScenario as apiCreateScenario } from "../langwatch-api-scenarios.js";
 
 /**
- * Handles the create_scenario MCP tool invocation.
+ * Handles the platform_create_scenario MCP tool invocation.
  *
  * Creates a new scenario in the LangWatch project and returns a
  * confirmation with the created scenario's details.

package/src/tools/discover-evaluator-schema.ts

@@ -0,0 +1,143 @@
+import { AVAILABLE_EVALUATORS } from "../../../langevals/ts-integration/evaluators.generated.js";
+import type { EvaluatorDefinition, EvaluatorTypes } from "../../../langevals/ts-integration/evaluators.generated.js";
+
+/**
+ * Formats evaluator schema information for the discover_schema tool.
+ *
+ * Two levels of detail:
+ * - Overview (no evaluatorType): compact list of all evaluator types
+ * - Detail (with evaluatorType): full schema for one evaluator type
+ */
+export function formatEvaluatorSchema(evaluatorType?: string): string {
+  if (evaluatorType) {
+    return formatEvaluatorDetail(evaluatorType);
+  }
+  return formatEvaluatorOverview();
+}
+
+/**
+ * Returns a compact overview of all available evaluator types.
+ * Shows type, name, category, and a one-line description.
+ */
+function formatEvaluatorOverview(): string {
+  const lines: string[] = [];
+  lines.push("# Available Evaluator Types\n");
+
+  const byCategory = new Map<string, { type: string; name: string; description: string }[]>();
+
+  for (const [type, def] of Object.entries(AVAILABLE_EVALUATORS)) {
+    const evalDef = def as EvaluatorDefinition<EvaluatorTypes>;
+    const oneLine = extractFirstLine(evalDef.description);
+    const entry = { type, name: evalDef.name, description: oneLine };
+
+    const list = byCategory.get(evalDef.category) ?? [];
+    list.push(entry);
+    byCategory.set(evalDef.category, list);
+  }
+
+  for (const [category, entries] of byCategory) {
+    lines.push(`## ${category}\n`);
+    for (const entry of entries) {
+      lines.push(`- **${entry.type}** (${entry.name}): ${entry.description}`);
+    }
+    lines.push("");
+  }
+
+  lines.push(
+    "> Use `discover_schema({ category: 'evaluators', evaluatorType: '<type>' })` for full details on a specific evaluator type.",
+  );
+
+  return lines.join("\n");
+}
+
+/**
+ * Returns the full schema for a specific evaluator type.
+ * Includes settings with descriptions and defaults, required/optional fields, env vars, and result fields.
+ */
+function formatEvaluatorDetail(evaluatorType: string): string {
+  const def = AVAILABLE_EVALUATORS[evaluatorType as EvaluatorTypes] as
+    | EvaluatorDefinition<EvaluatorTypes>
+    | undefined;
+
+  if (!def) {
+    return `Unknown evaluator type: "${evaluatorType}". Use \`discover_schema({ category: 'evaluators' })\` to see all available types.`;
+  }
+
+  const lines: string[] = [];
+  lines.push(`# ${def.name} (\`${evaluatorType}\`)\n`);
+  lines.push(`**Category**: ${def.category}`);
+  lines.push(`**Is Guardrail**: ${def.isGuardrail ? "Yes" : "No"}`);
+  if (def.docsUrl) {
+    lines.push(`**Docs**: ${def.docsUrl}`);
+  }
+  lines.push("");
+  lines.push(`## Description\n`);
+  lines.push(def.description.trim());
+
+  // Required and optional fields
+  lines.push("\n## Fields\n");
+  if (def.requiredFields.length > 0) {
+    lines.push(`**Required**: ${def.requiredFields.join(", ")}`);
+  } else {
+    lines.push("**Required**: none");
+  }
+  if (def.optionalFields.length > 0) {
+    lines.push(`**Optional**: ${def.optionalFields.join(", ")}`);
+  }
+
+  // Settings
+  const settingsEntries = Object.entries(def.settings);
+  if (settingsEntries.length > 0) {
+    lines.push("\n## Settings\n");
+    for (const [key, setting] of settingsEntries) {
+      const s = setting as { description?: string; default: unknown };
+      const defaultStr = JSON.stringify(s.default);
+      const desc = s.description ? ` - ${s.description}` : "";
+      lines.push(`- **${key}**${desc}`);
+      lines.push(`  Default: \`${defaultStr}\``);
+    }
+  }
+
+  // Env vars
+  if (def.envVars.length > 0) {
+    lines.push("\n## Required Environment Variables\n");
+    for (const envVar of def.envVars) {
+      lines.push(`- \`${envVar}\``);
+    }
+  }
+
+  // Result fields
+  const resultEntries = Object.entries(def.result);
+  if (resultEntries.length > 0) {
+    lines.push("\n## Result Fields\n");
+    for (const [key, value] of resultEntries) {
+      const v = value as { description: string };
+      lines.push(`- **${key}**: ${v.description}`);
+    }
+  }
+
+  lines.push("\n## Usage Example\n");
+  lines.push("```json");
+  lines.push(JSON.stringify({
+    evaluatorType: evaluatorType,
+    settings: Object.fromEntries(
+      settingsEntries.map(([key, setting]) => [key, (setting as { default: unknown }).default]),
+    ),
+  }, null, 2));
+  lines.push("```");
+
+  return lines.join("\n");
+}
+
+/**
+ * Extracts the first meaningful line from a multi-line description.
+ */
+function extractFirstLine(description: string): string {
+  const trimmed = description.trim();
+  const firstLine = trimmed.split("\n")[0]?.trim() ?? trimmed;
+  // Limit to a reasonable length
+  if (firstLine.length > 120) {
+    return firstLine.slice(0, 117) + "...";
+  }
+  return firstLine;
+}

package/src/tools/get-evaluator.ts

@@ -0,0 +1,53 @@
+import {
+  getEvaluator as apiGetEvaluator,
+  getEvaluatorType,
+} from "../langwatch-api-evaluators.js";
+
+/**
+ * Handles the platform_get_evaluator MCP tool invocation.
+ *
+ * Retrieves a specific evaluator by ID or slug and formats it as
+ * AI-readable markdown.
+ */
+export async function handleGetEvaluator(params: {
+  idOrSlug: string;
+}): Promise<string> {
+  const evaluator = await apiGetEvaluator(params.idOrSlug);
+
+  const evaluatorType = getEvaluatorType(evaluator);
+
+  const lines: string[] = [];
+  lines.push(`# Evaluator: ${evaluator.name}\n`);
+  lines.push(`**ID**: ${evaluator.id}`);
+  if (evaluator.slug) lines.push(`**Slug**: ${evaluator.slug}`);
+  lines.push(`**Kind**: ${evaluator.type}`);
+  if (evaluatorType) lines.push(`**Evaluator Type**: ${evaluatorType}`);
+
+  if (evaluator.config) {
+    lines.push("\n## Config");
+    lines.push("```json");
+    lines.push(JSON.stringify(evaluator.config, null, 2));
+    lines.push("```");
+  }
+
+  if (Array.isArray(evaluator.fields) && evaluator.fields.length > 0) {
+    lines.push("\n## Input Fields");
+    for (const field of evaluator.fields) {
+      const opt = field.optional ? " (optional)" : "";
+      lines.push(`- **${field.identifier}** (${field.type})${opt}`);
+    }
+  }
+
+  if (Array.isArray(evaluator.outputFields) && evaluator.outputFields.length > 0) {
+    lines.push("\n## Output Fields");
+    for (const field of evaluator.outputFields) {
+      lines.push(`- **${field.identifier}** (${field.type})`);
+    }
+  }
+
+  if (evaluator.workflowName) {
+    lines.push(`\n**Workflow**: ${evaluator.workflowName}`);
+  }
+
+  return lines.join("\n");
+}

package/src/tools/get-prompt.ts

@@ -1,7 +1,7 @@
 import { getPrompt as apiGetPrompt } from "../langwatch-api.js";
 
 /**
- * Handles the get_prompt MCP tool invocation.
+ * Handles the platform_get_prompt MCP tool invocation.
  *
  * Retrieves a specific prompt by ID or handle and formats it as
  * AI-readable markdown, including messages, model config, and version history.
@@ -19,15 +19,12 @@ export async function handleGetPrompt(params: {
 
   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}`);
 
   // Show model config
   const version = prompt.versions?.[0] ?? prompt;
   if (version.model) lines.push(`**Model**: ${version.model}`);
-  if (version.modelProvider)
-    lines.push(`**Provider**: ${version.modelProvider}`);
 
   // Show messages
   const messages = version.messages || prompt.prompt || [];

package/src/tools/list-evaluators.ts

@@ -0,0 +1,37 @@
+import {
+  listEvaluators as apiListEvaluators,
+  getEvaluatorType,
+} from "../langwatch-api-evaluators.js";
+
+/**
+ * Handles the platform_list_evaluators MCP tool invocation.
+ *
+ * Lists all evaluators in the LangWatch project, formatted as an
+ * AI-readable digest.
+ */
+export async function handleListEvaluators(): Promise<string> {
+  const evaluators = await apiListEvaluators();
+
+  if (!Array.isArray(evaluators) || evaluators.length === 0) {
+    return "No evaluators found in this project.\n\n> Tip: Use `platform_create_evaluator` to create your first evaluator. Call `discover_schema({ category: 'evaluators' })` to see available evaluator types.";
+  }
+
+  const lines: string[] = [];
+  lines.push(`# Evaluators (${evaluators.length} total)\n`);
+
+  for (const e of evaluators) {
+    const evaluatorType = getEvaluatorType(e);
+    lines.push(`## ${e.name}`);
+    lines.push(`**ID**: ${e.id}`);
+    if (e.slug) lines.push(`**Slug**: ${e.slug}`);
+    if (evaluatorType) lines.push(`**Type**: ${evaluatorType}`);
+    lines.push(`**Kind**: ${e.type}`);
+    lines.push("");
+  }
+
+  lines.push(
+    "> Use `platform_get_evaluator` with the ID or slug to see full evaluator details.",
+  );
+
+  return lines.join("\n");
+}

package/src/tools/list-model-providers.ts

@@ -0,0 +1,40 @@
+import { listModelProviders as apiListModelProviders } from "../langwatch-api-model-providers.js";
+
+/**
+ * Handles the platform_list_model_providers MCP tool invocation.
+ *
+ * Lists all model providers for the project, showing provider name,
+ * enabled status, and which key fields are set (masked).
+ */
+export async function handleListModelProviders(): Promise<string> {
+  const providers = await apiListModelProviders();
+
+  const entries = Object.entries(providers);
+  if (entries.length === 0) {
+    return "No model providers configured for this project.\n\n> Tip: Use `platform_set_model_provider` to configure an API key for a model provider.";
+  }
+
+  const lines: string[] = [];
+  lines.push(`# Model Providers (${entries.length} total)\n`);
+
+  for (const [key, provider] of entries) {
+    const status = provider.enabled ? "enabled" : "disabled";
+    lines.push(`## ${key}`);
+    lines.push(`**Status**: ${status}`);
+
+    if (provider.customKeys) {
+      const keyFields = Object.entries(provider.customKeys)
+        .map(([k, v]) => `${k}: ${v ? "set" : "not set"}`)
+        .join(", ");
+      lines.push(`**Keys**: ${keyFields}`);
+    }
+
+    if (provider.models && provider.models.length > 0) {
+      lines.push(`**Models**: ${provider.models.length} available`);
+    }
+
+    lines.push("");
+  }
+
+  return lines.join("\n");
+}

package/src/tools/list-prompts.ts

@@ -1,7 +1,7 @@
 import { listPrompts as apiListPrompts } from "../langwatch-api.js";
 
 /**
- * Handles the list_prompts MCP tool invocation.
+ * Handles the platform_list_prompts MCP tool invocation.
  *
  * Lists all prompts in the LangWatch project, formatted as an
  * AI-readable markdown table.
@@ -15,20 +15,19 @@ export async function handleListPrompts(): Promise<string> {
 
   const lines: string[] = [];
   lines.push(`# Prompts (${prompts.length} total)\n`);
-  lines.push("| Handle | Name | Latest Version | Description |");
-  lines.push("|--------|------|----------------|-------------|");
+  lines.push("| Handle | Name | Latest Version |");
+  lines.push("|--------|------|----------------|");
 
   for (const p of prompts) {
     const handle = p.handle || p.id || "N/A";
     const name = p.name || "Untitled";
     const versionNum = p.latestVersionNumber ?? p.version;
     const version = versionNum != null ? `v${versionNum}` : "N/A";
-    const desc = (p.description || "").slice(0, 60);
-    lines.push(`| ${handle} | ${name} | ${version} | ${desc} |`);
+    lines.push(`| ${handle} | ${name} | ${version} |`);
   }
 
   lines.push(
-    "\n> Use `get_prompt` with the handle or ID to see full prompt details."
+    "\n> Use `platform_get_prompt` with the handle or ID to see full prompt details."
   );
 
   return lines.join("\n");

package/src/tools/list-scenarios.ts

@@ -1,7 +1,7 @@
 import { listScenarios as apiListScenarios } from "../langwatch-api-scenarios.js";
 
 /**
- * Handles the list_scenarios MCP tool invocation.
+ * Handles the platform_list_scenarios MCP tool invocation.
  *
  * Lists all scenarios in the LangWatch project, formatted as an
  * AI-readable digest or raw JSON.
@@ -16,7 +16,7 @@ export async function handleListScenarios(params: {
   }
 
   if (!Array.isArray(scenarios) || scenarios.length === 0) {
-    return "No scenarios found in this project.\n\n> Tip: Use `create_scenario` to create your first scenario.";
+    return "No scenarios found in this project.\n\n> Tip: Use `platform_create_scenario` to create your first scenario.";
   }
 
   const lines: string[] = [];
@@ -40,7 +40,7 @@ export async function handleListScenarios(params: {
   }
 
   lines.push(
-    "> Use `get_scenario` with the ID to see full scenario details.",
+    "> Use `platform_get_scenario` with the ID to see full scenario details.",
   );
 
   return lines.join("\n");

package/src/tools/set-model-provider.ts

@@ -0,0 +1,46 @@
+import { setModelProvider as apiSetModelProvider } from "../langwatch-api-model-providers.js";
+
+/**
+ * Handles the platform_set_model_provider MCP tool invocation.
+ *
+ * Creates or updates a model provider configuration, including API keys.
+ * Returns confirmation with the updated provider status.
+ */
+export async function handleSetModelProvider(params: {
+  provider: string;
+  enabled: boolean;
+  customKeys?: Record<string, unknown>;
+  defaultModel?: string;
+}): Promise<string> {
+  const providers = await apiSetModelProvider(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: string[] = [];
+  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) {
+    // Show the normalized model name (with provider prefix)
+    const normalizedModel = params.defaultModel.includes("/")
+      ? params.defaultModel
+      : `${params.provider}/${params.defaultModel}`;
+    lines.push(`**Default Model**: ${normalizedModel}`);
+  }
+
+  return lines.join("\n");
+}

package/src/tools/update-evaluator.ts

@@ -0,0 +1,30 @@
+import {
+  updateEvaluator as apiUpdateEvaluator,
+  getEvaluatorType,
+} from "../langwatch-api-evaluators.js";
+
+/**
+ * Handles the platform_update_evaluator MCP tool invocation.
+ *
+ * Updates an existing evaluator and returns a confirmation
+ * with the updated details.
+ */
+export async function handleUpdateEvaluator(params: {
+  evaluatorId: string;
+  name?: string;
+  config?: Record<string, unknown>;
+}): Promise<string> {
+  const { evaluatorId, ...data } = params;
+  const result = await apiUpdateEvaluator({ id: evaluatorId, ...data });
+
+  const evaluatorType = getEvaluatorType(result);
+
+  const lines: string[] = [];
+  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");
+}

package/src/tools/update-prompt.ts

@@ -1,44 +1,28 @@
-import {
-  updatePrompt as apiUpdatePrompt,
-  createPromptVersion as apiCreateVersion,
-} from "../langwatch-api.js";
-import type { PromptMutationResponse } from "../langwatch-api.js";
+import { updatePrompt as apiUpdatePrompt } from "../langwatch-api.js";
 
 /**
- * Handles the update_prompt MCP tool invocation.
+ * Handles the platform_update_prompt MCP tool invocation.
  *
- * Updates an existing prompt or creates a new version, depending on the
- * `createVersion` flag. Returns a confirmation with the updated details.
+ * Updates an existing prompt via the PUT endpoint.
+ * Every update with a commitMessage creates a new version automatically.
  */
 export async function handleUpdatePrompt(params: {
   idOrHandle: string;
   messages?: Array<{ role: string; content: string }>;
   model?: string;
-  modelProvider?: string;
-  commitMessage?: string;
-  createVersion?: boolean;
+  commitMessage: string;
 }): Promise<string> {
-  const { idOrHandle, createVersion, ...data } = params;
+  const { idOrHandle, ...data } = params;
 
-  let result: PromptMutationResponse;
-  if (createVersion) {
-    result = await apiCreateVersion(idOrHandle, data);
-  } else {
-    result = await apiUpdatePrompt(idOrHandle, data);
-  }
+  const result = await apiUpdatePrompt(idOrHandle, data);
 
   const lines: string[] = [];
-  lines.push(
-    createVersion
-      ? "New version created successfully!\n"
-      : "Prompt updated successfully!\n"
-  );
+  lines.push("Prompt updated successfully!\n");
   if (result.id) lines.push(`**ID**: ${result.id}`);
   if (result.handle) lines.push(`**Handle**: ${result.handle}`);
   if (result.latestVersionNumber != null)
     lines.push(`**Version**: v${result.latestVersionNumber}`);
-  if (params.commitMessage)
-    lines.push(`**Commit**: ${params.commitMessage}`);
+  lines.push(`**Commit**: ${params.commitMessage}`);
 
   return lines.join("\n");
 }

package/src/tools/update-scenario.ts

@@ -1,7 +1,7 @@
 import { updateScenario as apiUpdateScenario } from "../langwatch-api-scenarios.js";
 
 /**
- * Handles the update_scenario MCP tool invocation.
+ * Handles the platform_update_scenario MCP tool invocation.
  *
  * Updates an existing scenario and returns a confirmation
  * with the updated details.

package/dist/archive-scenario-GAE4XVFM.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/tools/archive-scenario.ts"],"sourcesContent":["import { archiveScenario as apiArchiveScenario } from \"../langwatch-api-scenarios.js\";\n\n/**\n * Handles the archive_scenario MCP tool invocation.\n *\n * Archives (soft-deletes) a scenario and returns confirmation.\n */\nexport async function handleArchiveScenario(params: {\n  scenarioId: string;\n}): Promise<string> {\n  const result = await apiArchiveScenario(params.scenarioId);\n\n  const lines: string[] = [];\n  lines.push(\"Scenario archived successfully!\\n\");\n  lines.push(`**ID**: ${result.id}`);\n  lines.push(`**Status**: ${result.archived ? \"archived\" : \"active\"}`);\n\n  return lines.join(\"\\n\");\n}\n"],"mappings":";;;;;;;AAOA,eAAsB,sBAAsB,QAExB;AAClB,QAAM,SAAS,MAAM,gBAAmB,OAAO,UAAU;AAEzD,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,mCAAmC;AAC9C,QAAM,KAAK,WAAW,OAAO,EAAE,EAAE;AACjC,QAAM,KAAK,eAAe,OAAO,WAAW,aAAa,QAAQ,EAAE;AAEnE,SAAO,MAAM,KAAK,IAAI;AACxB;","names":[]}

package/dist/chunk-JVWDWL3J.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/langwatch-api.ts"],"sourcesContent":["import { getConfig, requireApiKey } from \"./config.js\";\n\n// --- Response types ---\n\nexport interface TraceSearchResult {\n  trace_id: string;\n  formatted_trace?: string;\n  input?: { value: string };\n  output?: { value: string };\n  timestamps?: { started_at?: string | number };\n  metadata?: Record<string, unknown>;\n  error?: Record<string, unknown>;\n}\n\nexport interface SearchTracesResponse {\n  traces: TraceSearchResult[];\n  pagination?: {\n    totalHits?: number;\n    scrollId?: string;\n  };\n}\n\nexport interface TraceDetailResponse {\n  trace_id: string;\n  formatted_trace?: string;\n  input?: { value: string };\n  output?: { value: string };\n  timestamps?: {\n    started_at?: string | number;\n    updated_at?: string | number;\n    inserted_at?: string | number;\n  };\n  metadata?: {\n    user_id?: string;\n    thread_id?: string;\n    customer_id?: string;\n    labels?: string[];\n    [key: string]: unknown;\n  };\n  error?: Record<string, unknown>;\n  ascii_tree?: string;\n  evaluations?: Array<{\n    evaluator_id?: string;\n    name?: string;\n    score?: number;\n    passed?: boolean;\n    label?: string;\n  }>;\n  spans?: Array<{\n    span_id: string;\n    name?: string;\n    type?: string;\n    model?: string;\n    input?: { value: string };\n    output?: { value: string };\n    timestamps?: { started_at?: number; finished_at?: number };\n    metrics?: {\n      completion_time_ms?: number;\n      prompt_tokens?: number;\n      completion_tokens?: number;\n      tokens_estimated?: boolean;\n      cost?: number;\n    };\n  }>;\n}\n\nexport interface AnalyticsBucket {\n  date: string;\n  [key: string]: unknown;\n}\n\nexport interface AnalyticsTimeseriesResponse {\n  currentPeriod: AnalyticsBucket[];\n  previousPeriod: AnalyticsBucket[];\n}\n\nexport interface PromptSummary {\n  id?: string;\n  handle?: string;\n  name?: string;\n  description?: string | null;\n  latestVersionNumber?: number;\n  version?: number;\n}\n\nexport interface PromptVersion {\n  version?: number;\n  commitMessage?: string;\n  model?: string;\n  modelProvider?: string;\n  messages?: Array<{ role: string; content: string }>;\n}\n\nexport interface PromptDetailResponse extends PromptSummary {\n  versions?: PromptVersion[];\n  model?: string;\n  modelProvider?: string;\n  messages?: Array<{ role: string; content: string }>;\n  prompt?: Array<{ role: string; content: string }>;\n}\n\nexport interface PromptMutationResponse {\n  id?: string;\n  handle?: string;\n  name?: string;\n  latestVersionNumber?: number;\n}\n\n// --- HTTP client ---\n\n/**\n * Sends an HTTP request to the LangWatch API.\n *\n * Builds the full URL from the configured endpoint, adds authentication,\n * and handles JSON serialization/deserialization.\n *\n * @throws Error with status code and response body when the response is not OK\n */\nexport async function makeRequest(\n  method: \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\",\n  path: string,\n  body?: unknown\n): Promise<unknown> {\n  const url = getConfig().endpoint + path;\n  const headers: Record<string, string> = {\n    \"X-Auth-Token\": requireApiKey(),\n  };\n\n  if (body !== undefined) {\n    headers[\"Content-Type\"] = \"application/json\";\n  }\n\n  const response = await fetch(url, {\n    method,\n    headers,\n    ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n  });\n\n  if (!response.ok) {\n    const responseBody = await response.text();\n    throw new Error(\n      `LangWatch API error ${response.status}: ${responseBody}`\n    );\n  }\n\n  return response.json();\n}\n\n/** Searches traces with optional filters and pagination. */\nexport async function searchTraces(params: {\n  query?: string;\n  filters?: Record<string, string[]>;\n  startDate: number;\n  endDate: number;\n  pageSize?: number;\n  pageOffset?: number;\n  scrollId?: string;\n  format?: \"digest\" | \"json\";\n}): Promise<SearchTracesResponse> {\n  const { format = \"digest\", ...rest } = params;\n  return makeRequest(\"POST\", \"/api/traces/search\", {\n    ...rest,\n    format,\n  }) as Promise<SearchTracesResponse>;\n}\n\n/** Retrieves a single trace by its ID. */\nexport async function getTraceById(\n  traceId: string,\n  format: \"digest\" | \"json\" = \"digest\"\n): Promise<TraceDetailResponse> {\n  return makeRequest(\n    \"GET\",\n    `/api/traces/${encodeURIComponent(traceId)}?format=${format}`\n  ) as Promise<TraceDetailResponse>;\n}\n\n/** Fetches analytics timeseries data for the given metrics and date range. */\nexport async function getAnalyticsTimeseries(params: {\n  series: Array<{\n    metric: string;\n    aggregation: string;\n    key?: string;\n    subkey?: string;\n  }>;\n  startDate: number;\n  endDate: number;\n  timeZone?: string;\n  groupBy?: string;\n  groupByKey?: string;\n  filters?: Record<string, string[]>;\n}): Promise<AnalyticsTimeseriesResponse> {\n  return makeRequest(\n    \"POST\",\n    \"/api/analytics/timeseries\",\n    params\n  ) as Promise<AnalyticsTimeseriesResponse>;\n}\n\n/** Lists all prompts in the project. */\nexport async function listPrompts(): Promise<PromptSummary[]> {\n  return makeRequest(\"GET\", \"/api/prompts\") as Promise<PromptSummary[]>;\n}\n\n/** Retrieves a single prompt by ID or handle. */\nexport async function getPrompt(\n  idOrHandle: string,\n  version?: number\n): Promise<PromptDetailResponse> {\n  const query = version != null ? `?version=${version}` : \"\";\n  return makeRequest(\n    \"GET\",\n    `/api/prompts/${encodeURIComponent(idOrHandle)}${query}`\n  ) as Promise<PromptDetailResponse>;\n}\n\n/** Creates a new prompt. */\nexport async function createPrompt(data: {\n  name: string;\n  handle?: string;\n  messages: Array<{ role: string; content: string }>;\n  model: string;\n  modelProvider: string;\n  description?: string;\n}): Promise<PromptMutationResponse> {\n  return makeRequest(\n    \"POST\",\n    \"/api/prompts\",\n    data\n  ) as Promise<PromptMutationResponse>;\n}\n\n/** Updates an existing prompt by ID or handle. */\nexport async function updatePrompt(\n  idOrHandle: string,\n  data: {\n    messages?: Array<{ role: string; content: string }>;\n    model?: string;\n    modelProvider?: string;\n    commitMessage?: string;\n  }\n): Promise<PromptMutationResponse> {\n  return makeRequest(\n    \"POST\",\n    `/api/prompts/${encodeURIComponent(idOrHandle)}`,\n    data\n  ) as Promise<PromptMutationResponse>;\n}\n\n/** Creates a new version of an existing prompt. */\nexport async function createPromptVersion(\n  idOrHandle: string,\n  data: {\n    messages?: Array<{ role: string; content: string }>;\n    model?: string;\n    modelProvider?: string;\n    commitMessage?: string;\n  }\n): Promise<PromptMutationResponse> {\n  return makeRequest(\n    \"POST\",\n    `/api/prompts/${encodeURIComponent(idOrHandle)}/versions`,\n    data\n  ) as Promise<PromptMutationResponse>;\n}\n\n"],"mappings":";;;;;;AAsHA,eAAsB,YACpB,QACA,MACA,MACkB;AAClB,QAAM,MAAM,UAAU,EAAE,WAAW;AACnC,QAAM,UAAkC;AAAA,IACtC,gBAAgB,cAAc;AAAA,EAChC;AAEA,MAAI,SAAS,QAAW;AACtB,YAAQ,cAAc,IAAI;AAAA,EAC5B;AAEA,QAAM,WAAW,MAAM,MAAM,KAAK;AAAA,IAChC;AAAA,IACA;AAAA,IACA,GAAI,SAAS,SAAY,EAAE,MAAM,KAAK,UAAU,IAAI,EAAE,IAAI,CAAC;AAAA,EAC7D,CAAC;AAED,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,eAAe,MAAM,SAAS,KAAK;AACzC,UAAM,IAAI;AAAA,MACR,uBAAuB,SAAS,MAAM,KAAK,YAAY;AAAA,IACzD;AAAA,EACF;AAEA,SAAO,SAAS,KAAK;AACvB;AAGA,eAAsB,aAAa,QASD;AAChC,QAAM,EAAE,SAAS,UAAU,GAAG,KAAK,IAAI;AACvC,SAAO,YAAY,QAAQ,sBAAsB;AAAA,IAC/C,GAAG;AAAA,IACH;AAAA,EACF,CAAC;AACH;AAGA,eAAsB,aACpB,SACA,SAA4B,UACE;AAC9B,SAAO;AAAA,IACL;AAAA,IACA,eAAe,mBAAmB,OAAO,CAAC,WAAW,MAAM;AAAA,EAC7D;AACF;AAGA,eAAsB,uBAAuB,QAaJ;AACvC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAGA,eAAsB,cAAwC;AAC5D,SAAO,YAAY,OAAO,cAAc;AAC1C;AAGA,eAAsB,UACpB,YACA,SAC+B;AAC/B,QAAM,QAAQ,WAAW,OAAO,YAAY,OAAO,KAAK;AACxD,SAAO;AAAA,IACL;AAAA,IACA,gBAAgB,mBAAmB,UAAU,CAAC,GAAG,KAAK;AAAA,EACxD;AACF;AAGA,eAAsB,aAAa,MAOC;AAClC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAGA,eAAsB,aACpB,YACA,MAMiC;AACjC,SAAO;AAAA,IACL;AAAA,IACA,gBAAgB,mBAAmB,UAAU,CAAC;AAAA,IAC9C;AAAA,EACF;AACF;AAGA,eAAsB,oBACpB,YACA,MAMiC;AACjC,SAAO;AAAA,IACL;AAAA,IACA,gBAAgB,mBAAmB,UAAU,CAAC;AAAA,IAC9C;AAAA,EACF;AACF;","names":[]}

package/dist/create-prompt-P35POKBW.js

@@ -1,22 +0,0 @@
-import {
-  createPrompt
-} from "./chunk-JVWDWL3J.js";
-import "./chunk-AAQNA53E.js";
-
-// src/tools/create-prompt.ts
-async function handleCreatePrompt(params) {
-  const result = await createPrompt(params);
-  const lines = [];
-  lines.push("Prompt created successfully!\n");
-  if (result.id) lines.push(`**ID**: ${result.id}`);
-  if (result.handle) lines.push(`**Handle**: ${result.handle}`);
-  lines.push(`**Name**: ${result.name || params.name}`);
-  lines.push(`**Model**: ${params.model} (${params.modelProvider})`);
-  if (result.latestVersionNumber != null)
-    lines.push(`**Version**: v${result.latestVersionNumber}`);
-  return lines.join("\n");
-}
-export {
-  handleCreatePrompt
-};
-//# sourceMappingURL=create-prompt-P35POKBW.js.map

package/dist/create-prompt-P35POKBW.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/tools/create-prompt.ts"],"sourcesContent":["import { createPrompt as apiCreatePrompt } from \"../langwatch-api.js\";\n\n/**\n * Handles the create_prompt MCP tool invocation.\n *\n * Creates a new prompt in the LangWatch project and returns a\n * confirmation with the created prompt's details.\n */\nexport async function handleCreatePrompt(params: {\n  name: string;\n  handle?: string;\n  messages: Array<{ role: string; content: string }>;\n  model: string;\n  modelProvider: string;\n  description?: string;\n}): Promise<string> {\n  const result = await apiCreatePrompt(params);\n\n  const lines: string[] = [];\n  lines.push(\"Prompt created successfully!\\n\");\n  if (result.id) lines.push(`**ID**: ${result.id}`);\n  if (result.handle) lines.push(`**Handle**: ${result.handle}`);\n  lines.push(`**Name**: ${result.name || params.name}`);\n  lines.push(`**Model**: ${params.model} (${params.modelProvider})`);\n  if (result.latestVersionNumber != null)\n    lines.push(`**Version**: v${result.latestVersionNumber}`);\n\n  return lines.join(\"\\n\");\n}\n"],"mappings":";;;;;;AAQA,eAAsB,mBAAmB,QAOrB;AAClB,QAAM,SAAS,MAAM,aAAgB,MAAM;AAE3C,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,gCAAgC;AAC3C,MAAI,OAAO,GAAI,OAAM,KAAK,WAAW,OAAO,EAAE,EAAE;AAChD,MAAI,OAAO,OAAQ,OAAM,KAAK,eAAe,OAAO,MAAM,EAAE;AAC5D,QAAM,KAAK,aAAa,OAAO,QAAQ,OAAO,IAAI,EAAE;AACpD,QAAM,KAAK,cAAc,OAAO,KAAK,KAAK,OAAO,aAAa,GAAG;AACjE,MAAI,OAAO,uBAAuB;AAChC,UAAM,KAAK,iBAAiB,OAAO,mBAAmB,EAAE;AAE1D,SAAO,MAAM,KAAK,IAAI;AACxB;","names":[]}

package/dist/create-scenario-3YRZVDYF.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/tools/create-scenario.ts"],"sourcesContent":["import { createScenario as apiCreateScenario } from \"../langwatch-api-scenarios.js\";\n\n/**\n * Handles the create_scenario MCP tool invocation.\n *\n * Creates a new scenario in the LangWatch project and returns a\n * confirmation with the created scenario's details.\n */\nexport async function handleCreateScenario(params: {\n  name: string;\n  situation: string;\n  criteria?: string[];\n  labels?: string[];\n}): Promise<string> {\n  const result = await apiCreateScenario(params);\n\n  const lines: string[] = [];\n  lines.push(\"Scenario created successfully!\\n\");\n  lines.push(`**ID**: ${result.id}`);\n  lines.push(`**Name**: ${result.name}`);\n  lines.push(`**Situation**: ${result.situation}`);\n  if (Array.isArray(result.criteria) && result.criteria.length > 0) {\n    lines.push(`**Criteria**: ${result.criteria.length} criteria`);\n  }\n  if (Array.isArray(result.labels) && result.labels.length > 0) {\n    lines.push(`**Labels**: ${result.labels.join(\", \")}`);\n  }\n\n  return lines.join(\"\\n\");\n}\n"],"mappings":";;;;;;;AAQA,eAAsB,qBAAqB,QAKvB;AAClB,QAAM,SAAS,MAAM,eAAkB,MAAM;AAE7C,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,kCAAkC;AAC7C,QAAM,KAAK,WAAW,OAAO,EAAE,EAAE;AACjC,QAAM,KAAK,aAAa,OAAO,IAAI,EAAE;AACrC,QAAM,KAAK,kBAAkB,OAAO,SAAS,EAAE;AAC/C,MAAI,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO,SAAS,SAAS,GAAG;AAChE,UAAM,KAAK,iBAAiB,OAAO,SAAS,MAAM,WAAW;AAAA,EAC/D;AACA,MAAI,MAAM,QAAQ,OAAO,MAAM,KAAK,OAAO,OAAO,SAAS,GAAG;AAC5D,UAAM,KAAK,eAAe,OAAO,OAAO,KAAK,IAAI,CAAC,EAAE;AAAA,EACtD;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;","names":[]}