@trigger.dev/core 4.7.3 → 4.8.0-webhooks.20261015065339

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

@@ -137,14 +137,109 @@ export const ListConcurrencyLimitOptions = z.object({
     page: z.number().optional(),
     perPage: z.number().optional(),
 });
-/** Changes only the given bounds. Zero blocks every run holding the limit, which
- * is how a limit is paused; `reset` restores the declared values. */
-export const OverrideConcurrencyLimitRequestBody = z
+/** A concurrency-key value as callers write it: numbers are accepted and stored as strings,
+ * matching how a trigger's `concurrencyKey` is coerced. */
+const OverrideConcurrencyKeySchema = z
+    .union([z.string(), z.number()])
+    .transform((value) => String(value))
+    .pipe(z.string().min(1).max(128));
+const ConcurrencyBoundSchema = z.number().int().min(0).max(100000);
+const OverrideTtlSchema = z.string().or(z.number().int().positive());
+/** Changes only the given bounds of the limit itself. Zero blocks every run holding
+ * the limit, which is how a limit is paused; `reset` restores the declared values. */
+export const OverrideConcurrencyLimitBoundsBody = z
     .object({
-    perKey: z.number().int().min(0).max(100000).optional(),
-    total: z.number().int().min(0).max(100000).optional(),
+    perKey: ConcurrencyBoundSchema.optional(),
+    total: ConcurrencyBoundSchema.optional(),
+    concurrencyKey: z.never().optional(),
+    ttl: z.never().optional(),
 })
     .refine((body) => body.perKey !== undefined || body.total !== undefined, {
     message: "Provide at least one of `perKey` or `total`",
 });
+/** A temporary per-key cap on this limit's `perKey` for one concurrencyKey: `0`
+ * blocks the key, and the override expires after `ttl` (a duration such as `"7d"`
+ * or a number of seconds; default 7 days, at most 30 days). `total` is not per key,
+ * so it cannot be given here. `reset` with the same `concurrencyKey` clears it. */
+export const OverrideConcurrencyLimitKeyBody = z.object({
+    concurrencyKey: OverrideConcurrencyKeySchema,
+    perKey: ConcurrencyBoundSchema,
+    ttl: OverrideTtlSchema.optional(),
+    total: z.never().optional(),
+});
+/** Either the limit's own bounds or a per-key cap, told apart by `concurrencyKey`.
+ * The output type is the union of the two shapes above, so `total` with a key, a key
+ * without `perKey`, and `ttl` without a key are type errors for SDK callers. Parsing
+ * goes through one flat object with cross-field checks rather than a `z.union`, so an
+ * HTTP caller gets a single message naming the field at fault instead of the failures
+ * of both branches. */
+export const OverrideConcurrencyLimitRequestBody = z
+    .object({
+    perKey: ConcurrencyBoundSchema.optional(),
+    total: ConcurrencyBoundSchema.optional(),
+    concurrencyKey: OverrideConcurrencyKeySchema.optional(),
+    ttl: OverrideTtlSchema.optional(),
+})
+    .superRefine((body, ctx) => {
+    if (body.concurrencyKey !== undefined) {
+        if (body.perKey === undefined) {
+            ctx.addIssue({
+                code: "custom",
+                path: ["perKey"],
+                message: "A per-key override needs `perKey`",
+            });
+        }
+        if (body.total !== undefined) {
+            ctx.addIssue({
+                code: "custom",
+                path: ["total"],
+                message: "`total` is not per key; omit it when overriding one concurrencyKey",
+            });
+        }
+        return;
+    }
+    if (body.ttl !== undefined) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["ttl"],
+            message: "`ttl` only applies to a per-key override; pass `concurrencyKey` with it",
+        });
+    }
+    if (body.perKey === undefined && body.total === undefined) {
+        ctx.addIssue({
+            code: "custom",
+            message: "Provide at least one of `perKey` or `total`",
+        });
+    }
+})
+    .transform((body) => body);
+/** `reset` with a `concurrencyKey` clears that key's override and leaves the limit
+ * itself alone; without one it resets the limit's own override. */
+export const ResetConcurrencyLimitRequestBody = z.object({
+    concurrencyKey: OverrideConcurrencyKeySchema.optional(),
+});
+export const RetrieveConcurrencyLimitOptions = z.object({
+    /** Return the view of this limit for one concurrencyKey instead of the limit itself. */
+    concurrencyKey: OverrideConcurrencyKeySchema.optional(),
+});
+/** The per-key bound of a limit for one concurrencyKey: `base` is the limit's own
+ * `perKey` as enforced, `override` the key's temporary cap, `current` whichever
+ * applies right now (env-clamped). A paused limit still reports its bounds. */
+export const ConcurrencyLimitKeyBound = z.object({
+    current: z.number().nullable(),
+    base: z.number().nullable(),
+    override: z.number().nullable(),
+    /** When the key's override lapses; null when there is none. */
+    expiresAt: z.coerce.date().nullable(),
+});
+export const ConcurrencyLimitKeyItem = z.object({
+    /** The limit's name. */
+    name: z.string(),
+    concurrencyKey: z.string(),
+    perKey: ConcurrencyLimitKeyBound,
+    /** Runs executing for this key that hold this limit. */
+    running: z.number(),
+    /** Whether the limit is paused. A paused limit admits no runs, override or not. */
+    paused: z.boolean(),
+});
 //# sourceMappingURL=queues.js.map

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

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

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

