@trigger.dev/core 4.7.2 → 4.7.3

package/dist/esm/v3/schemas/webhookApi.d.ts

@@ -11,11 +11,12 @@ export declare const WebhookDeliveryApiStatus: z.ZodEnum<{
     pending: "pending";
     processing: "processing";
     succeeded: "succeeded";
+    unmatched: "unmatched";
 }>;
 export type WebhookDeliveryApiStatus = z.infer<typeof WebhookDeliveryApiStatus>;
 export declare const WebhookEndpointObject: z.ZodObject<{
     id: z.ZodString;
-    webhook: z.ZodString;
+    declaredId: z.ZodString;
     source: z.ZodString;
     status: z.ZodEnum<{
         active: "active";
@@ -38,7 +39,7 @@ export type WebhookEndpointObject = z.infer<typeof WebhookEndpointObject>;
 export declare const ListWebhookEndpointsResponse: z.ZodObject<{
     data: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
-        webhook: z.ZodString;
+        declaredId: z.ZodString;
         source: z.ZodString;
         status: z.ZodEnum<{
             active: "active";
@@ -59,35 +60,99 @@ export declare const ListWebhookEndpointsResponse: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ListWebhookEndpointsResponse = z.infer<typeof ListWebhookEndpointsResponse>;
+export declare const WebhookEndpointSubscriberObject: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        session: "session";
+        task: "task";
+    }>;
+    taskId: z.ZodString;
+    filter: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type WebhookEndpointSubscriberObject = z.infer<typeof WebhookEndpointSubscriberObject>;
+export declare const WebhookEndpointDetailObject: z.ZodObject<{
+    id: z.ZodString;
+    declaredId: z.ZodString;
+    source: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        deleting: "deleting";
+        inactive: "inactive";
+    }>;
+    secretProvisioning: z.ZodEnum<{
+        either: "either";
+        integrator: "integrator";
+        provider: "provider";
+    }>;
+    secretSet: z.ZodBoolean;
+    tenantId: z.ZodNullable<z.ZodString>;
+    externalRef: z.ZodNullable<z.ZodString>;
+    url: z.ZodString;
+    createdAt: z.ZodCoercedDate<unknown>;
+    updatedAt: z.ZodCoercedDate<unknown>;
+    subscribers: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<{
+            session: "session";
+            task: "task";
+        }>;
+        taskId: z.ZodString;
+        filter: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    setupPrompt: z.ZodString;
+}, z.core.$strip>;
+export type WebhookEndpointDetailObject = z.infer<typeof WebhookEndpointDetailObject>;
 export declare const WebhookDeliveryListItem: z.ZodObject<{
     id: z.ZodString;
-    webhook: z.ZodNullable<z.ZodString>;
+    endpoint: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        declaredId: z.ZodString;
+    }, z.core.$strip>>;
     status: z.ZodEnum<{
         failed: "failed";
         filtered: "filtered";
         pending: "pending";
         processing: "processing";
         succeeded: "succeeded";
+        unmatched: "unmatched";
     }>;
     externalDeliveryId: z.ZodString;
-    runId: z.ZodNullable<z.ZodString>;
+    isTest: z.ZodBoolean;
     createdAt: z.ZodCoercedDate<unknown>;
     processedAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
 }, z.core.$strip>;
 export type WebhookDeliveryListItem = z.infer<typeof WebhookDeliveryListItem>;
+/** Query for `GET /api/v1/webhooks/deliveries`, newest first. */
+export type ListWebhookDeliveriesQuery = {
+    /** Declared endpoint ids or `wh_` ids. */
+    endpoint?: string | string[];
+    status?: WebhookDeliveryApiStatus | WebhookDeliveryApiStatus[];
+    /** A duration back from now, such as `"1h"` or `"7d"`. */
+    period?: string;
+    from?: Date;
+    to?: Date;
+    /** 1 to 100. */
+    limit?: number;
+    /** The `pagination.next` cursor from a previous page. */
+    after?: string;
+};
 export declare const ListWebhookDeliveriesResponse: z.ZodObject<{
     data: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
-        webhook: z.ZodNullable<z.ZodString>;
+        endpoint: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            declaredId: z.ZodString;
+        }, z.core.$strip>>;
         status: z.ZodEnum<{
             failed: "failed";
             filtered: "filtered";
             pending: "pending";
             processing: "processing";
             succeeded: "succeeded";
+            unmatched: "unmatched";
         }>;
         externalDeliveryId: z.ZodString;
-        runId: z.ZodNullable<z.ZodString>;
+        isTest: z.ZodBoolean;
         createdAt: z.ZodCoercedDate<unknown>;
         processedAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
     }, z.core.$strip>>;
