@langwatch/mcp-server 2.1.0 → 3.0.0

package/src/langwatch-api-test-suites.ts

@@ -1,20 +1,12 @@
-import { makeRequest } from "./langwatch-api.js";
-import type {
-  RunParameters,
-  RunPlanRunResult,
-} from "./langwatch-api-run-plans.js";
-import type { RunPlanTargetWire } from "./schemas/run-plan.js";
-import type {
-  EvaluatorAttachmentWire,
-  SuiteField,
-} from "./schemas/suite-fields.js";
+import type { RunParameters, RunPlanRunResult } from "./langwatch-api-run-plans.ts";
+import { makeRequest } from "./langwatch-api.ts";
+import type { RunPlanTargetWire } from "./schemas/run-plan.ts";
+import type { EvaluatorAttachmentWire, SuiteField } from "./schemas/suite-fields.ts";
 
 /**
- * Client for `/api/v1/test-suites`.
- *
- * A test suite groups scenarios: a name and the scenarios filed in it.
- * Running one is sugar over a run plan, so the run returns the same result a
- * run plan does.
+ * Client for `/api/v1/test-suites`. A test suite groups scenarios by
+ * name; running one is sugar over a run plan, returning the same
+ * result shape.
  */
 
 export interface TestSuite {
@@ -34,7 +26,7 @@ export interface TestSuite {
 }
 
 export interface TestSuiteDetail extends TestSuite {
-  scenarios: Array<{ id: string; name: string }>;
+  scenarios: { id: string; name: string }[];
 }
 
 export interface TestSuiteArchiveResponse {
@@ -53,11 +45,7 @@ export async function createTestSuite(data: {
   fields?: SuiteField[];
   evaluators?: EvaluatorAttachmentWire[];
 }): Promise<TestSuite> {
-  return makeRequest(
-    "POST",
-    "/api/v1/test-suites",
-    data,
-  ) as Promise<TestSuite>;
+  return makeRequest("POST", "/api/v1/test-suites", data) as Promise<TestSuite>;
 }
 
 /** Retrieves a test suite with the scenarios filed in it. */
@@ -87,21 +75,14 @@ export async function updateTestSuite(params: {
 }
 
 /** Renames a test suite. */
-export async function renameTestSuite(params: {
-  id: string;
-  name: string;
-}): Promise<TestSuite> {
-  return makeRequest(
-    "PATCH",
-    `/api/v1/test-suites/${encodeURIComponent(params.id)}`,
-    { name: params.name },
-  ) as Promise<TestSuite>;
+export async function renameTestSuite(params: { id: string; name: string }): Promise<TestSuite> {
+  return makeRequest("PATCH", `/api/v1/test-suites/${encodeURIComponent(params.id)}`, {
+    name: params.name,
+  }) as Promise<TestSuite>;
 }
 
 /** Archives a test suite and the scenarios filed in it. */
-export async function archiveTestSuite(
-  id: string,
-): Promise<TestSuiteArchiveResponse> {
+export async function archiveTestSuite(id: string): Promise<TestSuiteArchiveResponse> {
   return makeRequest(
     "DELETE",
     `/api/v1/test-suites/${encodeURIComponent(id)}`,

package/src/langwatch-api-triggers.ts

@@ -1,48 +1,110 @@
-import { makeRequest } from "./langwatch-api.js";
+import { z } from "zod";
 
-export interface TriggerSummary {
-  id: string;
-  name: string;
-  action: string;
-  actionParams: Record<string, unknown>;
-  filters: Record<string, unknown>;
-  active: boolean;
-  message: string | null;
-  alertType: string | null;
-  createdAt: string;
-  updatedAt: string;
-}
+import { makeRequest } from "./langwatch-api.ts";
+import {
+  deletedTriggerSchema,
+  type GraphAlertRule,
+  type NotificationCadence,
+  type ReportRule,
+  type TestFireResult,
+  type Trigger,
+  type TriggerAction,
+  type TriggerActionParams,
+  type TriggerAlertType,
+  type TriggerFirePage,
+  type TriggerTemplates,
+  testFireResultSchema,
+  triggerFirePageSchema,
+  triggerSchema,
+} from "./schemas/triggers.ts";
 
-export async function listTriggers(): Promise<TriggerSummary[]> {
-  return makeRequest("GET", "/api/triggers") as Promise<TriggerSummary[]>;
-}
+/**
+ * The `/api/v1/triggers` calls, each answering with the shape `schemas/triggers` declares.
+ * Responses are read through that schema, not cast, so a deployment that stops sending something
+ * a tool renders fails loudly instead of leaving an `undefined` in an agent's message.
+ */
 
-export async function getTrigger(id: string): Promise<TriggerSummary> {
-  return makeRequest("GET", `/api/triggers/${encodeURIComponent(id)}`) as Promise<TriggerSummary>;
-}
-
-export async function createTrigger(data: {
+export interface CreateTriggerInput {
   name: string;
-  action: string;
-  actionParams?: Record<string, unknown>;
+  action: TriggerAction;
+  /** Omitted sends `{}`, as before `actionParams` was stated per channel. */
+  actionParams?: TriggerActionParams;
   filters?: Record<string, unknown>;
+  filterQuery?: string | null;
   message?: string;
-  alertType?: string;
-}): Promise<TriggerSummary> {
-  return makeRequest("POST", "/api/triggers", data) as Promise<TriggerSummary>;
+  alertType?: TriggerAlertType;
+  customGraphId?: string;
+  graphAlert?: GraphAlertRule;
+  report?: ReportRule;
+  templates?: TriggerTemplates;
+  notificationCadence?: NotificationCadence;
 }
 
-export async function updateTrigger(params: {
+/** `actionParams` replaces the delivery configuration as a whole; a credential
+ *  sent back as `[redacted]` keeps the stored one. The channel cannot change. */
+type UpdateTriggerInput = Partial<
+  Omit<CreateTriggerInput, "action" | "customGraphId" | "message" | "alertType">
+> & {
   id: string;
-  name?: string;
   active?: boolean;
   message?: string | null;
-  alertType?: string | null;
-}): Promise<TriggerSummary> {
-  const { id, ...data } = params;
-  return makeRequest("PATCH", `/api/triggers/${encodeURIComponent(id)}`, data) as Promise<TriggerSummary>;
+  alertType?: TriggerAlertType | null;
+};
+
+export async function listTriggers(): Promise<Trigger[]> {
+  return z.array(triggerSchema).parse(await makeRequest("GET", "/api/v1/triggers"));
+}
+
+export async function getTrigger(id: string): Promise<Trigger> {
+  return triggerSchema.parse(
+    await makeRequest("GET", `/api/v1/triggers/${encodeURIComponent(id)}`),
+  );
+}
+
+export async function createTrigger(input: CreateTriggerInput): Promise<Trigger> {
+  return triggerSchema.parse(
+    await makeRequest("POST", "/api/v1/triggers", {
+      ...input,
+      actionParams: input.actionParams ?? {},
+    }),
+  );
+}
+
+export async function updateTrigger({ id, ...data }: UpdateTriggerInput): Promise<Trigger> {
+  return triggerSchema.parse(
+    await makeRequest("PATCH", `/api/v1/triggers/${encodeURIComponent(id)}`, data),
+  );
+}
+
+/** Send the automation's message to the destination it is saved with. */
+export async function testFireTrigger(id: string): Promise<TestFireResult> {
+  return testFireResultSchema.parse(
+    await makeRequest("POST", `/api/v1/triggers/${encodeURIComponent(id)}/test-fire`),
+  );
+}
+
+/** What the automation has done, newest first. Metadata only. `cursor` reads
+ *  the page after the one that answered with it as `nextCursor`. */
+export async function listTriggerFires({
+  id,
+  limit,
+  cursor,
+}: {
+  id: string;
+  limit?: number;
+  cursor?: string;
+}): Promise<TriggerFirePage> {
+  const query = new URLSearchParams();
+  if (limit !== undefined) query.set("limit", String(limit));
+  if (cursor) query.set("cursor", cursor);
+  const search = query.toString() ? `?${query.toString()}` : "";
+  return triggerFirePageSchema.parse(
+    await makeRequest("GET", `/api/v1/triggers/${encodeURIComponent(id)}/fires${search}`),
+  );
 }
 
-export async function deleteTrigger(id: string): Promise<{ id: string; deleted: boolean }> {
-  return makeRequest("DELETE", `/api/triggers/${encodeURIComponent(id)}`) as Promise<{ id: string; deleted: boolean }>;
+export async function deleteTrigger(id: string): Promise<z.infer<typeof deletedTriggerSchema>> {
+  return deletedTriggerSchema.parse(
+    await makeRequest("DELETE", `/api/v1/triggers/${encodeURIComponent(id)}`),
+  );
 }

package/src/langwatch-api-workflows.ts

@@ -1,4 +1,4 @@
-import { makeRequest } from "./langwatch-api.js";
+import { makeRequest } from "./langwatch-api.ts";
 
 export interface WorkflowSummary {
   id: string;
@@ -12,30 +12,30 @@ export interface WorkflowSummary {
 }
 
 export async function listWorkflows(): Promise<WorkflowSummary[]> {
-  return makeRequest("GET", "/api/workflows") as Promise<WorkflowSummary[]>;
+  return makeRequest("GET", "/api/v1/workflows") as Promise<WorkflowSummary[]>;
 }
 
 export async function getWorkflow(id: string): Promise<WorkflowSummary> {
   return makeRequest(
     "GET",
-    `/api/workflows/${encodeURIComponent(id)}`,
+    `/api/v1/workflows/${encodeURIComponent(id)}`,
   ) as Promise<WorkflowSummary>;
 }
 
 export async function runWorkflow(
   id: string,
-  input?: Record<string, unknown>
+  input?: Record<string, unknown>,
 ): Promise<Record<string, unknown>> {
   return makeRequest(
     "POST",
-    `/api/workflows/${encodeURIComponent(id)}/run`,
+    `/api/v1/workflows/${encodeURIComponent(id)}/run`,
     input ?? {},
   ) as Promise<Record<string, unknown>>;
 }
 
 export async function deleteWorkflow(id: string): Promise<{ id: string; archived: boolean }> {
-  return makeRequest(
-    "DELETE",
-    `/api/workflows/${encodeURIComponent(id)}`,
-  ) as Promise<{ id: string; archived: boolean }>;
+  return makeRequest("DELETE", `/api/v1/workflows/${encodeURIComponent(id)}`) as Promise<{
+    id: string;
+    archived: boolean;
+  }>;
 }