@avallon-labs/mcp 56.0.0 → 57.1.0-staging.1289

package/dist/index.js

@@ -46,5 +46,5 @@ function setupFetch() {
 
 // src/index.ts
 setupFetch();
-await import("./server-BWBH4XI6.js");
+await import("./server-3JZUJX4G.js");
 //# sourceMappingURL=index.js.map

package/dist/{server-BWBH4XI6.js → server-3JZUJX4G.js}

@@ -2914,6 +2914,59 @@ var deleteSecret = async (secretId, options) => {
   const data = body ? JSON.parse(body) : {};
   return { data, status: res.status, headers: res.headers };
 };
+var getCreateEvaluatorUrl = () => {
+  return `/v1/evaluators`;
+};
+var createEvaluator = async (createEvaluatorBody, options) => {
+  const getHeaders = (h) => {
+    if (!h) return {};
+    if (h instanceof Headers) return Object.fromEntries(h.entries());
+    if (Array.isArray(h)) return Object.fromEntries(h);
+    return h;
+  };
+  const res = await fetch(
+    getCreateEvaluatorUrl(),
+    {
+      ...options,
+      method: "POST",
+      headers: { "Content-Type": "application/json", ...getHeaders(options?.headers) },
+      body: JSON.stringify(createEvaluatorBody)
+    }
+  );
+  const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+  const data = body ? JSON.parse(body) : {};
+  return { data, status: res.status, headers: res.headers };
+};
+var getListEvaluatorsUrl = () => {
+  return `/v1/evaluators`;
+};
+var listEvaluators = async (options) => {
+  const res = await fetch(
+    getListEvaluatorsUrl(),
+    {
+      ...options,
+      method: "GET"
+    }
+  );
+  const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+  const data = body ? JSON.parse(body) : {};
+  return { data, status: res.status, headers: res.headers };
+};
+var getGetEvaluatorUrl = (evaluatorSlug) => {
+  return `/v1/evaluators/${evaluatorSlug}`;
+};
+var getEvaluator = async (evaluatorSlug, options) => {
+  const res = await fetch(
+    getGetEvaluatorUrl(evaluatorSlug),
+    {
+      ...options,
+      method: "GET"
+    }
+  );
+  const body = [204, 205, 304].includes(res.status) ? null : await res.text();
+  const data = body ? JSON.parse(body) : {};
+  return { data, status: res.status, headers: res.headers };
+};
 var getCreateScheduleUrl = () => {
   return `/v1/schedules`;
 };
@@ -7137,6 +7190,75 @@ var deleteSecretHandler = async (args, options) => {
     structuredContent: res.data
   };
 };