@@ -97,18 +162,57 @@ export declare const ListWebhookDeliveriesResponse: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type ListWebhookDeliveriesResponse = z.infer<typeof ListWebhookDeliveriesResponse>;
+export declare const WebhookDeliveryTargetApiStatus: z.ZodEnum<{
+    failed: "failed";
+    filtered: "filtered";
+    pending: "pending";
+    succeeded: "succeeded";
+}>;
+export type WebhookDeliveryTargetApiStatus = z.infer<typeof WebhookDeliveryTargetApiStatus>;
+/**
+ * What a delivery did for one subscriber, or (type `waiter`) the summary of the waiting runs it
+ * matched. `runId` and `sessionId` are friendly ids.
+ */
+export declare const WebhookDeliveryTargetObject: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        session: "session";
+        task: "task";
+        waiter: "waiter";
+    }>;
+    status: z.ZodEnum<{
+        failed: "failed";
+        filtered: "filtered";
+        pending: "pending";
+        succeeded: "succeeded";
+    }>;
+    reason: z.ZodNullable<z.ZodString>;
+    error: z.ZodNullable<z.ZodString>;
+    runId: z.ZodNullable<z.ZodString>;
+    sessionId: z.ZodNullable<z.ZodString>;
+    waiters: z.ZodNullable<z.ZodObject<{
+        matched: z.ZodNumber;
+        resumed: z.ZodNumber;
+        failed: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type WebhookDeliveryTargetObject = z.infer<typeof WebhookDeliveryTargetObject>;
 export declare const WebhookDeliveryObject: z.ZodObject<{
     id: z.ZodString;
-    webhook: z.ZodNullable<z.ZodString>;
+    endpoint: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        declaredId: z.ZodString;
+    }, z.core.$strip>>;
     status: z.ZodEnum<{
         failed: "failed";
         filtered: "filtered";
         pending: "pending";
         processing: "processing";
         succeeded: "succeeded";
+        unmatched: "unmatched";
     }>;
     externalDeliveryId: z.ZodString;
-    runId: z.ZodNullable<z.ZodString>;
+    isTest: z.ZodBoolean;
     createdAt: z.ZodCoercedDate<unknown>;
     processedAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
     idempotencyKey: z.ZodString;
@@ -117,6 +221,29 @@ export declare const WebhookDeliveryObject: z.ZodObject<{
     rawBodyHash: z.ZodNullable<z.ZodString>;
     error: z.ZodNullable<z.ZodString>;
     filterReason: z.ZodNullable<z.ZodString>;
+    targets: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<{
+            session: "session";
+            task: "task";
+            waiter: "waiter";
+        }>;
+        status: z.ZodEnum<{
+            failed: "failed";
+            filtered: "filtered";
+            pending: "pending";
+            succeeded: "succeeded";
+        }>;
+        reason: z.ZodNullable<z.ZodString>;
+        error: z.ZodNullable<z.ZodString>;
+        runId: z.ZodNullable<z.ZodString>;
+        sessionId: z.ZodNullable<z.ZodString>;
+        waiters: z.ZodNullable<z.ZodObject<{
+            matched: z.ZodNumber;
+            resumed: z.ZodNumber;
+            failed: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     updatedAt: z.ZodCoercedDate<unknown>;
 }, z.core.$strip>;
 export type WebhookDeliveryObject = z.infer<typeof WebhookDeliveryObject>;
@@ -127,9 +254,73 @@ export declare const RotateWebhookEndpointSecretResponse: z.ZodObject<{
     secret: z.ZodString;
 }, z.core.$strip>;
 export type RotateWebhookEndpointSecretResponse = z.infer<typeof RotateWebhookEndpointSecretResponse>;
+/** `PUT /api/v1/webhooks/endpoints/:endpointId/secret`: store a secret or public key the provider issued. */
+export declare const SetWebhookEndpointSecretRequestBody: z.ZodObject<{
+    secret: z.ZodString;
+}, z.core.$strip>;
+export type SetWebhookEndpointSecretRequestBody = z.infer<typeof SetWebhookEndpointSecretRequestBody>;
+export declare const SetWebhookEndpointSecretResponse: z.ZodObject<{
+    id: z.ZodString;
+    secretSet: z.ZodLiteral<true>;
+}, z.core.$strip>;
+export type SetWebhookEndpointSecretResponse = z.infer<typeof SetWebhookEndpointSecretResponse>;
 /** Replaying re-runs a delivery's task from its stored event as a new delivery. */
 export declare const ReplayWebhookDeliveryResponse: z.ZodObject<{
     deliveryId: z.ZodString;
     replayedFrom: z.ZodString;
 }, z.core.$strip>;
 export type ReplayWebhookDeliveryResponse = z.infer<typeof ReplayWebhookDeliveryResponse>;
+/**
+ * `POST /api/v1/webhooks/endpoints/:endpointId/waiters`, where `:endpointId` is the declared endpoint
+ * id or its `wh_` id. A waiter only matches deliveries that arrive after it was created.
+ */
+export declare const CreateWebhookWaiterRequestBody: z.ZodObject<{
+    match: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    filter: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    idempotencyKeyTTL: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodObject<{
+        tenantId: z.ZodOptional<z.ZodString>;
+        externalRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CreateWebhookWaiterRequestBody = z.infer<typeof CreateWebhookWaiterRequestBody>;
+export declare const CreateWebhookWaiterResponseBody: z.ZodObject<{
+    id: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodCoercedDate<unknown>;
+    isCached: z.ZodBoolean;
+}, z.core.$strip>;
+export type CreateWebhookWaiterResponseBody = z.infer<typeof CreateWebhookWaiterResponseBody>;
+export declare const WebhookWaiterErrorCode: z.ZodEnum<{
+    invalid_request: "invalid_request";
+    webhook_endpoint_not_found: "webhook_endpoint_not_found";
+    webhook_filter_invalid: "webhook_filter_invalid";
+    webhook_waiter_limit: "webhook_waiter_limit";
+}>;
+export type WebhookWaiterErrorCode = z.infer<typeof WebhookWaiterErrorCode>;
+export declare const WebhookWaiterErrorResponseBody: z.ZodObject<{
+    error: z.ZodString;
+    code: z.ZodEnum<{
+        invalid_request: "invalid_request";
+        webhook_endpoint_not_found: "webhook_endpoint_not_found";
+        webhook_filter_invalid: "webhook_filter_invalid";
+        webhook_waiter_limit: "webhook_waiter_limit";
+    }>;
+    reason: z.ZodOptional<z.ZodEnum<{
+        endpoint_limit: "endpoint_limit";
+        environment_limit: "environment_limit";
+        shape_limit: "shape_limit";
+        timeout_too_long: "timeout_too_long";
+    }>>;
+}, z.core.$strip>;
+export type WebhookWaiterErrorResponseBody = z.infer<typeof WebhookWaiterErrorResponseBody>;
+/** `POST /api/v1/webhooks/waiters/:waiterId/cancel`. `too_late`: a delivery already claimed it. */
+export declare const CancelWebhookWaiterResponseBody: z.ZodObject<{
+    cancelled: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodLiteral<"too_late">>;
+    deliveryId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CancelWebhookWaiterResponseBody = z.infer<typeof CancelWebhookWaiterResponseBody>;

package/dist/esm/v3/schemas/webhookApi.js

@@ -12,12 +12,13 @@ export const WebhookDeliveryApiStatus = z.enum([
     "succeeded",
     "failed",
     "filtered",
+    "unmatched",
 ]);
 export const WebhookEndpointObject = z.object({
     /** Stable friendly id, e.g. `wh_...`. */
     id: z.string(),
-    /** The declared webhook() id this endpoint routes to. */
-    webhook: z.string(),
+    /** The id the endpoint is declared with in code (`webhooks.endpoint.define({ id })`). */
+    declaredId: z.string(),
     /** Provider tag, e.g. "stripe" | "github" | "standard". */
     source: z.string(),
     status: WebhookEndpointApiStatus,
@@ -36,16 +37,27 @@ export const WebhookEndpointObject = z.object({
 export const ListWebhookEndpointsResponse = z.object({
     data: z.array(WebhookEndpointObject),
 });
+export const WebhookEndpointSubscriberObject = z.object({
+    id: z.string(),
+    type: z.enum(["task", "session"]),
+    /** The subscribing task: the webhook() task, or the agent for a session subscriber. */
+    taskId: z.string(),
+    filter: z.string().nullable(),
+});
+export const WebhookEndpointDetailObject = WebhookEndpointObject.extend({
+    subscribers: z.array(WebhookEndpointSubscriberObject),
+    /** Instructions for an AI agent to register this endpoint with its provider. */
+    setupPrompt: z.string(),
+});
 export const WebhookDeliveryListItem = z.object({
     /** Stable friendly id, e.g. `whd_...`. */
     id: z.string(),
-    /** The webhook() id this delivery was routed to, if resolvable. */
-    webhook: z.string().nullable(),
+    /** The endpoint the delivery arrived on, or null if it has since been removed. */
+    endpoint: z.object({ id: z.string(), declaredId: z.string() }).nullable(),
     status: WebhookDeliveryApiStatus,
     /** Provider delivery id (Stripe event id, GitHub X-GitHub-Delivery, …). */
     externalDeliveryId: z.string(),
-    /** The triggered run's friendly id, if any. */
-    runId: z.string().nullable(),
+    isTest: z.boolean(),
     createdAt: z.coerce.date(),
     processedAt: z.coerce.date().nullable(),
 });
@@ -56,6 +68,29 @@ export const ListWebhookDeliveriesResponse = z.object({
         previous: z.string().optional(),
     }),
 });
+export const WebhookDeliveryTargetApiStatus = z.enum([
+    "pending",
+    "succeeded",
+    "failed",
+    "filtered",
+]);
+/**
+ * What a delivery did for one subscriber, or (type `waiter`) the summary of the waiting runs it
+ * matched. `runId` and `sessionId` are friendly ids.
+ */
+export const WebhookDeliveryTargetObject = z.object({
+    /** The subscriber id on the endpoint, or `waiters` for the waiter summary. */
+    id: z.string(),
+    type: z.enum(["task", "session", "waiter"]),
+    status: WebhookDeliveryTargetApiStatus,
+    /** Why a filtered target skipped the event. */
+    reason: z.string().nullable(),
+    error: z.string().nullable(),
+    runId: z.string().nullable(),
+    sessionId: z.string().nullable(),
+    /** For the waiter summary: waiting runs matched, resumed, and given up on. */
+    waiters: z.object({ matched: z.number(), resumed: z.number(), failed: z.number() }).nullable(),
+});
 export const WebhookDeliveryObject = WebhookDeliveryListItem.extend({
     idempotencyKey: z.string(),
     /** The size-capped, verified event body. */
@@ -66,6 +101,8 @@ export const WebhookDeliveryObject = WebhookDeliveryListItem.extend({
     error: z.string().nullable(),
     /** For a `filtered` delivery: why it was not routed (failing clause + actual value). */
     filterReason: z.string().nullable(),
+    /** One entry per subscriber, plus a waiter summary when waiting runs matched. */
+    targets: z.array(WebhookDeliveryTargetObject),
     updatedAt: z.coerce.date(),
 });
 // ── Write actions ──
@@ -75,6 +112,14 @@ export const RotateWebhookEndpointSecretResponse = z.object({
     secretSet: z.literal(true),
     secret: z.string(),
 });
+/** `PUT /api/v1/webhooks/endpoints/:endpointId/secret`: store a secret or public key the provider issued. */
+export const SetWebhookEndpointSecretRequestBody = z.object({
+    secret: z.string().trim().min(1).max(4096),
+});
+export const SetWebhookEndpointSecretResponse = z.object({
+    id: z.string(),
+    secretSet: z.literal(true),
+});
 /** Replaying re-runs a delivery's task from its stored event as a new delivery. */
 export const ReplayWebhookDeliveryResponse = z.object({
     /** The new delivery's friendly id (GET it once processed for the run). */
@@ -82,4 +127,52 @@ export const ReplayWebhookDeliveryResponse = z.object({
     /** The original delivery id the replay was created from. */
     replayedFrom: z.string(),
 });
+// ── Webhook waiters ──
+/**
+ * `POST /api/v1/webhooks/endpoints/:endpointId/waiters`, where `:endpointId` is the declared endpoint
+ * id or its `wh_` id. A waiter only matches deliveries that arrive after it was created.
+ */
+export const CreateWebhookWaiterRequestBody = z.object({
+    /** Paths to expected values: `event.*` reads the body, `header.*` a header and `webhook.*` the endpoint. Omit for a URL-matched waiter. */
+    match: z.record(z.string(), z.union([z.string(), z.number(), z.boolean()])).optional(),
+    /** A filter the event must also pass, checked after `match`. */
+    filter: z.string().optional(),
+    /** A duration (`"1h"`) or an ISO date. Default 24 hours, maximum 90 days. */
+    timeout: z.string().optional(),
+    tags: z.union([z.string(), z.array(z.string())]).optional(),
+    idempotencyKey: z.string().optional(),
+    idempotencyKeyTTL: z.string().optional(),
+    /** Selects a dynamic endpoint instance. Reserved: only the declared instance is supported. */
+    endpoint: z
+        .object({ tenantId: z.string().optional(), externalRef: z.string().optional() })
+        .optional(),
+});
+export const CreateWebhookWaiterResponseBody = z.object({
+    /** The waiter id, which is also its waitpoint id. */
+    id: z.string(),
+    /** For a URL-matched waiter: the URL to hand the provider as its per-request callback. */
+    url: z.string().optional(),
+    expiresAt: z.coerce.date(),
+    isCached: z.boolean(),
+});
+export const WebhookWaiterErrorCode = z.enum([
+    "webhook_waiter_limit",
+    "webhook_endpoint_not_found",
+    "webhook_filter_invalid",
+    "invalid_request",
+]);
+export const WebhookWaiterErrorResponseBody = z.object({
+    error: z.string(),
+    code: WebhookWaiterErrorCode,
+    /** For `webhook_waiter_limit`: which limit. */
+    reason: z
+        .enum(["environment_limit", "endpoint_limit", "shape_limit", "timeout_too_long"])
+        .optional(),
+});
+/** `POST /api/v1/webhooks/waiters/:waiterId/cancel`. `too_late`: a delivery already claimed it. */
+export const CancelWebhookWaiterResponseBody = z.object({
+    cancelled: z.boolean(),
+    reason: z.literal("too_late").optional(),
+    deliveryId: z.string().optional(),
+});
 //# sourceMappingURL=webhookApi.js.map

package/dist/esm/v3/schemas/webhookApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"webhookApi.js","sourceRoot":"","sources":["../../../../src/v3/schemas/webhookApi.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"webhookApi.js","sourceRoot":"","sources":["../../../../src/v3/schemas/webhookApi.ts"],"names":[],"mappings":"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"}

package/dist/esm/v3/schemas/webhookConfig.d.ts

@@ -1,4 +1,5 @@
 import { z } from "zod/v4";
+import type { FilterAst } from "./webhookFilter.js";
 export declare const WebhookSecretProvisioning: z.ZodEnum<{
     either: "either";
     integrator: "integrator";
@@ -470,6 +471,10 @@ export type WebhookHandshakeConfig = z.infer<typeof WebhookHandshakeConfig>;
  */
 export declare const WebhookResponseConfig: z.ZodObject<{
     acceptedStatus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<200>, z.ZodLiteral<202>, z.ZodLiteral<204>]>>;
+    acceptedBody: z.ZodOptional<z.ZodEnum<{
+        empty: "empty";
+        json: "json";
+    }>>;
     rejectedStatus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<400>, z.ZodLiteral<401>, z.ZodLiteral<403>]>>;
 }, z.core.$strip>;
 export type WebhookResponseConfig = z.infer<typeof WebhookResponseConfig>;
@@ -677,6 +682,10 @@ export declare const WebhookVerifierArtifact: import("../utils/zod.js").Compatib
     }, z.core.$strip>>;
     response: z.ZodOptional<z.ZodObject<{
         acceptedStatus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<200>, z.ZodLiteral<202>, z.ZodLiteral<204>]>>;
+        acceptedBody: z.ZodOptional<z.ZodEnum<{
+            empty: "empty";
+            json: "json";
+        }>>;
         rejectedStatus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<400>, z.ZodLiteral<401>, z.ZodLiteral<403>]>>;
     }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
@@ -872,6 +881,10 @@ export declare const WebhookVerifierArtifact: import("../utils/zod.js").Compatib
     }, z.core.$strip>>;
     response: z.ZodOptional<z.ZodObject<{
         acceptedStatus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<200>, z.ZodLiteral<202>, z.ZodLiteral<204>]>>;
+        acceptedBody: z.ZodOptional<z.ZodEnum<{
+            empty: "empty";
+            json: "json";
+        }>>;
         rejectedStatus: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<400>, z.ZodLiteral<401>, z.ZodLiteral<403>]>>;
     }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
@@ -880,11 +893,20 @@ export declare const WebhookVerifierArtifact: import("../utils/zod.js").Compatib
     hash: z.ZodString;
 }, z.core.$strip>]>;
 export type WebhookVerifierArtifact = z.infer<typeof WebhookVerifierArtifact>;
+/**
+ * One subscriber of a shared endpoint. `id` is the descriptor that declared it (the `webhook()` id, or
+ * `agentId:eventId` / `agentId:connectorId` for a session subscriber) and is unique within the endpoint.
+ * `filter` is this subscriber's own delivery filter; the session variant's `startOn` separately gates
+ * session creation.
+ */
 export declare const WebhookRoutingTarget: import("../utils/zod.js").CompatibleZodDiscriminatedUnion<readonly [z.ZodObject<{
     type: z.ZodLiteral<"task">;
+    id: z.ZodString;
     taskId: z.ZodString;
+    filter: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"session">;
+    id: z.ZodString;
     taskIdentifier: z.ZodString;
     keyTemplate: z.ZodString;
     deliverAs: z.ZodEnum<{
@@ -895,8 +917,50 @@ export declare const WebhookRoutingTarget: import("../utils/zod.js").CompatibleZ
     connectorId: z.ZodOptional<z.ZodString>;
     triggerConfigTemplate: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     startOn: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>]>;
 export type WebhookRoutingTarget = z.infer<typeof WebhookRoutingTarget>;
+/** A routing target as stored on `WebhookEndpoint.routingTargets`, with its filter compiled at deploy. */
+export type StoredWebhookRoutingTarget = WebhookRoutingTarget & {
+    filterAst?: FilterAst;
+    filterAstVersion?: number;
+};
+export declare const WebhookDeliveryTargetStatus: z.ZodEnum<{
+    FAILED: "FAILED";
+    FILTERED: "FILTERED";
+    PENDING: "PENDING";
+    SUCCEEDED: "SUCCEEDED";
+}>;
+export type WebhookDeliveryTargetStatus = z.infer<typeof WebhookDeliveryTargetStatus>;
+/** One target's outcome for one delivery, stored on `WebhookDelivery.targets`. */
+export declare const WebhookDeliveryTargetResult: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        session: "session";
+        task: "task";
+        waiter: "waiter";
+    }>;
+    status: z.ZodEnum<{
+        FAILED: "FAILED";
+        FILTERED: "FILTERED";
+        PENDING: "PENDING";
+        SUCCEEDED: "SUCCEEDED";
+    }>;
+    reason: z.ZodOptional<z.ZodString>;
+    runId: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    deliverAs: z.ZodOptional<z.ZodEnum<{
+        action: "action";
+        message: "message";
+    }>>;
+    taskId: z.ZodOptional<z.ZodString>;
+    waiters: z.ZodOptional<z.ZodObject<{
+        matched: z.ZodNumber;
+        resumed: z.ZodNumber;
+        failed: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type WebhookDeliveryTargetResult = z.infer<typeof WebhookDeliveryTargetResult>;
 export declare const WebhookVerifierResult: z.ZodObject<{
     ok: z.ZodBoolean;
     idempotencyKey: z.ZodString;

package/dist/esm/v3/schemas/webhookConfig.js

@@ -147,6 +147,11 @@ export const WebhookHandshakeConfig = z.object({
 export const WebhookResponseConfig = z.object({
     /** Status for a recorded or deduplicated delivery. 204 sends no body. Default 200 with a JSON body. */
     acceptedStatus: z.union([z.literal(200), z.literal(202), z.literal(204)]).optional(),
+    /**
+     * Body for a recorded or deduplicated delivery. `"empty"` answers with no body, for providers
+     * that show a non-empty reply to the user (Slack slash commands). Default `"json"`.
+     */
+    acceptedBody: z.enum(["json", "empty"]).optional(),
     /** Status when signature verification fails. Default 400. */
     rejectedStatus: z.union([z.literal(400), z.literal(401), z.literal(403)]).optional(),
 });
@@ -189,26 +194,48 @@ export const WebhookVerifierArtifact = discriminatedUnion("kind", [
     }),
     z.object({ kind: z.literal("bundle"), bundleUrl: z.string(), hash: z.string() }), // P3 seam
 ]);
-// ── Routing target: data-only tagged union stored on WebhookEndpoint.routingTarget ──
-// P1 implements only { type: "task" }. The session variant routes a delivery to a find-or-created
-// session: keyTemplate resolves the externalId, deliverAs selects the mode. "action" (chat.event)
-// carries actionType → the onAction envelope's action.type; "message" (channels) carries connectorId
-// → the run resolves the connector's inbound() mapper and runs a turn.
+/**
+ * One subscriber of a shared endpoint. `id` is the descriptor that declared it (the `webhook()` id, or
+ * `agentId:eventId` / `agentId:connectorId` for a session subscriber) and is unique within the endpoint.
+ * `filter` is this subscriber's own delivery filter; the session variant's `startOn` separately gates
+ * session creation.
+ */
 export const WebhookRoutingTarget = discriminatedUnion("type", [
-    z.object({ type: z.literal("task"), taskId: z.string() }),
+    z.object({
+        type: z.literal("task"),
+        id: z.string().min(1),
+        taskId: z.string(),
+        filter: z.string().optional(),
+    }),
     z.object({
         type: z.literal("session"),
+        id: z.string().min(1),
         taskIdentifier: z.string(),
         keyTemplate: z.string(),
         deliverAs: z.enum(["action", "message"]),
         actionType: z.string().optional(),
         connectorId: z.string().optional(),
         triggerConfigTemplate: z.record(z.string(), z.unknown()).optional(),
-        // Gate session CREATION: an event that already resolves to an existing session always resumes it,
-        // but a key with no session is only started when the event matches this filter. Absent => always start.
         startOn: z.string().optional(),
+        filter: z.string().optional(),
     }),
 ]);
+export const WebhookDeliveryTargetStatus = z.enum(["PENDING", "FILTERED", "SUCCEEDED", "FAILED"]);
+/** One target's outcome for one delivery, stored on `WebhookDelivery.targets`. */
+export const WebhookDeliveryTargetResult = z.object({
+    id: z.string(),
+    type: z.enum(["task", "session", "waiter"]),
+    status: WebhookDeliveryTargetStatus,
+    reason: z.string().optional(),
+    runId: z.string().optional(),
+    error: z.string().optional(),
+    /** For a session target: how it was delivered, kept so the result reads the same after a redeploy. */
+    deliverAs: z.enum(["action", "message"]).optional(),
+    /** On a replay's target: the task the replay was authorized to reach. If the subscriber now points elsewhere, it fails instead of running. */
+    taskId: z.string().optional(),
+    /** On the delivery's one waiter entry: how many waiters it matched, resumed and failed to resume. */
+    waiters: z.object({ matched: z.number(), resumed: z.number(), failed: z.number() }).optional(),
+});
 // ── Data-only verdict the engine verifier returns (M5 consumes) ──
 export const WebhookVerifierResult = z.object({
     ok: z.boolean(),