@leaflow/sdk 0.181.0 → 0.183.0

package/dist/assistant/v1/generated/models.d.ts

@@ -1177,6 +1177,7 @@ export declare const TaskTriggerType: {
     readonly at: "at";
     readonly interval: "interval";
     readonly cron: "cron";
+    readonly event: "event";
 };
 /**
  * What happens when a run is due while the previous one is still going.
@@ -1187,7 +1188,10 @@ export declare const TaskTriggerOverlapPolicy: {
     readonly buffer_one: "buffer_one";
 };
 /**
- * When the task runs. `type` determines which fields apply.
+ * When the task runs. `type` determines which fields apply. An `event` task runs when a matching
+ * event message arrives. Messages are delivered as they happen and are not stored: a message
+ * published while delivery is interrupted does not start a run, and a message can arrive late or
+ * more than once.
  */
 export interface TaskTrigger {
     type: TaskTriggerType;
@@ -1222,6 +1226,46 @@ export interface TaskTrigger {
      * @minimum 10
      */
     catchupSeconds?: number;
+    /**
+     * For `event`. The full name of the event to listen for.
+     * @maxLength 128
+     * @nullable
+     */
+    event?: string | null;
+    /**
+     * For `event`. A filter on the message key: layers separated by `/`, `+` matching exactly one
+     * layer, and `#` as the last layer matching that layer and every layer below it. Null matches
+     * every key.
+     * @maxLength 512
+     * @nullable
+     */
+    eventKey?: string | null;
+    /**
+     * For `event`. A CEL expression that must be true for a message to count, over `data` (the
+     * payload) and `event` (`name`, `version`, `key`, `sender_id` and `created_at`). Reading a field
+     * the payload does not carry counts as false; use `has()` for optional fields. Null counts every
+     * message.
+     * @maxLength 2048
+     * @nullable
+     */
+    eventCondition?: string | null;
+    /**
+     * For `event`. The number of event-triggered runs after which the task completes. Null means no limit.
+     * @minimum 1
+     * @nullable
+     */
+    maxRuns?: number | null;
+    /**
+     * For `event`. The task stops listening and completes at this time.
+     * @nullable
+     */
+    expiresAt?: string | null;
+    /**
+     * For `event`. The least time between the starts of two event-triggered runs. Messages that
+     * match in between are delivered with the next run.
+     * @minimum 10
+     */
+    cooldownSeconds?: number;
 }
 export type TaskActionType = (typeof TaskActionType)[keyof typeof TaskActionType];
 export declare const TaskActionType: {
@@ -1268,14 +1312,39 @@ export declare const TaskRunResourceStatus: {
 };
 /**
  * How the run started: `schedule` by the task's own trigger, including a task set to run now;
- * `manual` by a person running it outside its schedule; `assistant` by the assistant.
+ * `manual` by a person running it outside its schedule; `assistant` by the assistant; `event` by
+ * matching event messages.
  */
 export type TaskRunResourceTrigger = (typeof TaskRunResourceTrigger)[keyof typeof TaskRunResourceTrigger];
 export declare const TaskRunResourceTrigger: {
     readonly schedule: "schedule";
     readonly manual: "manual";
     readonly assistant: "assistant";
+    readonly event: "event";
 };
+/**
+ * The payload as published. Null when it was larger than 4 KiB; see dataBytes.
+ * @nullable
+ */
+export type TaskRunEventData = {
+    [key: string]: unknown;
+} | null;
+/**
+ * An event message that started a run.
+ */
+export interface TaskRunEvent {
+    id: string;
+    event: string;
+    version: number;
+    key: string;
+    createdAt: string;
+    /**
+     * The payload as published. Null when it was larger than 4 KiB; see dataBytes.
+     * @nullable
+     */
+    data: TaskRunEventData;
+    dataBytes: number;
+}
 export interface TaskRunResource {
     id: string;
     taskId: string;
@@ -1301,9 +1370,17 @@ export interface TaskRunResource {
     errorCode: string | null;
     /**
      * How the run started: `schedule` by the task's own trigger, including a task set to run now;
-     * `manual` by a person running it outside its schedule; `assistant` by the assistant.
+     * `manual` by a person running it outside its schedule; `assistant` by the assistant; `event` by
+     * matching event messages.
      */
     trigger: TaskRunResourceTrigger;
+    /** For runs started by events, the number of matching messages the run covers. */
+    eventCount: number;
+    /**
+     * For runs started by events, up to 20 of the messages the run covers. Null in lists; read the run for it.
+     * @nullable
+     */
+    events: TaskRunEvent[] | null;
 }
 export interface TaskResource {
     id: string;
@@ -1319,6 +1396,15 @@ export interface TaskResource {
      * @nullable
      */
     nextRunAt: string | null;
+    /**
+     * For `event`. The event version the condition was checked against. It advances when the event
+     * gains a newer version that the condition still fits; when it no longer fits, the task is
+     * paused and a failed run records TASK_EVENT_VERSION_INCOMPATIBLE.
+     * @nullable
+     */
+    eventVersion: number | null;
+    /** For `event`. The event-triggered runs started under the current trigger. */
+    eventRunCount: number;
     lastRun: TaskRunResource | null;
     createdAt: string;
     updatedAt: string;
@@ -1359,6 +1445,7 @@ export declare const SearchTasksRequestBodyTriggerType: {
     readonly at: "at";
     readonly interval: "interval";
     readonly cron: "cron";
+    readonly event: "event";
 };
 export type SearchTasksRequestBodyActionType = (typeof SearchTasksRequestBodyActionType)[keyof typeof SearchTasksRequestBodyActionType];
 export declare const SearchTasksRequestBodyActionType: {

package/dist/assistant/v1/generated/models.js

@@ -130,6 +130,7 @@ export const TaskTriggerType = {
     at: "at",
     interval: "interval",
     cron: "cron",
+    event: "event",
 };
 export const TaskTriggerOverlapPolicy = {
     skip: "skip",
@@ -151,6 +152,7 @@ export const TaskRunResourceTrigger = {
     schedule: "schedule",
     manual: "manual",
     assistant: "assistant",
+    event: "event",
 };
 export const SearchTasksRequestBodyStatus = {
     active: "active",
@@ -163,6 +165,7 @@ export const SearchTasksRequestBodyTriggerType = {
     at: "at",
     interval: "interval",
     cron: "cron",
+    event: "event",
 };
 export const SearchTasksRequestBodyActionType = {
     prompt: "prompt",

package/dist/assistant/v1/generated/schemas.zod.d.ts

@@ -466,6 +466,7 @@ export declare const CreateTaskBody: zod.ZodObject<{
             now: "now";
             interval: "interval";
             cron: "cron";
+            event: "event";
         }>;
         runAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
         intervalSeconds: zod.ZodOptional<zod.ZodNullable<zod.ZodInt>>;
@@ -477,6 +478,12 @@ export declare const CreateTaskBody: zod.ZodObject<{
             buffer_one: "buffer_one";
         }>>;
         catchupSeconds: zod.ZodDefault<zod.ZodInt>;
+        event: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        eventKey: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        eventCondition: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        maxRuns: zod.ZodOptional<zod.ZodNullable<zod.ZodInt>>;
+        expiresAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+        cooldownSeconds: zod.ZodDefault<zod.ZodInt>;
     }, zod.z.core.$strict>;
     action: zod.ZodObject<{
         type: zod.ZodEnum<{
@@ -513,6 +520,7 @@ export declare const UpdateTaskBody: zod.ZodObject<{
             now: "now";
             interval: "interval";
             cron: "cron";
+            event: "event";
         }>;
         runAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
         intervalSeconds: zod.ZodOptional<zod.ZodNullable<zod.ZodInt>>;
@@ -524,6 +532,12 @@ export declare const UpdateTaskBody: zod.ZodObject<{
             buffer_one: "buffer_one";
         }>>;
         catchupSeconds: zod.ZodDefault<zod.ZodInt>;
+        event: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        eventKey: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        eventCondition: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        maxRuns: zod.ZodOptional<zod.ZodNullable<zod.ZodInt>>;
+        expiresAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+        cooldownSeconds: zod.ZodDefault<zod.ZodInt>;
     }, zod.z.core.$strict>>;
     action: zod.ZodOptional<zod.ZodObject<{
         type: zod.ZodEnum<{

package/dist/assistant/v1/generated/validators/createTaskRequestBody.zod.d.ts

@@ -35,6 +35,7 @@ export declare const CreateTaskRequestBody: zod.ZodObject<{
             now: "now";
             interval: "interval";
             cron: "cron";
+            event: "event";
         }>;
         runAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
         intervalSeconds: zod.ZodOptional<zod.ZodNullable<zod.ZodInt>>;
@@ -46,6 +47,12 @@ export declare const CreateTaskRequestBody: zod.ZodObject<{
             buffer_one: "buffer_one";
         }>>;
         catchupSeconds: zod.ZodDefault<zod.ZodInt>;
+        event: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        eventKey: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        eventCondition: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        maxRuns: zod.ZodOptional<zod.ZodNullable<zod.ZodInt>>;
+        expiresAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+        cooldownSeconds: zod.ZodDefault<zod.ZodInt>;
     }, zod.z.core.$strict>;
     action: zod.ZodObject<{
         type: zod.ZodEnum<{

package/dist/assistant/v1/generated/validators/searchTasksRequestBody.zod.d.ts

@@ -41,6 +41,7 @@ export declare const SearchTasksRequestBody: zod.ZodObject<{
         now: "now";
         interval: "interval";
         cron: "cron";
+        event: "event";
     }>>;
     actionType: zod.ZodOptional<zod.ZodEnum<{
         prompt: "prompt";

package/dist/assistant/v1/generated/validators/searchTasksRequestBody.zod.js

@@ -35,7 +35,7 @@ export const SearchTasksRequestBody = zod.strictObject({
         .optional()
         .describe("Only the tasks that report to this conversation."),
     status: zod.enum(["active", "paused", "completed", "cancelled"]).optional(),
-    triggerType: zod.enum(["now", "at", "interval", "cron"]).optional(),
+    triggerType: zod.enum(["now", "at", "interval", "cron", "event"]).optional(),
     actionType: zod.enum(["prompt", "command"]).optional(),
     cursor: zod.string().max(searchTasksRequestBodyCursorMax).optional(),
     limit: zod

package/dist/assistant/v1/generated/validators/taskListResponseBody.zod.d.ts

@@ -41,6 +41,7 @@ export declare const TaskListResponseBody: zod.ZodObject<{
                 now: "now";
                 interval: "interval";
                 cron: "cron";
+                event: "event";
             }>;
             runAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
             intervalSeconds: zod.ZodOptional<zod.ZodNullable<zod.ZodInt>>;
@@ -52,6 +53,12 @@ export declare const TaskListResponseBody: zod.ZodObject<{
                 buffer_one: "buffer_one";
             }>>;
             catchupSeconds: zod.ZodDefault<zod.ZodInt>;
+            event: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+            eventKey: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+            eventCondition: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+            maxRuns: zod.ZodOptional<zod.ZodNullable<zod.ZodInt>>;
+            expiresAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+            cooldownSeconds: zod.ZodDefault<zod.ZodInt>;
         }, zod.z.core.$strict>;
         action: zod.ZodObject<{
             type: zod.ZodEnum<{
@@ -64,6 +71,8 @@ export declare const TaskListResponseBody: zod.ZodObject<{
             timeoutSeconds: zod.ZodDefault<zod.ZodInt>;
         }, zod.z.core.$strict>;
         nextRunAt: zod.ZodNullable<zod.z.ZodISODateTime>;
+        eventVersion: zod.ZodNullable<zod.ZodInt>;
+        eventRunCount: zod.ZodInt;
         lastRun: zod.ZodUnion<readonly [zod.ZodObject<{
             id: zod.ZodString;
             taskId: zod.ZodString;
@@ -82,9 +91,20 @@ export declare const TaskListResponseBody: zod.ZodObject<{
             errorCode: zod.ZodNullable<zod.ZodString>;
             trigger: zod.ZodEnum<{
                 manual: "manual";
+                event: "event";
                 schedule: "schedule";
                 assistant: "assistant";
             }>;
+            eventCount: zod.ZodInt;
+            events: zod.ZodNullable<zod.ZodArray<zod.ZodObject<{
+                id: zod.ZodString;
+                event: zod.ZodString;
+                version: zod.ZodInt;
+                key: zod.ZodString;
+                createdAt: zod.z.ZodISODateTime;
+                data: zod.ZodNullable<zod.ZodRecord<zod.ZodString, zod.ZodUnknown>>;
+                dataBytes: zod.ZodInt;
+            }, zod.z.core.$strict>>>;
         }, zod.z.core.$strict>, zod.ZodNull]>;
         createdAt: zod.z.ZodISODateTime;
         updatedAt: zod.z.ZodISODateTime;

package/dist/assistant/v1/generated/validators/taskResource.zod.d.ts

@@ -40,6 +40,7 @@ export declare const TaskResource: zod.ZodObject<{
             now: "now";
             interval: "interval";
             cron: "cron";
+            event: "event";
         }>;
         runAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
         intervalSeconds: zod.ZodOptional<zod.ZodNullable<zod.ZodInt>>;
@@ -51,6 +52,12 @@ export declare const TaskResource: zod.ZodObject<{
             buffer_one: "buffer_one";
         }>>;
         catchupSeconds: zod.ZodDefault<zod.ZodInt>;
+        event: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        eventKey: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        eventCondition: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        maxRuns: zod.ZodOptional<zod.ZodNullable<zod.ZodInt>>;
+        expiresAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+        cooldownSeconds: zod.ZodDefault<zod.ZodInt>;
     }, zod.z.core.$strict>;
     action: zod.ZodObject<{
         type: zod.ZodEnum<{
@@ -63,6 +70,8 @@ export declare const TaskResource: zod.ZodObject<{
         timeoutSeconds: zod.ZodDefault<zod.ZodInt>;
     }, zod.z.core.$strict>;
     nextRunAt: zod.ZodNullable<zod.z.ZodISODateTime>;
+    eventVersion: zod.ZodNullable<zod.ZodInt>;
+    eventRunCount: zod.ZodInt;
     lastRun: zod.ZodUnion<readonly [zod.ZodObject<{
         id: zod.ZodString;
         taskId: zod.ZodString;
@@ -81,9 +90,20 @@ export declare const TaskResource: zod.ZodObject<{
         errorCode: zod.ZodNullable<zod.ZodString>;
         trigger: zod.ZodEnum<{
             manual: "manual";
+            event: "event";
             schedule: "schedule";
             assistant: "assistant";
         }>;
+        eventCount: zod.ZodInt;
+        events: zod.ZodNullable<zod.ZodArray<zod.ZodObject<{
+            id: zod.ZodString;
+            event: zod.ZodString;
+            version: zod.ZodInt;
+            key: zod.ZodString;
+            createdAt: zod.z.ZodISODateTime;
+            data: zod.ZodNullable<zod.ZodRecord<zod.ZodString, zod.ZodUnknown>>;
+            dataBytes: zod.ZodInt;
+        }, zod.z.core.$strict>>>;
     }, zod.z.core.$strict>, zod.ZodNull]>;
     createdAt: zod.z.ZodISODateTime;
     updatedAt: zod.z.ZodISODateTime;

package/dist/assistant/v1/generated/validators/taskResource.zod.js

@@ -40,6 +40,13 @@ export const TaskResource = zod.strictObject({
         .datetime({ offset: true })
         .nullable()
         .describe("When the trigger starts the next run. Null when it will not."),
+    eventVersion: zod
+        .int()
+        .nullable()
+        .describe("For `event`. The event version the condition was checked against. It advances when the event\ngains a newer version that the condition still fits; when it no longer fits, the task is\npaused and a failed run records TASK_EVENT_VERSION_INCOMPATIBLE."),
+    eventRunCount: zod
+        .int()
+        .describe("For `event`. The event-triggered runs started under the current trigger."),
     lastRun: zod.union([TaskRunResource, zod.null()]),
     createdAt: zod.iso.datetime({ offset: true }),
     updatedAt: zod.iso.datetime({ offset: true }),

package/dist/assistant/v1/generated/validators/taskRunEvent.zod.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Assistant API
+ * Conversations with agents that operate the Leaflow platform, plus their folders, tasks, files and
+ * chat-app channels.
+ *
+ * A conversation is a thread. A person talks to the main thread; the agent in it can start subagents,
+ * which are threads too and run on their own: stopping the main thread does not stop them, and each
+ * subagent tells its parent when it ends. A thread runs in turns; each turn records the model and
+ * reasoning effort it used and its token usage.
+ *
+ * Models come from the Canopy catalogue. A new thread uses the model it names, the caller's default
+ * from /api/v1/settings, or the first catalogue model that can run an agent. Reasoning models take one
+ * of three efforts — low, medium or high — which are sent to the model unchanged.
+ *
+ * Read a thread's state with get-thread and its transcript with list-thread-items. Follow both live
+ * through EventBus by subscribing to assistant.thread.frame and assistant.resource.updated; after a
+ * reconnection or an assistant.workspace.invalidated message, read them again. list-thread-messages
+ * outlines the person's messages for navigating a long conversation.
+ *
+ * Upload large files with /api/v1/uploads: read /api/v1/upload-configuration first, send exact-sized
+ * parts, then complete the upload and send its attachment id in a message.
+ * OpenAPI spec version: 2.0.0
+ */
+import * as zod from "zod";
+export declare const TaskRunEvent: zod.ZodObject<{
+    id: zod.ZodString;
+    event: zod.ZodString;
+    version: zod.ZodInt;
+    key: zod.ZodString;
+    createdAt: zod.z.ZodISODateTime;
+    data: zod.ZodNullable<zod.ZodRecord<zod.ZodString, zod.ZodUnknown>>;
+    dataBytes: zod.ZodInt;
+}, zod.z.core.$strict>;
+export type TaskRunEvent = zod.input<typeof TaskRunEvent>;
+export type TaskRunEventOutput = zod.output<typeof TaskRunEvent>;

package/dist/assistant/v1/generated/validators/taskRunEvent.zod.js

@@ -0,0 +1,40 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Assistant API
+ * Conversations with agents that operate the Leaflow platform, plus their folders, tasks, files and
+ * chat-app channels.
+ *
+ * A conversation is a thread. A person talks to the main thread; the agent in it can start subagents,
+ * which are threads too and run on their own: stopping the main thread does not stop them, and each
+ * subagent tells its parent when it ends. A thread runs in turns; each turn records the model and
+ * reasoning effort it used and its token usage.
+ *
+ * Models come from the Canopy catalogue. A new thread uses the model it names, the caller's default
+ * from /api/v1/settings, or the first catalogue model that can run an agent. Reasoning models take one
+ * of three efforts — low, medium or high — which are sent to the model unchanged.
+ *
+ * Read a thread's state with get-thread and its transcript with list-thread-items. Follow both live
+ * through EventBus by subscribing to assistant.thread.frame and assistant.resource.updated; after a
+ * reconnection or an assistant.workspace.invalidated message, read them again. list-thread-messages
+ * outlines the person's messages for navigating a long conversation.
+ *
+ * Upload large files with /api/v1/uploads: read /api/v1/upload-configuration first, send exact-sized
+ * parts, then complete the upload and send its attachment id in a message.
+ * OpenAPI spec version: 2.0.0
+ */
+import * as zod from "zod";
+export const TaskRunEvent = zod
+    .strictObject({
+    id: zod.string(),
+    event: zod.string(),
+    version: zod.int(),
+    key: zod.string(),
+    createdAt: zod.iso.datetime({ offset: true }),
+    data: zod
+        .record(zod.string(), zod.unknown())
+        .nullable()
+        .describe("The payload as published. Null when it was larger than 4 KiB; see dataBytes."),
+    dataBytes: zod.int(),
+})
+    .describe("An event message that started a run.");

package/dist/assistant/v1/generated/validators/taskRunListResponseBody.zod.d.ts

@@ -43,9 +43,20 @@ export declare const TaskRunListResponseBody: zod.ZodObject<{
         errorCode: zod.ZodNullable<zod.ZodString>;
         trigger: zod.ZodEnum<{
             manual: "manual";
+            event: "event";
             schedule: "schedule";
             assistant: "assistant";
         }>;
+        eventCount: zod.ZodInt;
+        events: zod.ZodNullable<zod.ZodArray<zod.ZodObject<{
+            id: zod.ZodString;
+            event: zod.ZodString;
+            version: zod.ZodInt;
+            key: zod.ZodString;
+            createdAt: zod.z.ZodISODateTime;
+            data: zod.ZodNullable<zod.ZodRecord<zod.ZodString, zod.ZodUnknown>>;
+            dataBytes: zod.ZodInt;
+        }, zod.z.core.$strict>>>;
     }, zod.z.core.$strict>>;
     nextCursor: zod.ZodNullable<zod.ZodString>;
 }, zod.z.core.$strict>;

package/dist/assistant/v1/generated/validators/taskRunResource.zod.d.ts

@@ -42,9 +42,20 @@ export declare const TaskRunResource: zod.ZodObject<{
     errorCode: zod.ZodNullable<zod.ZodString>;
     trigger: zod.ZodEnum<{
         manual: "manual";
+        event: "event";
         schedule: "schedule";
         assistant: "assistant";
     }>;
+    eventCount: zod.ZodInt;
+    events: zod.ZodNullable<zod.ZodArray<zod.ZodObject<{
+        id: zod.ZodString;
+        event: zod.ZodString;
+        version: zod.ZodInt;
+        key: zod.ZodString;
+        createdAt: zod.z.ZodISODateTime;
+        data: zod.ZodNullable<zod.ZodRecord<zod.ZodString, zod.ZodUnknown>>;
+        dataBytes: zod.ZodInt;
+    }, zod.z.core.$strict>>>;
 }, zod.z.core.$strict>;
 export type TaskRunResource = zod.input<typeof TaskRunResource>;
 export type TaskRunResourceOutput = zod.output<typeof TaskRunResource>;

package/dist/assistant/v1/generated/validators/taskRunResource.zod.js

@@ -24,6 +24,7 @@
  * OpenAPI spec version: 2.0.0
  */
 import * as zod from "zod";
+import { TaskRunEvent } from "./taskRunEvent.zod.js";
 export const TaskRunResource = zod.strictObject({
     id: zod.string(),
     taskId: zod.string(),
@@ -37,6 +38,13 @@ export const TaskRunResource = zod.strictObject({
         .describe("The last 16 KiB of a command's output. Empty for prompts; null in lists, read the run for it."),
     errorCode: zod.string().nullable().describe("Why the run failed. Null unless status is failed."),
     trigger: zod
-        .enum(["schedule", "manual", "assistant"])
-        .describe("How the run started: `schedule` by the task's own trigger, including a task set to run now;\n`manual` by a person running it outside its schedule; `assistant` by the assistant."),
+        .enum(["schedule", "manual", "assistant", "event"])
+        .describe("How the run started: `schedule` by the task's own trigger, including a task set to run now;\n`manual` by a person running it outside its schedule; `assistant` by the assistant; `event` by\nmatching event messages."),
+    eventCount: zod
+        .int()
+        .describe("For runs started by events, the number of matching messages the run covers."),
+    events: zod
+        .array(TaskRunEvent)
+        .nullable()
+        .describe("For runs started by events, up to 20 of the messages the run covers. Null in lists; read the run for it."),
 });

package/dist/assistant/v1/generated/validators/taskTrigger.zod.d.ts

@@ -30,12 +30,18 @@ export declare const taskTriggerTimezoneDefault = "UTC";
 export declare const taskTriggerOverlapPolicyDefault = "buffer_one";
 export declare const taskTriggerCatchupSecondsDefault = 300;
 export declare const taskTriggerCatchupSecondsMin = 10;
+export declare const taskTriggerEventMax = 128;
+export declare const taskTriggerEventKeyMax = 512;
+export declare const taskTriggerEventConditionMax = 2048;
+export declare const taskTriggerCooldownSecondsDefault = 60;
+export declare const taskTriggerCooldownSecondsMin = 10;
 export declare const TaskTrigger: zod.ZodObject<{
     type: zod.ZodEnum<{
         at: "at";
         now: "now";
         interval: "interval";
         cron: "cron";
+        event: "event";
     }>;
     runAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
     intervalSeconds: zod.ZodOptional<zod.ZodNullable<zod.ZodInt>>;
@@ -47,6 +53,12 @@ export declare const TaskTrigger: zod.ZodObject<{
         buffer_one: "buffer_one";
     }>>;
     catchupSeconds: zod.ZodDefault<zod.ZodInt>;
+    event: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+    eventKey: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+    eventCondition: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+    maxRuns: zod.ZodOptional<zod.ZodNullable<zod.ZodInt>>;
+    expiresAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+    cooldownSeconds: zod.ZodDefault<zod.ZodInt>;
 }, zod.z.core.$strict>;
 export type TaskTrigger = zod.input<typeof TaskTrigger>;
 export type TaskTriggerOutput = zod.output<typeof TaskTrigger>;

package/dist/assistant/v1/generated/validators/taskTrigger.zod.js

@@ -30,9 +30,14 @@ export const taskTriggerTimezoneDefault = `UTC`;
 export const taskTriggerOverlapPolicyDefault = `buffer_one`;
 export const taskTriggerCatchupSecondsDefault = 300;
 export const taskTriggerCatchupSecondsMin = 10;
+export const taskTriggerEventMax = 128;
+export const taskTriggerEventKeyMax = 512;
+export const taskTriggerEventConditionMax = 2048;
+export const taskTriggerCooldownSecondsDefault = 60;
+export const taskTriggerCooldownSecondsMin = 10;
 export const TaskTrigger = zod
     .strictObject({
-    type: zod.enum(["now", "at", "interval", "cron"]),
+    type: zod.enum(["now", "at", "interval", "cron", "event"]),
     runAt: zod.iso.datetime({ offset: true }).nullish().describe("For `at`."),
     intervalSeconds: zod
         .int()
@@ -61,5 +66,34 @@ export const TaskTrigger = zod
         .min(taskTriggerCatchupSecondsMin)
         .default(taskTriggerCatchupSecondsDefault)
         .describe("How late a missed run may still start, for example after a pause or an outage."),
+    event: zod
+        .string()
+        .max(taskTriggerEventMax)
+        .nullish()
+        .describe("For `event`. The full name of the event to listen for."),
+    eventKey: zod
+        .string()
+        .max(taskTriggerEventKeyMax)
+        .nullish()
+        .describe("For `event`. A filter on the message key: layers separated by `/`, `+` matching exactly one\nlayer, and `#` as the last layer matching that layer and every layer below it. Null matches\nevery key."),
+    eventCondition: zod
+        .string()
+        .max(taskTriggerEventConditionMax)
+        .nullish()
+        .describe("For `event`. A CEL expression that must be true for a message to count, over `data` (the\npayload) and `event` (`name`, `version`, `key`, `sender_id` and `created_at`). Reading a field\nthe payload does not carry counts as false; use `has()` for optional fields. Null counts every\nmessage."),
+    maxRuns: zod
+        .int()
+        .min(1)
+        .nullish()
+        .describe("For `event`. The number of event-triggered runs after which the task completes. Null means no limit."),
+    expiresAt: zod.iso
+        .datetime({ offset: true })
+        .nullish()
+        .describe("For `event`. The task stops listening and completes at this time."),
+    cooldownSeconds: zod
+        .int()
+        .min(taskTriggerCooldownSecondsMin)
+        .default(taskTriggerCooldownSecondsDefault)
+        .describe("For `event`. The least time between the starts of two event-triggered runs. Messages that\nmatch in between are delivered with the next run."),
 })
-    .describe("When the task runs. `type` determines which fields apply.");
+    .describe("When the task runs. `type` determines which fields apply. An `event` task runs when a matching\nevent message arrives. Messages are delivered as they happen and are not stored: a message\npublished while delivery is interrupted does not start a run, and a message can arrive late or\nmore than once.");

package/dist/assistant/v1/generated/validators/updateTaskRequestBody.zod.d.ts

@@ -33,6 +33,7 @@ export declare const UpdateTaskRequestBody: zod.ZodObject<{
             now: "now";
             interval: "interval";
             cron: "cron";
+            event: "event";
         }>;
         runAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
         intervalSeconds: zod.ZodOptional<zod.ZodNullable<zod.ZodInt>>;
@@ -44,6 +45,12 @@ export declare const UpdateTaskRequestBody: zod.ZodObject<{
             buffer_one: "buffer_one";
         }>>;
         catchupSeconds: zod.ZodDefault<zod.ZodInt>;
+        event: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        eventKey: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        eventCondition: zod.ZodOptional<zod.ZodNullable<zod.ZodString>>;
+        maxRuns: zod.ZodOptional<zod.ZodNullable<zod.ZodInt>>;
+        expiresAt: zod.ZodOptional<zod.ZodNullable<zod.z.ZodISODateTime>>;
+        cooldownSeconds: zod.ZodDefault<zod.ZodInt>;
     }, zod.z.core.$strict>>;
     action: zod.ZodOptional<zod.ZodObject<{
         type: zod.ZodEnum<{