+var createEvaluatorHandler = async (args, options) => {
+  const res = await createEvaluator(args.bodyParams, options);
+  if (res.status >= 400) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(res.data ?? null)
+        }
+      ],
+      isError: true
+    };
+  }
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(res.data ?? null)
+      }
+    ],
+    structuredContent: res.data
+  };
+};
+var listEvaluatorsHandler = async (options) => {
+  const res = await listEvaluators(options);
+  if (res.status >= 400) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(res.data ?? null)
+        }
+      ],
+      isError: true
+    };
+  }
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(res.data ?? null)
+      }
+    ],
+    structuredContent: res.data
+  };
+};
+var getEvaluatorHandler = async (args, options) => {
+  const res = await getEvaluator(args.pathParams.evaluatorSlug, options);
+  if (res.status >= 400) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(res.data ?? null)
+        }
+      ],
+      isError: true
+    };
+  }
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(res.data ?? null)
+      }
+    ],
+    structuredContent: res.data
+  };
+};
 var createScheduleHandler = async (args, options) => {
   const res = await createSchedule(args.bodyParams, options);
   if (res.status >= 400) {
@@ -8418,6 +8540,8 @@ var updateVoiceAgentBodyTtsVoiceIdMax = 256;
 var updateVoiceAgentBodyTtsVoiceIdRegExp = new RegExp("^[^\\u0000-\\u001f\\u007f]+$");
 var updateVoiceAgentBodyFallbackTtsVoiceIdOneMax = 256;
 var updateVoiceAgentBodyFallbackTtsVoiceIdOneRegExp = new RegExp("^[^\\u0000-\\u001f\\u007f]+$");
+var updateVoiceAgentBodyEvaluatorSlugOneMax = 100;
+var updateVoiceAgentBodyEvaluatorSlugOneRegExp = new RegExp("^[a-z0-9]+(?:[-_][a-z0-9]+)*$");
 var UpdateVoiceAgentBody = zod.object({
   "name": zod.string().min(1).optional(),
   "call_processor_id": zod.union([zod.string().uuid(), zod.null()]).optional(),
@@ -8441,6 +8565,7 @@ var UpdateVoiceAgentBody = zod.object({
   "dial_pad": zod.boolean().optional().describe("Allow the caller to send dial pad (DTMF) input."),
   "end_call": zod.boolean().optional().describe("Allow the agent to hang up the call."),
   "transfer_phone_number": zod.union([zod.string(), zod.null()]).optional().describe("Phone number calls are transferred to. null removes it."),
+  "evaluator_slug": zod.union([zod.string().max(updateVoiceAgentBodyEvaluatorSlugOneMax).regex(updateVoiceAgentBodyEvaluatorSlugOneRegExp), zod.null()]).optional().describe("Evaluator that scores this agent's calls, created with `POST /v1/evaluators`. null detaches it. Omit to leave unchanged."),
   "prompt": zod.string().min(1).optional().describe("System prompt. Requires the `prompts:write` permission."),
   "greeting": zod.union([zod.string().min(1), zod.null()]).optional().describe("Greeting spoken at the start of the call. null removes it. Requires the `prompts:write` permission.")
 });
@@ -12046,6 +12171,67 @@ var DeleteSecretResponse = zod.object({
   "data": zod.object({}),
   "message": zod.string()
 });
+var createEvaluatorBodySlugMax = 100;
+var createEvaluatorBodySlugRegExp = new RegExp("^[a-z0-9]+(?:[-_][a-z0-9]+)*$");
+var createEvaluatorBodyMetricsItemSlugMax = 100;
+var createEvaluatorBodyMetricsItemSlugRegExp = new RegExp("^[a-z0-9]+(?:[-_][a-z0-9]+)*$");
+var createEvaluatorBodyMetricsItemNameMax = 200;
+var createEvaluatorBodyMetricsItemQuestionMax = 1e4;
+var createEvaluatorBodyMetricsMax = 50;
+var CreateEvaluatorBody = zod.object({
+  "slug": zod.string().max(createEvaluatorBodySlugMax).regex(createEvaluatorBodySlugRegExp).describe("Unique evaluator slug within the tenant, e.g. `support-quality-v1`"),
+  "metrics": zod.array(zod.object({
+    "slug": zod.string().max(createEvaluatorBodyMetricsItemSlugMax).regex(createEvaluatorBodyMetricsItemSlugRegExp).describe("Stable metric identifier"),
+    "name": zod.string().min(1).max(createEvaluatorBodyMetricsItemNameMax),
+    "question": zod.string().min(1).max(createEvaluatorBodyMetricsItemQuestionMax).describe("The exact criterion and scoring rubric the judge receives. Score 0 to 1; 0.5 or higher passes.")
+  })).min(1).max(createEvaluatorBodyMetricsMax)
+});
+var CreateEvaluatorResponse = zod.object({
+  "data": zod.object({
+    "slug": zod.string().describe("Evaluator slug"),
+    "metrics": zod.array(zod.object({
+      "id": zod.string(),
+      "slug": zod.string(),
+      "name": zod.string(),
+      "question": zod.string().describe("Criterion and scoring rubric passed to the judge"),
+      "created_at": zod.string().datetime({ "offset": true })
+    }))
+  }),
+  "message": zod.string()
+});
+var ListEvaluatorsResponse = zod.object({
+  "data": zod.object({
+    "evaluators": zod.array(zod.object({
+      "slug": zod.string().describe("Evaluator slug"),
+      "metrics": zod.array(zod.object({
+        "id": zod.string(),
+        "slug": zod.string(),
+        "name": zod.string(),
+        "question": zod.string().describe("Criterion and scoring rubric passed to the judge"),
+        "created_at": zod.string().datetime({ "offset": true })
+      }))
+    }))
+  }),
+  "message": zod.string()
+});
+var getEvaluatorPathEvaluatorSlugMax = 100;
+var getEvaluatorPathEvaluatorSlugRegExp = new RegExp("^[a-z0-9]+(?:[-_][a-z0-9]+)*$");
+var GetEvaluatorParams = zod.object({
+  "evaluatorSlug": zod.string().max(getEvaluatorPathEvaluatorSlugMax).regex(getEvaluatorPathEvaluatorSlugRegExp)
+});
+var GetEvaluatorResponse = zod.object({
+  "data": zod.object({
+    "slug": zod.string().describe("Evaluator slug"),
+    "metrics": zod.array(zod.object({
+      "id": zod.string(),
+      "slug": zod.string(),
+      "name": zod.string(),
+      "question": zod.string().describe("Criterion and scoring rubric passed to the judge"),
+      "created_at": zod.string().datetime({ "offset": true })
+    }))
+  }),
+  "message": zod.string()
+});
 var createScheduleBodyRuleTwoPatternsItemMinuteMin = 0;
 var createScheduleBodyRuleTwoPatternsItemMinuteMax = 59;
 var createScheduleBodyRuleTwoPatternsItemHoursOneItemMin = 0;
@@ -12058,11 +12244,14 @@ var createScheduleBodyRuleTwoPatternsItemWeekdaysDefault = null;
 var createScheduleBodyRuleTwoPatternsMax = 10;
 var createScheduleBodyNameMax = 200;
 var CreateScheduleBody = zod.object({
-  "action": zod.object({
+  "action": zod.union([zod.object({
     "type": zod.literal("trigger_worker"),
     "worker_id": zod.string().uuid(),
     "scope": zod.union([zod.record(zod.string(), zod.union([zod.string(), zod.number(), zod.boolean(), zod.null()])), zod.null()]).optional().describe("Scope of the runs this schedule creates. Omit or send null to run without artifacts.")
-  }).describe("What the schedule does every time it fires"),
+  }), zod.object({
+    "type": zod.literal("execute_tool"),
+    "tool_id": zod.string().uuid()
+  })]).describe("What the schedule does every time it fires"),
   "rule": zod.union([zod.object({
     "type": zod.literal("once"),
     "at": zod.string().datetime({ "offset": true }).describe('The moment it fires, in UTC, e.g. "2026-09-01T14:00:00Z"')
@@ -12075,7 +12264,7 @@ var CreateScheduleBody = zod.object({
       "weekdays": zod.union([zod.array(zod.number().int().min(1).max(createScheduleBodyRuleTwoPatternsItemWeekdaysOneItemMax).describe("ISO-8601 weekday, 1 = Monday through 7 = Sunday")).min(1).max(createScheduleBodyRuleTwoPatternsItemWeekdaysOneMax), zod.null()]).default(createScheduleBodyRuleTwoPatternsItemWeekdaysDefault).describe("Local ISO-8601 weekdays the pattern may fire on. Omit or send null to fire every day.")
     }).describe("One set of local times a schedule fires at")).min(1).max(createScheduleBodyRuleTwoPatternsMax).describe("The schedule fires whenever any of these patterns comes round, all read in the rule's time zone.")
   })]).describe("When the schedule fires"),
-  "environments": zod.array(zod.enum(["live", "test"])).optional().describe("Environments the schedule fires in. `live` resolves the worker at its live version, `test` at its test version. Listing both fires every occurrence twice, once per version."),
+  "environments": zod.array(zod.enum(["live", "test"])).optional().describe("Environments the schedule fires in. `live` resolves the worker or tool at its live version, `test` at its test version. Listing both fires every occurrence twice, once per version."),
   "name": zod.string().min(1).max(createScheduleBodyNameMax).optional().describe('Human-readable name, e.g. "Nightly claim sweep"'),
   "enabled": zod.boolean().optional().describe("Whether the schedule starts firing right away. Defaults to true. Must be omitted or true for `once` rules.")
 });
@@ -12093,11 +12282,14 @@ var CreateScheduleResponse = zod.object({
   "data": zod.object({
     "id": zod.string().describe("Unique identifier for the schedule"),
     "name": zod.union([zod.string(), zod.null()]).describe("Optional human-readable name"),
-    "action": zod.object({
+    "action": zod.union([zod.object({
       "type": zod.literal("trigger_worker"),
       "worker_id": zod.string().uuid(),
       "scope": zod.union([zod.record(zod.string(), zod.union([zod.string(), zod.number(), zod.boolean(), zod.null()])), zod.null()]).optional().describe("Scope of the runs this schedule creates. Omit or send null to run without artifacts.")
-    }).describe("What the schedule does every time it fires"),
+    }), zod.object({
+      "type": zod.literal("execute_tool"),
+      "tool_id": zod.string().uuid()
+    })]).describe("What the schedule does every time it fires"),
     "rule": zod.union([zod.object({
       "type": zod.literal("once"),
       "at": zod.string().datetime({ "offset": true }).describe('The moment it fires, in UTC, e.g. "2026-09-01T14:00:00Z"')
@@ -12149,11 +12341,14 @@ var ListSchedulesResponse = zod.object({
   "data": zod.array(zod.object({
     "id": zod.string().describe("Unique identifier for the schedule"),
     "name": zod.union([zod.string(), zod.null()]).describe("Optional human-readable name"),
-    "action": zod.object({
+    "action": zod.union([zod.object({
       "type": zod.literal("trigger_worker"),
       "worker_id": zod.string().uuid(),
       "scope": zod.union([zod.record(zod.string(), zod.union([zod.string(), zod.number(), zod.boolean(), zod.null()])), zod.null()]).optional().describe("Scope of the runs this schedule creates. Omit or send null to run without artifacts.")
-    }).describe("What the schedule does every time it fires"),
+    }), zod.object({
+      "type": zod.literal("execute_tool"),
+      "tool_id": zod.string().uuid()
+    })]).describe("What the schedule does every time it fires"),
     "rule": zod.union([zod.object({
       "type": zod.literal("once"),
       "at": zod.string().datetime({ "offset": true }).describe('The moment it fires, in UTC, e.g. "2026-09-01T14:00:00Z"')
@@ -12195,11 +12390,14 @@ var GetScheduleResponse = zod.object({
   "data": zod.object({
     "id": zod.string().describe("Unique identifier for the schedule"),
     "name": zod.union([zod.string(), zod.null()]).describe("Optional human-readable name"),
-    "action": zod.object({
+    "action": zod.union([zod.object({
       "type": zod.literal("trigger_worker"),
       "worker_id": zod.string().uuid(),
       "scope": zod.union([zod.record(zod.string(), zod.union([zod.string(), zod.number(), zod.boolean(), zod.null()])), zod.null()]).optional().describe("Scope of the runs this schedule creates. Omit or send null to run without artifacts.")
-    }).describe("What the schedule does every time it fires"),
+    }), zod.object({
+      "type": zod.literal("execute_tool"),
+      "tool_id": zod.string().uuid()
+    })]).describe("What the schedule does every time it fires"),
     "rule": zod.union([zod.object({
       "type": zod.literal("once"),
       "at": zod.string().datetime({ "offset": true }).describe('The moment it fires, in UTC, e.g. "2026-09-01T14:00:00Z"')
@@ -12248,7 +12446,7 @@ var UpdateScheduleBody = zod.object({
       "weekdays": zod.union([zod.array(zod.number().int().min(1).max(updateScheduleBodyRuleTwoPatternsItemWeekdaysOneItemMax).describe("ISO-8601 weekday, 1 = Monday through 7 = Sunday")).min(1).max(updateScheduleBodyRuleTwoPatternsItemWeekdaysOneMax), zod.null()]).default(updateScheduleBodyRuleTwoPatternsItemWeekdaysDefault).describe("Local ISO-8601 weekdays the pattern may fire on. Omit or send null to fire every day.")
     }).describe("One set of local times a schedule fires at")).min(1).max(updateScheduleBodyRuleTwoPatternsMax).describe("The schedule fires whenever any of these patterns comes round, all read in the rule's time zone.")
   })]).optional().describe("When the schedule fires"),
-  "environments": zod.array(zod.enum(["live", "test"])).optional().describe("Environments the schedule fires in. `live` resolves the worker at its live version, `test` at its test version. Listing both fires every occurrence twice, once per version."),
+  "environments": zod.array(zod.enum(["live", "test"])).optional().describe("Environments the schedule fires in. `live` resolves the worker or tool at its live version, `test` at its test version. Listing both fires every occurrence twice, once per version."),
   "name": zod.union([zod.string().min(1).max(updateScheduleBodyNameOneMax), zod.null()]).optional().describe("Human-readable name. Send null to clear it."),
   "enabled": zod.boolean().optional().describe("Whether the schedule fires. Disabled never fires. Must be omitted or true for `once` rules.")
 });
@@ -12266,11 +12464,14 @@ var UpdateScheduleResponse = zod.object({
   "data": zod.object({
     "id": zod.string().describe("Unique identifier for the schedule"),
     "name": zod.union([zod.string(), zod.null()]).describe("Optional human-readable name"),
-    "action": zod.object({
+    "action": zod.union([zod.object({
       "type": zod.literal("trigger_worker"),
       "worker_id": zod.string().uuid(),
       "scope": zod.union([zod.record(zod.string(), zod.union([zod.string(), zod.number(), zod.boolean(), zod.null()])), zod.null()]).optional().describe("Scope of the runs this schedule creates. Omit or send null to run without artifacts.")
-    }).describe("What the schedule does every time it fires"),
+    }), zod.object({
+      "type": zod.literal("execute_tool"),
+      "tool_id": zod.string().uuid()
+    })]).describe("What the schedule does every time it fires"),
     "rule": zod.union([zod.object({
       "type": zod.literal("once"),
       "at": zod.string().datetime({ "offset": true }).describe('The moment it fires, in UTC, e.g. "2026-09-01T14:00:00Z"')
@@ -12323,7 +12524,7 @@ var ListDispatchesResponse = zod.object({
       "id": zod.string()
     }),
     "target": zod.union([zod.object({
-      "type": zod.enum(["worker_run", "extractor_job"]),
+      "type": zod.enum(["worker_run", "extractor_job", "tool_call"]),
       "id": zod.string()
     }), zod.null()]),
     "due_at": zod.string().datetime({ "offset": true }),
@@ -13790,7 +13991,7 @@ var createMcpServer = (options) => {
     "updateVoiceAgent",
     {
       title: "Update voice agent",
-      description: "Update a voice agent. Only the fields you send change; omitted fields keep their current value.\n\nTo change the processor assignment, `call_processor_id` and `call_processor_type` must be provided together. Set `call_processor_id` to `null` to detach (`call_processor_type` is still required).\n\nModel fields (`llm_model`, `tts_provider`, `tts_model`, `tts_voice_id`, `stt_model`, `language` and their `fallback_*` counterparts) are validated against the agent's resulting configuration, so a single field such as `tts_voice_id` can be sent on its own as long as it fits the current provider and model.\n\nSet `voice_mail_detection` to `true` to have the agent listen for a voicemail beep tone. Detection only runs on `OUTBOUND` agents; enabling it on an `INBOUND` agent is stored but has no effect.\n\nSet `max_call_duration_seconds` to change how long a call may run before the agent ends it (default 1800).\n\nSet `noise_cancellation` to choose the noise cancellation mode applied to the caller audio.\n\nSet `tool_ids` to replace the agent's attached tool set. This is the supported way to manage tool attachments; the dedicated add and remove endpoints are deprecated.\n\nSetting `prompt` or `greeting` requires the `prompts:write` permission.\n\nAll changes in one request create a single new voice agent config version. The live and test releases keep pointing at their current versions until the new version is promoted.",
+      description: "Update a voice agent. Only the fields you send change; omitted fields keep their current value.\n\nTo change the processor assignment, `call_processor_id` and `call_processor_type` must be provided together. Set `call_processor_id` to `null` to detach (`call_processor_type` is still required).\n\nModel fields (`llm_model`, `tts_provider`, `tts_model`, `tts_voice_id`, `stt_model`, `language` and their `fallback_*` counterparts) are validated against the agent's resulting configuration, so a single field such as `tts_voice_id` can be sent on its own as long as it fits the current provider and model.\n\nSet `voice_mail_detection` to `true` to have the agent listen for a voicemail beep tone. Detection only runs on `OUTBOUND` agents; enabling it on an `INBOUND` agent is stored but has no effect.\n\nSet `max_call_duration_seconds` to change how long a call may run before the agent ends it (default 1800).\n\nSet `noise_cancellation` to choose the noise cancellation mode applied to the caller audio.\n\nSet `tool_ids` to replace the agent's attached tool set. This is the supported way to manage tool attachments; the dedicated add and remove endpoints are deprecated.\n\nSet `evaluator_slug` to score the agent's calls with that evaluator. Calls only use it once the new version is promoted, because a call is evaluated with the version it ran on.\n\nSetting `prompt` or `greeting` requires the `prompts:write` permission.\n\nAll changes in one request create a single new voice agent config version. The live and test releases keep pointing at their current versions until the new version is promoted.",
       inputSchema: {
         pathParams: UpdateVoiceAgentParams,
         bodyParams: UpdateVoiceAgentBody.optional()
@@ -16025,11 +16226,56 @@ var createMcpServer = (options) => {
       signal: options?.signal ? AbortSignal.any([options.signal, ctx.signal]) : ctx.signal
     })
   );
+  tools.createEvaluator = server2.registerTool(
+    "createEvaluator",
+    {
+      title: "Create an evaluator",
+      description: "Create an evaluator: a named set of metrics that an LLM judge scores every call of the voice agents it is attached to.\n\nEvaluators can't be changed after creation, so past call scores keep their meaning. To change the criteria, create a new evaluator (e.g. `support-quality-v2`) and attach that instead. A slug that already exists returns 409.\n\nAttach it to a voice agent with `PATCH /v1/voice-agents/{voiceAgentId}` (`evaluator_slug`), then promote that version. Requires the `voice-agents:write` permission.",
+      inputSchema: {
+        bodyParams: CreateEvaluatorBody.optional()
+      },
+      outputSchema: CreateEvaluatorResponse,
+      annotations: { destructiveHint: true }
+    },
+    (args, ctx) => createEvaluatorHandler(args, {
+      ...options,
+      signal: options?.signal ? AbortSignal.any([options.signal, ctx.signal]) : ctx.signal
+    })
+  );
+  tools.listEvaluators = server2.registerTool(
+    "listEvaluators",
+    {
+      title: "List evaluators",
+      description: "List all evaluators of the tenant with their metrics.",
+      outputSchema: ListEvaluatorsResponse,
+      annotations: { readOnlyHint: true }
+    },
+    (ctx) => listEvaluatorsHandler({
+      ...options,
+      signal: options?.signal ? AbortSignal.any([options.signal, ctx.signal]) : ctx.signal
+    })
+  );
+  tools.getEvaluator = server2.registerTool(
+    "getEvaluator",
+    {
+      title: "Get an evaluator",
+      description: "Retrieve an evaluator and the metrics its judge scores.",
+      inputSchema: {
+        pathParams: GetEvaluatorParams
+      },
+      outputSchema: GetEvaluatorResponse,
+      annotations: { readOnlyHint: true }
+    },
+    (args, ctx) => getEvaluatorHandler(args, {
+      ...options,
+      signal: options?.signal ? AbortSignal.any([options.signal, ctx.signal]) : ctx.signal
+    })
+  );
   tools.createSchedule = server2.registerTool(
     "createSchedule",
     {
       title: "Create a schedule",
-      description: "Create a schedule that performs an action, either repeatedly or once.\n\n`action` describes **what** happens \u2014 today only `trigger_worker`, which starts a worker run with the given scope. `rule` describes **when**: `recurring` carries one or more `patterns`, and fires whenever any of them comes round. A pattern fires every hour at `minute`, narrowed by `hours` and `weekdays` \u2014 so `hours: [9]` is daily at 09:00, `hours: [12], weekdays: [1]` is Mondays at noon, and `hours: [9, 13, 17], weekdays: [1, 2, 3, 4, 5]` is three times a day on weekdays. Give a second pattern to mix cadences: hourly on weekdays plus 09:00, 11:00 and 18:00 at weekends is two patterns on one schedule. Patterns overlap harmlessly \u2014 two that land on the same minute fire once. Every set is read in the schedule's own time zone \u2014 an IANA identifier such as `America/Chicago`, resolved across DST transitions. `once` fires a single time at a UTC instant.\n\n`environments` says **which worker version** each occurrence runs: `live` resolves the worker at its live version, `test` at its test version. Give both to soak a candidate version on the same cadence and scope as production \u2014 every occurrence then fires twice, producing one run per environment. Omit it to fire in `live` only.\n\nThe response's `next_run_at` is the first occurrence strictly after the moment of creation; a rule that resolves to no such occurrence is rejected. Create with `enabled: false` to stage a recurring schedule without letting it fire. A one-off is always enabled: delete it to cancel it, and its `next_run_at` becomes null once it has fired.\n\nRequires the `schedules:write` permission.",
+      description: "Create a schedule that performs an action, either repeatedly or once.\n\n`action` describes **what** happens: `trigger_worker` starts a worker run with the given scope, and `execute_tool` executes a tool without parameters. `rule` describes **when**: `recurring` carries one or more `patterns`, and fires whenever any of them comes round. A pattern fires every hour at `minute`, narrowed by `hours` and `weekdays` \u2014 so `hours: [9]` is daily at 09:00, `hours: [12], weekdays: [1]` is Mondays at noon, and `hours: [9, 13, 17], weekdays: [1, 2, 3, 4, 5]` is three times a day on weekdays. Give a second pattern to mix cadences: hourly on weekdays plus 09:00, 11:00 and 18:00 at weekends is two patterns on one schedule. Patterns overlap harmlessly \u2014 two that land on the same minute fire once. Every set is read in the schedule's own time zone \u2014 an IANA identifier such as `America/Chicago`, resolved across DST transitions. `once` fires a single time at a UTC instant.\n\n`environments` says **which version** of the worker or tool each occurrence runs: `live` resolves it at its live version, `test` at its test version. Give both to soak a candidate version on the same cadence as production \u2014 every occurrence then fires twice, once per environment. Omit it to fire in `live` only.\n\nThe response's `next_run_at` is the first occurrence strictly after the moment of creation; a rule that resolves to no such occurrence is rejected. Create with `enabled: false` to stage a recurring schedule without letting it fire. A one-off is always enabled: delete it to cancel it, and its `next_run_at` becomes null once it has fired.\n\nRequires the `schedules:write` permission, and `tools:execute` for an `execute_tool` action.",
       inputSchema: {
         bodyParams: CreateScheduleBody.optional()
       },
@@ -16110,7 +16356,7 @@ var createMcpServer = (options) => {
     "listDispatches",
     {
       title: "List dispatches",
-      description: "List the organization's dispatches, newest occurrence first.\n\nA dispatch is one occurrence of a trigger in one environment, carried out on its own: a schedule produces one per environment it runs in every time it fires, an inbound email produces one for the environment its inbox received it in, a resolved information request produces one that restarts the worker that asked, an ended call produces one that runs its voice agent's post-call processor once its transcript is ready, and creating a worker run through the API produces a `manual` one, carried out before the request returns. Listing them shows what a trigger has actually done, including occurrences that never produced anything.\n\n- `pending` \u2014 not carried out yet: waiting to be picked up, in flight, or waiting on a retry after an earlier pickup did not complete.\n- `dispatched` \u2014 carried out.\n- `abandoned` \u2014 gave up, because the occurrence passed its `expires_at` deadline before it could be carried out, or, for a `manual` dispatch, because the request that created it failed.\n\n`attempts` counts how many times the occurrence has been picked up, not how many times it failed: a dispatch carried out on the first pickup ends at `attempts: 1`, and a higher count means earlier pickups did not complete.\n\n`target` is what the occurrence produced \u2014 a worker run, or an extractor job for an email whose inbox extracts or a call whose voice agent extracts. It is null until the dispatch is carried out.\n\nNarrow to one trigger with `trigger_type` and `trigger_id` \u2014 the schedule's ID for a schedule, the email's ID for an email, the request's ID for an information request, the call's ID for a call. `trigger_id` requires `trigger_type`.",
+      description: "List the organization's dispatches, newest occurrence first.\n\nA dispatch is one occurrence of a trigger in one environment, carried out on its own: a schedule produces one per environment it runs in every time it fires, an inbound email produces one for the environment its inbox received it in, a resolved information request produces one that restarts the worker that asked, an ended call produces one that runs its voice agent's post-call processor once its transcript is ready, and creating a worker run through the API produces a `manual` one, carried out before the request returns. Listing them shows what a trigger has actually done, including occurrences that never produced anything.\n\n- `pending` \u2014 not carried out yet: waiting to be picked up, in flight, or waiting on a retry after an earlier pickup did not complete.\n- `dispatched` \u2014 carried out.\n- `abandoned` \u2014 gave up, because the occurrence passed its `expires_at` deadline before it could be carried out, or, for a `manual` dispatch, because the request that created it failed.\n\n`attempts` counts how many times the occurrence has been picked up, not how many times it failed: a dispatch carried out on the first pickup ends at `attempts: 1`, and a higher count means earlier pickups did not complete.\n\n`target` is what the occurrence produced: a worker run, an extractor job (for an email whose inbox extracts or a call whose voice agent extracts), or a tool call (for an `execute_tool` schedule). It is null until the dispatch is carried out, and for a tool call until the tool has run.\n\nNarrow to one trigger with `trigger_type` and `trigger_id` \u2014 the schedule's ID for a schedule, the email's ID for an email, the request's ID for an information request, the call's ID for a call. `trigger_id` requires `trigger_type`.",
       inputSchema: {
         queryParams: ListDispatchesQueryParams
       },
@@ -16819,4 +17065,4 @@ var transport = new StdioServerTransport();
 server.connect(transport).then(() => {
   console.error("MCP server running on stdio");
 }).catch(console.error);
-//# sourceMappingURL=server-BWBH4XI6.js.map
+//# sourceMappingURL=server-3JZUJX4G.js.map