@langwatch/mcp-server 2.1.0 → 2.2.0

package/dist/get-analytics-R6AZD3AW.js

@@ -1,73 +0,0 @@
-import {
-  parseRelativeDate
-} from "./chunk-ZXKLPC2E.js";
-import {
-  getAnalyticsTimeseries
-} from "./chunk-GELJ2MQR.js";
-import "./chunk-WT4PO4A3.js";
-import "./chunk-SAS5OB7F.js";
-
-// src/tools/get-analytics.ts
-function getGroupedData(bucket, groupBy) {
-  const data = bucket[groupBy];
-  if (typeof data === "object" && data !== null && !Array.isArray(data)) {
-    return data;
-  }
-  return void 0;
-}
-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 if (params.groupBy && currentPeriod.some((b) => getGroupedData(b, params.groupBy) !== void 0)) {
-    lines.push("| Date | Group | Value |");
-    lines.push("|------|-------|-------|");
-    for (const bucket of currentPeriod) {
-      const groups = getGroupedData(bucket, params.groupBy);
-      if (!groups) continue;
-      for (const [groupKey, metrics] of Object.entries(groups)) {
-        const value = Object.values(metrics).find((v) => typeof v === "number") ?? "N/A";
-        lines.push(`| ${bucket.date} | ${groupKey} | ${value} |`);
-      }
-    }
-  } else {
-    lines.push("| Date | Value |");
-    lines.push("|------|-------|");
-    for (const bucket of currentPeriod) {
-      const value = Object.entries(bucket).find(
-        ([k]) => k !== "date" && typeof bucket[k] === "number"
-      )?.[1] ?? "N/A";
-      lines.push(`| ${bucket.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-R6AZD3AW.js.map

package/dist/get-dataset-AKTYSQDI.js

@@ -1,49 +0,0 @@
-import {
-  escapeMarkdown
-} from "./chunk-NUFPTHKU.js";
-import {
-  getDataset
-} from "./chunk-AN4OUA4D.js";
-import "./chunk-GELJ2MQR.js";
-import "./chunk-WT4PO4A3.js";
-import "./chunk-SAS5OB7F.js";
-
-// src/tools/get-dataset.ts
-function formatDatasetResponse(dataset) {
-  const lines = [];
-  lines.push(`# Dataset: ${escapeMarkdown(dataset.name)}
-`);
-  lines.push(`**Slug**: ${escapeMarkdown(dataset.slug)}`);
-  lines.push(`**ID**: ${escapeMarkdown(dataset.id)}`);
-  if (Array.isArray(dataset.columnTypes) && dataset.columnTypes.length > 0) {
-    lines.push("\n## Columns\n");
-    lines.push("| Name | Type |");
-    lines.push("|------|------|");
-    for (const col of dataset.columnTypes) {
-      lines.push(`| ${escapeMarkdown(col.name)} | ${escapeMarkdown(col.type)} |`);
-    }
-  }
-  if (Array.isArray(dataset.data) && dataset.data.length > 0) {
-    lines.push(`
-## Records (${dataset.data.length} shown)
-`);
-    for (const record of dataset.data) {
-      lines.push(`**${escapeMarkdown(record.id)}**: ${escapeMarkdown(JSON.stringify(record.entry))}`);
-    }
-  } else {
-    lines.push("\nNo records in this dataset.");
-  }
-  return lines.join("\n");
-}
-async function handleGetDataset(params) {
-  const dataset = await getDataset(params.slugOrId);
-  if (params.format === "json") {
-    return JSON.stringify(dataset, null, 2);
-  }
-  return formatDatasetResponse(dataset);
-}
-export {
-  formatDatasetResponse,
-  handleGetDataset
-};
-//# sourceMappingURL=get-dataset-AKTYSQDI.js.map

package/dist/index.d.ts

@@ -1,2 +0,0 @@
-
-export {  }

package/dist/langwatch-api-secrets-OEBD6GBU.js

@@ -1,41 +0,0 @@
-import {
-  makeRequest
-} from "./chunk-GELJ2MQR.js";
-import "./chunk-WT4PO4A3.js";
-import "./chunk-SAS5OB7F.js";
-
-// src/langwatch-api-secrets.ts
-async function listSecrets() {
-  return makeRequest("GET", "/api/secrets");
-}
-async function getSecret(id) {
-  return makeRequest(
-    "GET",
-    `/api/secrets/${encodeURIComponent(id)}`
-  );
-}
-async function createSecret(data) {
-  return makeRequest("POST", "/api/secrets", data);
-}
-async function updateSecret(params) {
-  const { id, value } = params;
-  return makeRequest(
-    "PUT",
-    `/api/secrets/${encodeURIComponent(id)}`,
-    { value }
-  );
-}
-async function deleteSecret(id) {
-  return makeRequest(
-    "DELETE",
-    `/api/secrets/${encodeURIComponent(id)}`
-  );
-}
-export {
-  createSecret,
-  deleteSecret,
-  getSecret,
-  listSecrets,
-  updateSecret
-};
-//# sourceMappingURL=langwatch-api-secrets-OEBD6GBU.js.map

package/dist/langwatch-api-triggers-5E6DDGX6.js

@@ -1,31 +0,0 @@
-import {
-  makeRequest
-} from "./chunk-GELJ2MQR.js";
-import "./chunk-WT4PO4A3.js";
-import "./chunk-SAS5OB7F.js";
-
-// src/langwatch-api-triggers.ts
-async function listTriggers() {
-  return makeRequest("GET", "/api/triggers");
-}
-async function getTrigger(id) {
-  return makeRequest("GET", `/api/triggers/${encodeURIComponent(id)}`);
-}
-async function createTrigger(data) {
-  return makeRequest("POST", "/api/triggers", data);
-}
-async function updateTrigger(params) {
-  const { id, ...data } = params;
-  return makeRequest("PATCH", `/api/triggers/${encodeURIComponent(id)}`, data);
-}
-async function deleteTrigger(id) {
-  return makeRequest("DELETE", `/api/triggers/${encodeURIComponent(id)}`);
-}
-export {
-  createTrigger,
-  deleteTrigger,
-  getTrigger,
-  listTriggers,
-  updateTrigger
-};
-//# sourceMappingURL=langwatch-api-triggers-5E6DDGX6.js.map

package/dist/run-agent-CAGWGTYT.js

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

package/dist/search-traces-4XTJYXIK.js

@@ -1,79 +0,0 @@
-import {
-  formatEvaluationLines
-} from "./chunk-37SMPMQS.js";
-import {
-  parseRelativeDate
-} from "./chunk-ZXKLPC2E.js";
-import {
-  searchTraces
-} from "./chunk-GELJ2MQR.js";
-import "./chunk-WT4PO4A3.js";
-import "./chunk-SAS5OB7F.js";
-
-// src/tools/search-traces.ts
-async function handleSearchTraces(params) {
-  const now = Date.now();
-  const startDate = params.startDate ? parseRelativeDate(params.startDate) : now - 864e5;
-  const endDate = params.endDate ? parseRelativeDate(params.endDate) : now;
-  const format = params.format ?? "digest";
-  const result = await searchTraces({
-    query: params.query,
-    filters: params.filters,
-    startDate,
-    endDate,
-    pageSize: params.pageSize ?? 25,
-    scrollId: params.scrollId,
-    format
-  });
-  const traces = result.traces ?? [];
-  if (traces.length === 0) {
-    return "No traces found matching your query.";
-  }
-  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(`### Trace: ${trace.trace_id}`);
-    if (trace.formatted_trace) {
-      lines.push(trace.formatted_trace);
-    } else {
-      const inputStr = trace.input?.value ? String(trace.input.value) : "N/A";
-      const outputStr = trace.output?.value ? String(trace.output.value) : "N/A";
-      lines.push(
-        `- **Input**: ${inputStr.slice(0, 100)}${inputStr.length > 100 ? "..." : ""}`
-      );
-      lines.push(
-        `- **Output**: ${outputStr.slice(0, 100)}${outputStr.length > 100 ? "..." : ""}`
-      );
-    }
-    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("");
-  }
-  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 trace_id 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-4XTJYXIK.js.map

package/src/__tests__/agent-tools.unit.test.ts

@@ -1,257 +0,0 @@
-/**
- * The agent tools with a connected agent: the fields the listing and the
- * detail expose, and the relay a run goes through.
- *
- * @see specs/mcp-server/agent-tools.feature
- */
-import { beforeEach, describe, expect, it, vi } from "vitest";
-
-vi.mock("../langwatch-api.js", async (importOriginal) => {
-  const actual = (await importOriginal()) as Record<string, unknown>;
-  return { ...actual, makeRequest: vi.fn() };
-});
-vi.mock("../public-http-request.js", () => ({ requestPublicJson: vi.fn() }));
-
-import { makeRequest } from "../langwatch-api.js";
-import { runAgent, type AgentSummary } from "../langwatch-api-agents.js";
-import { requestPublicJson } from "../public-http-request.js";
-import { runPlanTargetSchema, toWireTargets } from "../schemas/run-plan.js";
-import { handleGetAgent } from "../tools/get-agent.js";
-import { handleListAgents } from "../tools/list-agents.js";
-import { handleRunAgent } from "../tools/run-agent.js";
-import { handleTestAgent } from "../tools/test-agent.js";
-
-const mockRequest = vi.mocked(makeRequest);
-const mockPublic = vi.mocked(requestPublicJson);
-
-const connectedAgent = (overrides: Partial<AgentSummary> = {}): AgentSummary => ({
-  id: "agent_conn",
-  name: "support-agent",
-  type: "connected",
-  config: null,
-  createdAt: "2026-01-01T00:00:00Z",
-  updatedAt: "2026-01-02T00:00:00Z",
-  environment: "production",
-  status: "online",
-  instances: [
-    { id: "inst_1", hostname: "pod-a", label: "blue", connectedAt: "2026-01-02T00:00:00Z" },
-    { id: "inst_2", hostname: "pod-b", label: null, connectedAt: "2026-01-02T00:01:00Z" },
-  ],
-  owner: { userId: "u1", name: "Ada" },
-  parameters: [
-    { name: "model", type: "string", options: ["gpt-5", "gpt-5-mini"], default: "gpt-5-mini", required: false },
-    { name: "plan", type: "string", required: true, description: "Customer plan" },
-  ],
-  ...overrides,
-});
-
-const httpAgent = (): AgentSummary => ({
-  id: "agent_http",
-  name: "Legacy",
-  type: "http",
-  config: { url: "https://api.example.com/agent" },
-  createdAt: "2026-01-01T00:00:00Z",
-  updatedAt: "2026-01-02T00:00:00Z",
-});
-
-beforeEach(() => {
-  vi.clearAllMocks();
-});
-
-describe("handleListAgents()", () => {
-  describe("when a connected agent and an HTTP agent are listed", () => {
-    /** @scenario "The listing shows environment, status, instances and owner" */
-    /** @scenario "The listing keeps the HTTP agent entry unchanged" */
-    it("shows the connected fields on the connected entry only", async () => {
-      mockRequest.mockResolvedValueOnce({
-        data: [connectedAgent(), httpAgent()],
-        pagination: { page: 1, limit: 100, total: 2, totalPages: 1 },
-      });
-
-      const output = await handleListAgents();
-
-      const [, connected, http] = output.split("## ");
-      expect(connected).toContain("**Environment**: production");
-      expect(connected).toContain("**Status**: online");
-      expect(connected).toContain("**Instances**: 2");
-      expect(connected).toContain("**Owner**: Ada");
-      expect(http).toContain("**Type**: http");
-      expect(http).not.toContain("Environment");
-      expect(http).not.toContain("Status");
-    });
-  });
-
-  describe("when a listed agent belongs to another person", () => {
-    /** @scenario "A listed agent the key cannot choose says so" */
-    it("lists it with its owner and says only its owner can run it", async () => {
-      mockRequest.mockResolvedValueOnce({
-        data: [connectedAgent({ selectable: false, notSelectableReason: "owned_by_another_person" })],
-        pagination: { page: 1, limit: 100, total: 1, totalPages: 1 },
-      });
-
-      const output = await handleListAgents();
-
-      expect(output).toContain("**Owner**: Ada");
-      expect(output).toContain("**Run**: only its owner can run this agent");
-    });
-  });
-});
-
-describe("handleGetAgent()", () => {
-  describe("when the agent declares parameters and has instances", () => {
-    /** @scenario "The detail shows the parameters and the instances" */
-    it("lists each parameter with its type, options, default and required, and each instance", async () => {
-      mockRequest.mockResolvedValueOnce(connectedAgent());
-
-      const output = await handleGetAgent({ id: "agent_conn" });
-
-      expect(output).toContain("## Parameters");
-      expect(output).toContain('- **model** (string, one of gpt-5, gpt-5-mini, default "gpt-5-mini")');
-      expect(output).toContain("- **plan** (string, required): Customer plan");
-      expect(output).toContain("## Instances (2)");
-      expect(output).toContain("- pod-a (blue), connected 2026-01-02T00:00:00Z");
-      expect(output).toContain("- pod-b, connected 2026-01-02T00:01:00Z");
-      expect(output).toContain("**Owner**: Ada");
-    });
-  });
-
-});
-
-describe("handleTestAgent()", () => {
-  describe("when an agent is tested", () => {
-    /** @scenario "The REST route schedules the same run" */
-    it("posts to the test route and reports the run ids to follow", async () => {
-      mockRequest.mockResolvedValueOnce({
-        scenarioRunId: "run_1",
-        batchRunId: "batch_1",
-        setId: "__internal__proj_1__agent-test",
-      });
-
-      const output = await handleTestAgent({ id: "agent_http" });
-
-      expect(mockRequest).toHaveBeenCalledWith("POST", "/api/v1/agents/agent_http/test", {});
-      expect(output).toContain("**Scenario run ID:** run_1");
-      expect(output).toContain("**Batch run ID:** batch_1");
-      expect(output).toContain("platform_get_simulation_run");
-    });
-  });
-});
-
-describe("handleRunAgent()", () => {
-  describe("when the agent is connected and online", () => {
-    /** @scenario "A message runs one turn on a live instance" */
-    it("calls the relay with one user message and the parameters, and reports the instance", async () => {
-      mockRequest.mockResolvedValueOnce(connectedAgent());
-      mockRequest.mockResolvedValueOnce({
-        output: "Sure, I can help.",
-        session: { id: "s1" },
-        instance: { hostname: "pod-a", label: "blue" },
-        durationMs: 321,
-      });
-
-      const output = await handleRunAgent({ id: "agent_conn", message: "hi", parameters: { model: "gpt-5" } });
-
-      expect(mockRequest).toHaveBeenNthCalledWith(2, "POST", "/api/v1/agents/agent_conn/call", {
-        messages: [{ role: "user", content: "hi" }],
-        params: { model: "gpt-5" },
-      });
-      expect(output).toContain("type: connected");
-      expect(output).toContain("Sure, I can help.");
-      expect(output).toContain("**Instance:** pod-a (blue)");
-      expect(output).toContain("**Duration:** 321 ms");
-    });
-
-    /** @scenario "An input with messages is sent as the relay body" */
-    it("sends an input with messages, thread id and session as the body", async () => {
-      mockRequest.mockResolvedValueOnce(connectedAgent());
-      mockRequest.mockResolvedValueOnce({ output: "ok", instance: { hostname: "pod-a" }, durationMs: 1 });
-      const input = JSON.stringify({
-        messages: [{ role: "user", content: "again" }],
-        threadId: "t1",
-        session: { id: "s1" },
-      });
-
-      await handleRunAgent({ id: "agent_conn", input, threadId: "t2" });
-
-      expect(mockRequest).toHaveBeenNthCalledWith(2, "POST", "/api/v1/agents/agent_conn/call", {
-        messages: [{ role: "user", content: "again" }],
-        threadId: "t2",
-        session: { id: "s1" },
-      });
-    });
-
-    /** @scenario "A connected agent needs a conversation" */
-    it("refuses an input with no messages and no message", async () => {
-      mockRequest.mockResolvedValueOnce(connectedAgent());
-
-      await expect(runAgent({ id: "agent_conn", input: { question: "hi" } })).rejects.toThrow(/give `message`, or `input` with a `messages` list/);
-      expect(mockRequest).toHaveBeenCalledTimes(1);
-    });
-
-    it("refuses an offline agent before the relay is called", async () => {
-      mockRequest.mockResolvedValueOnce(connectedAgent({ status: "offline", instances: [] }));
-
-      await expect(runAgent({ id: "agent_conn", message: "hi" })).rejects.toThrow(/is offline/);
-      expect(mockRequest).toHaveBeenCalledTimes(1);
-    });
-
-    /** @scenario "A nested params object is refused before the relay" */
-    it("refuses an input whose params carry a nested object", async () => {
-      mockRequest.mockResolvedValueOnce(connectedAgent());
-
-      await expect(
-        runAgent({
-          id: "agent_conn",
-          input: { messages: [{ role: "user", content: "hi" }], params: { model: { name: "gpt-5" } } },
-        }),
-      ).rejects.toThrow(/flat object of string, number or boolean values/);
-      expect(mockRequest).toHaveBeenCalledTimes(1);
-    });
-  });
-
-  describe("when the input is JSON that is not an object", () => {
-    /** @scenario "An input that is not a JSON object is refused" */
-    it("refuses a scalar, an array and null before the agent is read", async () => {
-      for (const input of ["5", '"hi"', "[1,2]", "null"]) {
-        expect(await handleRunAgent({ id: "agent_conn", input })).toBe(
-          "Error: `input` must be a valid JSON object.",
-        );
-      }
-      expect(mockRequest).not.toHaveBeenCalled();
-    });
-  });
-
-  describe("when the agent is an HTTP agent", () => {
-    /** @scenario "An HTTP agent is still called at its URL" */
-    it("calls the URL directly and not the relay", async () => {
-      mockRequest.mockResolvedValueOnce(httpAgent());
-      mockPublic.mockResolvedValueOnce({ answer: "hi" });
-
-      const output = await handleRunAgent({ id: "agent_http", input: '{"question":"hi"}' });
-
-      expect(mockPublic).toHaveBeenCalledWith("https://api.example.com/agent", expect.objectContaining({ method: "POST" }));
-      expect(mockRequest).toHaveBeenCalledTimes(1);
-      expect(output).toContain("type: http");
-    });
-  });
-});
-
-describe("runPlanTargetSchema", () => {
-  /** @scenario "A connected target names an agent by id" */
-  it("accepts a connected target with an agent id", () => {
-    expect(runPlanTargetSchema.parse({ type: "connected", referenceId: "agent_conn" })).toEqual({
-      type: "connected",
-      referenceId: "agent_conn",
-    });
-  });
-
-  /** @scenario "A connected target names an agent by name and environment" */
-  it("passes name@environment through as the reference id", () => {
-    const targets = toWireTargets([
-      runPlanTargetSchema.parse({ type: "connected", referenceId: "support-agent@production", parameters: { model: "gpt-5" } }),
-    ]);
-    expect(targets).toEqual([
-      { type: "connected", referenceId: "support-agent@production", runParameters: { model: "gpt-5" } },
-    ]);
-  });
-});