@@ -1,6 +1,5 @@
 import { z } from "zod/v4";
 import type { RuntimeEnvironmentType } from "./common.js";
-import { SnapshotRouteWire } from "./snapshotRoute.js";
 export declare const TriggerSource: z.ZodUnion<[z.ZodEnum<{
     api: "api";
     cli: "cli";
@@ -53,8 +52,16 @@ export declare const RunAnnotations: z.ZodObject<{
     externalDeploymentId: z.ZodOptional<z.ZodString>;
     webhookDeliveryId: z.ZodOptional<z.ZodString>;
     webhookEndpointId: z.ZodOptional<z.ZodString>;
+    workerCell: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    workerLane: z.ZodCatch<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>;
 export type RunAnnotations = z.infer<typeof RunAnnotations>;
+/** Lenient read of the worker stamp: works on blobs that predate or fail RunAnnotations. */
+export declare const WorkerStampAnnotations: z.ZodObject<{
+    workerCell: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    workerLane: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export type WorkerStampAnnotations = z.infer<typeof WorkerStampAnnotations>;
 export declare const TaskRunExecutionStatus: {
     RUN_CREATED: "RUN_CREATED";
     QUEUED: "QUEUED";
@@ -645,7 +652,6 @@ export declare const PlacementTag: z.ZodObject<{
 }, z.core.$strip>;
 export type PlacementTag = z.infer<typeof PlacementTag>;
 /** This is sent to a Worker when a run is dequeued (a new run or continuing run) */
-export { SnapshotRouteWire };
 export declare const DequeuedMessage: z.ZodObject<{
     version: z.ZodLiteral<"1">;
     snapshot: z.ZodObject<{
@@ -666,15 +672,6 @@ export declare const DequeuedMessage: z.ZodObject<{
         description: z.ZodString;
         createdAt: z.ZodCoercedDate<unknown>;
     }, z.core.$strip>;
-    snapshotRoute: z.ZodOptional<z.ZodObject<{
-        version: z.ZodLiteral<1>;
-        residency: z.ZodEnum<{
-            mirrored: "mirrored";
-            postgres: "postgres";
-            "redis-primary": "redis-primary";
-        }>;
-        organizationId: z.ZodString;
-    }, z.core.$strip>>;
     dequeuedAt: z.ZodCoercedDate<unknown>;
     workerQueueLength: z.ZodOptional<z.ZodNumber>;
     image: z.ZodOptional<z.ZodString>;
@@ -782,6 +779,8 @@ export declare const DequeuedMessage: z.ZodObject<{
             externalDeploymentId: z.ZodOptional<z.ZodString>;
             webhookDeliveryId: z.ZodOptional<z.ZodString>;
             webhookEndpointId: z.ZodOptional<z.ZodString>;
+            workerCell: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+            workerLane: z.ZodCatch<z.ZodOptional<z.ZodString>>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
     environment: z.ZodObject<{
@@ -806,3 +805,4 @@ export declare const DequeuedMessage: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type DequeuedMessage = z.infer<typeof DequeuedMessage>;
+export {};

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

@@ -2,7 +2,6 @@ import { z } from "zod/v4";
 import { discriminatedUnion } from "../utils/zod.js";
 import { MachinePreset, TaskRunExecution } from "./common.js";
 import { EnvironmentType } from "./schemas.js";
-import { SnapshotRouteWire } from "./snapshotRoute.js";
 const anyString = z.custom((v) => typeof v === "string");
 export const TriggerSource = z
     .enum(["sdk", "api", "dashboard", "cli", "mcp", "schedule"])
@@ -20,6 +19,14 @@ export const RunAnnotations = z.object({
     webhookDeliveryId: z.string().optional(),
     /** The endpoint (friendly id) that delivery arrived on. */
     webhookEndpointId: z.string().optional(),
+    /** Where the most recently stamped attempt executed. Set by the supervisor at attempt start. */
+    workerCell: z.string().optional().catch(undefined),
+    workerLane: z.string().optional().catch(undefined),
+});
+/** Lenient read of the worker stamp: works on blobs that predate or fail RunAnnotations. */
+export const WorkerStampAnnotations = z.object({
+    workerCell: z.string().optional().catch(undefined),
+    workerLane: z.string().optional().catch(undefined),
 });
 export const TaskRunExecutionStatus = {
     RUN_CREATED: "RUN_CREATED",
@@ -189,15 +196,9 @@ export const PlacementTag = z.object({
     values: z.array(z.string()).optional(),
 });
 /** This is sent to a Worker when a run is dequeued (a new run or continuing run) */
-// Defined in the ./snapshotRoute.js leaf and re-exported here (its historical public location) to avoid
-// a module-init cycle with supervisor/schemas.ts. See that file for the rationale. The local import lets
-// this module still use it as a value below (e.g. DequeuedMessage); the export carries both value + type.
-export { SnapshotRouteWire };
 export const DequeuedMessage = z.object({
     version: z.literal("1"),
     snapshot: ExecutionSnapshot,
-    // Absent for a never-enrolled (postgres) run and for messages produced before this field existed.
-    snapshotRoute: SnapshotRouteWire.optional(),
     dequeuedAt: z.coerce.date(),
     workerQueueLength: z.number().optional(),
     image: z.string().optional(),

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

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

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

@@ -52,24 +52,63 @@ type FilterError<M extends string> = `✖ ${M}`;
 type Invalid = {
     readonly "~webhookFilterInvalid": true;
 };
-type PathValue<T, P extends string> = P extends `${infer H}.${infer R}` ? H extends keyof T ? PathValue<NonNullable<T[H]>, R> : Invalid : P extends keyof T ? NonNullable<T[P]> : Invalid;
-type ResolveFilterPath<TEvent, P extends string> = P extends `event.${infer R}` ? PathValue<TEvent, R> : P extends `header.${string}` ? string : P extends `webhook.${infer R}` ? PathValue<WebhookFilterMeta, R> : Invalid;
+type IsValidFilterPath<P extends string> = P extends "" | `.${string}` | `${string}.` | `${string}..${string}` ? false : true;
+type KnownValue<T> = unknown extends T ? unknown : NonNullable<T>;
+/** Resolves per union member, so a path only some members have still resolves. */
+type MemberPathValue<T, P extends string> = unknown extends T ? unknown : NonNullable<T> extends infer M ? M extends unknown ? P extends `${infer H}.${infer R}` ? H extends keyof M ? MemberPathValue<M[H], R> : Invalid : P extends keyof M ? KnownValue<M[P]> : Invalid : never : never;
+type PathValue<T, P extends string> = IsValidFilterPath<P> extends false ? Invalid : [Exclude<MemberPathValue<T, P>, Invalid>] extends [never] ? Invalid : Exclude<MemberPathValue<T, P>, Invalid>;
+type ResolveFilterPath<TEvent, P extends string> = IsValidFilterPath<P> extends false ? Invalid : P extends `event.${infer R}` ? PathValue<TEvent, R> : P extends `header.${string}` ? string : P extends `webhook.${infer R}` ? PathValue<WebhookFilterMeta, R> : Invalid;
 type FilterLiteralType<Lit extends string> = Lit extends `'${infer S}'` ? S : Lit extends `${infer N extends number}` ? N : Lit extends "true" ? true : Lit extends "false" ? false : Lit extends "null" ? null : Invalid;
 type CheckValue<F, Lit extends string, P extends string> = [FilterLiteralType<Lit>] extends [
     Invalid
 ] ? FilterError<`cannot parse value: ${Lit}`> : [FilterLiteralType<Lit>] extends [F] ? true : FilterError<`value ${Lit} is not valid for ${P}`>;
-type CheckNum<F, Lit extends string, P extends string> = [F] extends [number] ? Lit extends `${number}` ? true : FilterError<`${P} needs a number`> : FilterError<`${P} is not numeric`>;
-type CheckStr<F, Lit extends string, P extends string> = [F] extends [string] ? Lit extends `'${string}'` ? true : FilterError<`${P} op needs a string literal`> : FilterError<`${P} is not a string`>;
-type CheckInItems<F, Items extends string, P extends string> = Items extends `${infer Head},${infer Tail}` ? CheckValue<F, Head, P> extends true ? CheckInItems<F, Tail, P> : CheckValue<F, Head, P> : CheckValue<F, Items, P>;
+type CheckNum<F, Lit extends string, P extends string> = [
+    Extract<unknown extends F ? number : F, number>
+] extends [never] ? FilterError<`${P} is not numeric`> : Lit extends `${number}` ? true : FilterError<`${P} needs a number`>;
+type CheckStr<F, Lit extends string, P extends string> = [
+    Extract<unknown extends F ? string : F, string>
+] extends [never] ? FilterError<`${P} is not a string`> : Lit extends `'${string}'` ? true : FilterError<`${P} op needs a string literal`>;
+type TrimItem<S extends string> = S extends ` ${infer R}` ? TrimItem<R> : S extends `${infer L} ` ? TrimItem<L> : S;
+type CheckInItems<F, Items extends string, P extends string> = Items extends `${infer Head},${infer Tail}` ? CheckValue<F, TrimItem<Head>, P> extends true ? CheckInItems<F, Tail, P> : CheckValue<F, TrimItem<Head>, P> : CheckValue<F, TrimItem<Items>, P>;
 type CheckIn<F, Lit extends string, P extends string> = Lit extends `[${infer Items}]` ? CheckInItems<F, Items, P> : FilterError<`${P} "in" expects a [list]`>;
 type CheckOp<F, Op extends string, Lit extends string, P extends string> = Op extends "==" | "!=" ? CheckValue<F, Lit, P> : Op extends ">" | "<" | ">=" | "<=" ? CheckNum<F, Lit, P> : Op extends "startsWith" | "endsWith" | "contains" ? CheckStr<F, Lit, P> : Op extends "in" ? CheckIn<F, Lit, P> : FilterError<`unknown operator: ${Op}`>;
 type IsFilterPath<S extends string> = S extends `event.${string}` | `header.${string}` | `webhook.${string}` ? true : false;
 type CheckFieldToField<TEvent, F, Op extends string, Rhs extends string, P extends string> = Op extends "==" | "!=" | ">" | "<" | ">=" | "<=" ? ResolveFilterPath<TEvent, Rhs> extends infer RF ? [RF] extends [Invalid] ? FilterError<`unknown field: ${Rhs}`> : [RF] extends [F] ? true : [F] extends [RF] ? true : FilterError<`${P} and ${Rhs} are not comparable`> : never : FilterError<`operator "${Op}" does not support a field reference`>;
 type LeafCheck<TEvent, P extends string, Op extends string, Lit extends string> = ResolveFilterPath<TEvent, P> extends infer F ? [F] extends [Invalid] ? FilterError<`unknown field: ${P}`> : IsFilterPath<Lit> extends true ? CheckFieldToField<TEvent, F, Op, Lit, P> : CheckOp<F, Op, Lit, P> : never;
-type ElementOf<T> = T extends readonly (infer E)[] ? E : never;
+type ElementOf<T> = unknown extends T ? unknown : T extends readonly (infer E)[] ? E : never;
 type CheckQuantifier<TEvent, ArrP extends string, SubP extends string, Op extends string, Lit extends string> = ResolveFilterPath<TEvent, ArrP> extends infer Arr ? [Arr] extends [Invalid] ? FilterError<`unknown field: ${ArrP}`> : [ElementOf<Arr>] extends [never] ? FilterError<`${ArrP} is not an array`> : PathValue<ElementOf<Arr>, SubP> extends infer SF ? [SF] extends [Invalid] ? FilterError<`unknown field: ${SubP} (in ${ArrP})`> : CheckOp<SF, Op, Lit, SubP> : never : never;
-type Tokenize<S extends string, Acc extends string[] = []> = S extends `${infer H} ${infer R}` ? Tokenize<R, [...Acc, H]> : [...Acc, S];
-type Scan<TEvent, Tk extends string[], Depth extends 1[], Expect extends "operand" | "operator"> = Expect extends "operand" ? Tk extends ["(", ...infer Rest extends string[]] ? Scan<TEvent, Rest, [1, ...Depth], "operand"> : Tk extends [")" | "&&" | "||", ...string[]] ? FilterError<`unexpected "${Tk[0] & string}"`> : Tk extends [
+type OddQuotes<S extends string, Odd extends boolean = false> = S extends `${string}'${infer R}` ? OddQuotes<R, Odd extends true ? false : true> : Odd;
+type Unclosed<S extends string> = OddQuotes<S> extends true ? true : S extends `${string}[${infer After}` ? After extends `${string}]${string}` ? false : true : false;
+/** Splits on spaces, keeping a quoted string or a `[list]` that contains spaces as one token. */
+type SplitOnSpaces<S extends string, Acc extends string[] = []> = S extends `${infer H} ${infer R}` ? Unclosed<H> extends true ? TokenizeJoin<R, H, Acc> : SplitOnSpaces<R, [...Acc, H]> : [...Acc, S];
+type TokenizeJoin<S extends string, Cur extends string, Acc extends string[]> = S extends `${infer H} ${infer R}` ? Unclosed<`${Cur} ${H}`> extends true ? TokenizeJoin<R, `${Cur} ${H}`, Acc> : SplitOnSpaces<R, [...Acc, `${Cur} ${H}`]> : [...Acc, `${Cur} ${S}`];
+type SplitClose<S extends string, Post extends string[] = []> = S extends `${infer L})` ? SplitClose<L, [")", ...Post]> : S extends "" ? Post : [S, ...Post];
+type SplitOpen<S extends string, Pre extends string[] = []> = S extends `(${infer R}` ? SplitOpen<R, [...Pre, "("]> : [...Pre, ...SplitClose<S>];
+type SplitParens<Tk extends string[], Acc extends string[] = []> = Tk extends [
+    infer H extends string,
+    ...infer R extends string[]
+] ? SplitParens<R, [...Acc, ...(H extends `'${string}'` ? [H] : SplitOpen<H>)]> : Acc;
+type Tokenize<S extends string> = SplitParens<SplitOnSpaces<S>>;
+type InItemTypes<Items extends string, Acc = never> = Items extends `${infer Head},${infer Tail}` ? InItemTypes<Tail, Acc | FilterLiteralType<TrimItem<Head>>> : Acc | FilterLiteralType<TrimItem<Items>>;
+type LooseEqKind<V> = V extends string ? string : V extends number ? number : unknown;
+/**
+ * Drops a member only when its field can never equal `V` under the server's coercing `==`: the field
+ * is missing, or holds only values of `V`'s own primitive kind that differ from it.
+ */
+type NarrowTo<T, P extends string, V> = V extends unknown ? T extends unknown ? Exclude<MemberPathValue<T, P>, Invalid> extends infer F ? [V] extends [F] ? T : [F] extends [LooseEqKind<V>] ? never : T : never : never : never;
+/**
+ * The server's `==` also matches a null field for `null`, `'null'` and `0`, so those never narrow,
+ * nor does a number literal TypeScript can't type exactly (`0.0`, `-0`), which reads as `number`.
+ */
+type NarrowEq<T, P extends string, V> = unknown extends T ? T : number extends V ? T : [Extract<V, null | "null" | 0>] extends [never] ? NarrowTo<T, P, V> : T;
+type NarrowLeaf<T, P extends string, Op extends string, Lit extends string> = P extends `event.${infer R}` ? Op extends "==" ? IsFilterPath<Lit> extends true ? T : NarrowEq<T, R, FilterLiteralType<Lit>> : Op extends "in" ? Lit extends `[${infer Items}]` ? NarrowEq<T, R, InItemTypes<Items>> : T : T : T;
+type Frame = [unknown, unknown];
+/**
+ * `Cur` is the event the current `&&` chain has narrowed to. Each paren group (and the whole filter)
+ * is a frame of [the type the group started from, the union of its finished `||` branches]. A valid
+ * filter scans to `[narrowed event]`, an invalid one to its error.
+ */
+type Scan<Cur, Tk extends string[], Frames extends Frame[], Expect extends "operand" | "operator"> = Expect extends "operand" ? Tk extends ["(", ...infer Rest extends string[]] ? Scan<Cur, Rest, [[Cur, never], ...Frames], "operand"> : Tk extends [")" | "&&" | "||", ...string[]] ? FilterError<`unexpected "${Tk[0] & string}"`> : Tk extends [
     infer ArrP extends string,
     "any" | "all",
     "(",
@@ -78,18 +117,31 @@ type Scan<TEvent, Tk extends string[], Depth extends 1[], Expect extends "operan
     infer SubLit extends string,
     ")",
     ...infer Rest extends string[]
-] ? CheckQuantifier<TEvent, ArrP, SubP, SubOp, SubLit> extends infer R ? R extends true ? Scan<TEvent, Rest, Depth, "operator"> : R : never : Tk extends [
+] ? CheckQuantifier<Cur, ArrP, SubP, SubOp, SubLit> extends infer R ? R extends true ? Scan<Cur, Rest, Frames, "operator"> : R : never : Tk extends [
     infer P extends string,
     "not",
     "in",
     infer Lit extends string,
     ...infer Rest extends string[]
-] ? ResolveFilterPath<TEvent, P> extends infer F ? [F] extends [Invalid] ? FilterError<`unknown field: ${P}`> : CheckIn<F, Lit, P> extends infer R ? R extends true ? Scan<TEvent, Rest, Depth, "operator"> : R : never : never : Tk extends [
+] ? ResolveFilterPath<Cur, P> extends infer F ? [F] extends [Invalid] ? FilterError<`unknown field: ${P}`> : CheckIn<F, Lit, P> extends infer R ? R extends true ? Scan<Cur, Rest, Frames, "operator"> : R : never : never : Tk extends [
     infer P extends string,
     infer Op extends string,
     infer Lit extends string,
     ...infer Rest extends string[]
-] ? LeafCheck<TEvent, P, Op, Lit> extends infer R ? R extends true ? Scan<TEvent, Rest, Depth, "operator"> : R : never : FilterError<`incomplete clause`> : Tk extends [] ? Depth extends [] ? true : FilterError<`unbalanced parens (missing ")")`> : Tk extends ["&&" | "||", ...infer Rest extends string[]] ? Scan<TEvent, Rest, Depth, "operand"> : Tk extends [")", ...infer Rest extends string[]] ? Depth extends [1, ...infer D extends 1[]] ? Scan<TEvent, Rest, D, "operator"> : FilterError<`unmatched ")"`> : FilterError<`expected && or ||, got "${Tk[0] & string}"`>;
-type ScanFilter<TEvent, S extends string> = Scan<TEvent, Tokenize<S>, [], "operand">;
-export type ValidateWebhookFilter<TEvent, S extends string> = ScanFilter<TEvent, S> extends true ? S : ScanFilter<TEvent, S>;
+] ? LeafCheck<Cur, P, Op, Lit> extends infer R ? R extends true ? Scan<NarrowLeaf<Cur, P, Op, Lit>, Rest, Frames, "operator"> : R : never : FilterError<`incomplete clause`> : Tk extends [] ? Frames extends [[unknown, infer Done]] ? [Done | Cur] : FilterError<`unbalanced parens (missing ")")`> : Tk extends ["&&", ...infer Rest extends string[]] ? Scan<Cur, Rest, Frames, "operand"> : Tk extends ["||", ...infer Rest extends string[]] ? Frames extends [[infer Base, infer Done], ...infer Outer extends Frame[]] ? Scan<Base, Rest, [[Base, Done | Cur], ...Outer], "operand"> : never : Tk extends [")", ...infer Rest extends string[]] ? Frames extends [
+    [
+        unknown,
+        infer Done
+    ],
+    infer Next extends Frame,
+    ...infer Outer extends Frame[]
+] ? Scan<Done | Cur, Rest, [Next, ...Outer], "operator"> : FilterError<`unmatched ")"`> : FilterError<`expected && or ||, got "${Tk[0] & string}"`>;
+type ScanFilter<TEvent, S extends string> = Scan<TEvent, Tokenize<S>, [[TEvent, never]], "operand">;
+export type ValidateWebhookFilter<TEvent, S extends string> = string extends S ? S : ScanFilter<TEvent, S> extends [unknown] ? S : ScanFilter<TEvent, S>;
+/**
+ * The event a handler sees once the filter `S` has passed: the members of a union event that the
+ * filter's `event.<path> == <literal>` (or `in [...]`) clauses select, or `TEvent` when the filter
+ * doesn't narrow it (or isn't a literal).
+ */
+export type NarrowWebhookEvent<TEvent, S extends string> = string extends S ? TEvent : ScanFilter<TEvent, S> extends [infer Narrowed] ? Narrowed : TEvent;
 export {};

package/dist/esm/v3/types/chatEvents.d.ts

@@ -1,4 +1,4 @@
-import type { WebhookSecretProvisioning, WebhookVerifierArtifact } from "../schemas/webhookConfig.js";
+import type { WebhookEndpointContext } from "./webhooks.js";
 export type WebhookKeyScalar = string | number | boolean | bigint;
 export interface WebhookKeyMeta {
     externalRef: string;
@@ -14,18 +14,32 @@ type Invalid = {
 type PathValue<T, P extends string> = P extends `${infer Head}.${infer Rest}` ? Head extends keyof T ? PathValue<NonNullable<T[Head]>, Rest> : Invalid : P extends keyof T ? NonNullable<T[P]> : Invalid;
 export type WebhookKeyError<M extends string> = `✖ ${M}`;
 type TrimSpace<S extends string> = S extends ` ${infer R}` ? TrimSpace<R> : S extends `${infer L} ` ? TrimSpace<L> : S;
-type CheckKeyPathSingle<TEvent, Path extends string> = Path extends `webhook.${infer Rest}` ? PathValue<WebhookKeyMeta, Rest> extends WebhookKeyScalar ? true : WebhookKeyError<`unknown or non-scalar webhook meta path: ${Rest}`> : Path extends `header.${infer Name}` ? Name extends "" ? WebhookKeyError<`empty header name`> : true : Path extends `body.${infer Rest}` ? PathValue<TEvent, Rest> extends WebhookKeyScalar ? true : WebhookKeyError<`unknown or non-scalar event path: ${Rest}`> : PathValue<TEvent, Path> extends WebhookKeyScalar ? true : WebhookKeyError<`unknown or non-scalar event path: ${Path}`>;
 type CheckKeyPath<TEvent, Path extends string> = Path extends `${infer L}||${infer R}` ? CheckKeyPathSingle<TEvent, TrimSpace<L>> extends true ? CheckKeyPath<TEvent, TrimSpace<R>> : CheckKeyPathSingle<TEvent, TrimSpace<L>> : CheckKeyPathSingle<TEvent, TrimSpace<Path>>;
 type CheckKeyTemplate<TEvent, S extends string> = S extends `${infer _Pre}{${infer Path}}${infer Rest}` ? CheckKeyPath<TEvent, Path> extends true ? CheckKeyTemplate<TEvent, Rest> : CheckKeyPath<TEvent, Path> : true;
 export type ValidatedWebhookKey<TEvent, S extends string> = CheckKeyTemplate<TEvent, S> extends true ? S : CheckKeyTemplate<TEvent, S>;
+type MatchNext<X> = unknown extends X ? unknown : NonNullable<X>;
+type MatchPathValue<T, P extends string> = unknown extends T ? unknown : P extends `${infer Head}.${infer Rest}` ? Head extends keyof T ? MatchPathValue<MatchNext<T[Head]>, Rest> : string extends keyof T ? unknown : Invalid : P extends keyof T ? MatchNext<T[P]> : string extends keyof T ? unknown : Invalid;
+type CheckEventPath<TEvent, Path extends string> = Path extends "" | `.${string}` | `${string}.` | `${string}..${string}` ? WebhookKeyError<`empty path segment: ${Path}`> : MatchPathValue<TEvent, Path> extends Invalid ? WebhookKeyError<`unknown event path: ${Path}`> : unknown extends MatchPathValue<TEvent, Path> ? true : MatchPathValue<TEvent, Path> extends WebhookKeyScalar ? true : WebhookKeyError<`non-scalar event path: ${Path}`>;
+type CheckMetaPath<Path extends string> = Path extends `header.${infer Name}` ? Name extends "" ? WebhookKeyError<`empty header name`> : true : Path extends `webhook.${infer Rest}` ? PathValue<WebhookKeyMeta, Rest> extends WebhookKeyScalar ? true : WebhookKeyError<`unknown or non-scalar webhook meta path: ${Rest}`> : false;
+type CheckNamespacedPath<TEvent, Path extends string, What extends string> = Path extends `event.${infer Rest}` ? CheckEventPath<TEvent, Rest> : CheckMetaPath<Path> extends false ? WebhookKeyError<`${What} paths start with event., header. or webhook.: ${Path}`> : CheckMetaPath<Path>;
+type CheckMatchPath<TEvent, Path extends string> = CheckNamespacedPath<TEvent, Path, "match">;
+type CheckKeyPathSingle<TEvent, Path extends string> = CheckNamespacedPath<TEvent, Path, "key">;
+/**
+ * A webhook waiter's `match`: each key a path (`event.*` reads the event, `header.*` a header and
+ * `webhook.*` the endpoint), each value the scalar it must equal. A bad path turns that key's value
+ * type into an error naming it.
+ */
+export type ValidatedWebhookMatch<TEvent, M> = {
+    [K in keyof M]: K extends string ? CheckMatchPath<TEvent, K> extends true ? M[K] : CheckMatchPath<TEvent, K> : never;
+};
 declare const dEvt: unique symbol;
 export interface ChatEvent<TType extends string, TEvent> {
     id: string;
     type: TType;
     key: string;
+    /** The endpoint this event subscribes to (`webhooks.endpoint.define` id). */
+    endpointId: string;
     source: string;
-    verifierArtifact: WebhookVerifierArtifact;
-    secretProvisioning?: WebhookSecretProvisioning;
     filter?: string;
     readonly [dEvt]?: TEvent;
 }
@@ -35,7 +49,15 @@ export type ChatEventAction<W> = W extends ChatEvent<infer TType, infer TEvent>
     event: TEvent;
     source: string;
     headers: Record<string, string>;
+    /** The delivery's id (`whd_...`), as in the dashboard and the deliveries API. A replay gets a new one. */
     deliveryId: string;
+    /**
+     * The provider's id for the delivery (e.g. Stripe's `evt_...`), the same across replays.
+     * Absent on an action delivered by an older server.
+     */
+    externalDeliveryId?: string;
+    /** The endpoint the delivery arrived on. */
+    endpoint?: WebhookEndpointContext;
 } : never;
 export type ChatEventActions<TW extends readonly AnyChatEvent[]> = ChatEventAction<TW[number]>;
 export {};

package/dist/esm/v3/types/webhooks.d.ts

@@ -16,6 +16,33 @@ export type WebhookSource<TEvent = unknown> = {
     [__webhookEvent]?: TEvent;
 };
 export type AnyWebhookSource = WebhookSource<any>;
+declare const __endpointEvent: unique symbol;
+/**
+ * A declared webhook endpoint (`webhooks.endpoint.define`): one provider URL that subscribers
+ * (`webhook()`, `chat.event`, channel connectors) and waiters attach to. The event type comes from
+ * the endpoint's source.
+ */
+export type WebhookEndpoint<TEvent = unknown> = {
+    /** The declared endpoint id. */
+    id: string;
+    /** The source's provider tag, e.g. "stripe". */
+    source: string;
+    /** phantom, type-level only; never present at runtime */
+    [__endpointEvent]?: TEvent;
+};
+export type AnyWebhookEndpoint = WebhookEndpoint<any>;
+/** What a webhook waiter resumes its run with. */
+export type WebhookWaiterOutput<TEvent = unknown> = {
+    /** The verified event body. */
+    event: TEvent;
+    /** The inbound headers, curated as for `webhook()` (credentials dropped). */
+    headers: Record<string, string>;
+    /** The delivery's id (`whd_...`). */
+    deliveryId: string;
+    /** The endpoint the delivery arrived on. */
+    endpoint: WebhookEndpointContext;
+};
+export type InferWebhookEndpointEvent<E> = E extends WebhookEndpoint<infer TEvent> ? TEvent : unknown;
 export type InferWebhookEvent<S> = S extends WebhookSource<infer TEvent> ? TEvent : unknown;
 /**
  * The endpoint a delivery arrived on. `id` is the endpoint instance (`wh_...`); `declaredId` is the

package/dist/esm/v3/webhooks/index.d.ts

@@ -1229,7 +1229,7 @@ export declare const webhookProviderConfigs: {
         };
     };
     shopify: {
-        secretProvisioning: "integrator";
+        secretProvisioning: "provider";
         config: () => {
             scheme: "hmac";
             algorithm: "sha1" | "sha256";
@@ -1294,8 +1294,8 @@ export declare const webhookProviderConfigs: {
 };
 export type WebhookProviderId = keyof typeof webhookProviderConfigs;
 /**
- * Setup instructions for an AI agent, per preset. SDK producers attach these as the source's
- * `setupPrompt`; the platform wraps them with the endpoint URL, subscribers and secret steps.
+ * Setup instructions for an AI agent, per preset or provider. SDK producers attach these as the
+ * source's `setupPrompt`; the platform wraps them with the endpoint URL, subscribers and secret steps.
  */
-export declare const webhookSetupPrompts: Partial<Record<WebhookPresetId, string>>;
+export declare const webhookSetupPrompts: Partial<Record<WebhookPresetId | WebhookProviderId, string>>;
 export * from "../schemas/webhookConfig.js";

package/dist/esm/v3/webhooks/index.js

@@ -136,6 +136,8 @@ function hmacVerifierConfig(opts) {
     }
     if (opts.idempotencyField)
         config.idempotencyField = opts.idempotencyField;
+    if (opts.formPayload)
+        config.formPayload = opts.formPayload;
     return config;
 }
 /**
@@ -154,6 +156,8 @@ export const webhookProviderConfigs = {
             signingTemplate: "v0:{timestamp}:{body}",
             timestamp: { from: "header", name: "x-slack-request-timestamp" },
             toleranceSeconds: 300,
+            idempotencyField: { from: "body", name: "event_id" },
+            formPayload: { field: "payload" },
         }),
     },
     zoom: {
@@ -199,6 +203,7 @@ export const webhookProviderConfigs = {
             header: "linear-signature",
             timestamp: { from: "body", path: "webhookTimestamp", unit: "milliseconds" },
             toleranceSeconds: 60,
+            idempotencyField: { from: "header", name: "linear-delivery" },
         }),
     },
     notion: {
@@ -268,10 +273,11 @@ export const webhookProviderConfigs = {
             field: "d",
             signingTemplate: "{body}{timestamp}",
             timestamp: { from: "signatureField", field: "v", unit: "milliseconds" },
+            toleranceSeconds: 300,
         }),
     },
     shopify: {
-        secretProvisioning: "integrator",
+        secretProvisioning: "provider",
         config: () => hmacVerifierConfig({ header: "x-shopify-hmac-sha256", encoding: "base64" }),
     },
 };
@@ -280,8 +286,8 @@ const svixFamilySetupPrompt = [
     "Add the webhook URL as an endpoint in the provider's webhook settings or through its API, subscribe it to the event types the subscribers' filters need, then read the endpoint's signing secret and store it on Trigger.dev.",
 ].join("\n");
 /**
- * Setup instructions for an AI agent, per preset. SDK producers attach these as the source's
- * `setupPrompt`; the platform wraps them with the endpoint URL, subscribers and secret steps.
+ * Setup instructions for an AI agent, per preset or provider. SDK producers attach these as the
+ * source's `setupPrompt`; the platform wraps them with the endpoint URL, subscribers and secret steps.
  */
 export const webhookSetupPrompts = {
     stripe: [
@@ -302,6 +308,19 @@ export const webhookSetupPrompts = {
     ].join("\n"),
     svix: svixFamilySetupPrompt,
     "standard-webhooks": svixFamilySetupPrompt,
+    discord: [
+        "These settings are in the Discord Developer Portal (https://discord.com/developers/applications); tell the user each step.",
+        "1. Open the application, then its Webhooks page. Set the Endpoint URL to the webhook URL, turn Events on and select the event types the subscribers need. Discord sends a PING that the endpoint answers once it is deployed.",
+        "2. The public key is on the application's General Information page, under Public Key.",
+    ].join("\n"),
+    shopify: [
+        "Shopify signs webhooks with the app's client secret, or for webhooks created in the store admin, with the key shown on that page.",
+        "For an app, add a subscription to shopify.app.toml and run `shopify app deploy`:",
+        '  [[webhooks.subscriptions]]\n  topics = ["orders/create"]\n  uri = "<webhook URL>"',
+        "or create it with the Admin API's webhookSubscriptionCreate mutation. The client secret is in the app's settings in the Shopify Dev Dashboard.",
+        "For a store without an app, add the webhook under Settings > Notifications > Webhooks in the store admin; the signing key is shown on that page.",
+        "Choose topics from the subscribers' filters, which compare `header.x-shopify-topic`, and use the JSON format.",
+    ].join("\n"),
 };
 export * from "../schemas/webhookConfig.js";
 //# sourceMappingURL=index.js.map