@automate.ax/api-contract 0.57.3 → 0.57.4

package/dist/index.d.ts

@@ -1129,6 +1129,33 @@ export declare const contract: {
                 streamName: import("zod").ZodString;
                 streamNames: import("zod").ZodArray<import("zod").ZodString>;
                 ttl: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber]>>;
+            }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+                actionDependencyIds: import("zod").ZodArray<import("zod").ZodString>;
+                eventDependencyIds: import("zod").ZodArray<import("zod").ZodString>;
+                scopePath: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodNumber>>;
+                signalDependencyIds: import("zod").ZodArray<import("zod").ZodString>;
+                slot: import("zod").ZodNumber;
+                key: import("zod").ZodOptional<import("zod").ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
+                maxBurstDuration: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber]>>;
+                minGap: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber]>>;
+                minQuietPeriod: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber]>>;
+                outcomeSeq: import("zod").ZodNumber;
+                policy: import("zod").ZodLiteral<"funnel">;
+                primaryPosition: import("zod").ZodEnum<{
+                    first: "first";
+                    last: "last";
+                }>;
+                selection: import("zod").ZodEnum<{
+                    first: "first";
+                    last: "last";
+                    all: "all";
+                }>;
+                triggerAt: import("zod").ZodEnum<{
+                    start: "start";
+                    end: "end";
+                    both: "both";
+                }>;
+                ttl: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber]>>;
             }, import("zod/v4/core").$strip>, import("zod").ZodUnion<readonly [import("zod").ZodObject<{
                 actionDependencyIds: import("zod").ZodArray<import("zod").ZodString>;
                 eventDependencyIds: import("zod").ZodArray<import("zod").ZodString>;
@@ -1169,22 +1196,7 @@ export declare const contract: {
                 scopeOrigins: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
                 selectedIndex: import("zod").ZodNumber;
                 status: import("zod").ZodLiteral<"succeeded">;
-            }, import("zod/v4/core").$strip>]>, import("zod").ZodObject<{
-                actionDependencyIds: import("zod").ZodArray<import("zod").ZodString>;
-                eventDependencyIds: import("zod").ZodArray<import("zod").ZodString>;
-                scopePath: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodNumber>>;
-                signalDependencyIds: import("zod").ZodArray<import("zod").ZodString>;
-                slot: import("zod").ZodNumber;
-                duration: import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber]>;
-                key: import("zod").ZodOptional<import("zod").ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
-                outcomeSeq: import("zod").ZodNumber;
-                policy: import("zod").ZodLiteral<"window">;
-                primaryPosition: import("zod").ZodEnum<{
-                    first: "first";
-                    last: "last";
-                }>;
-                ttl: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber]>>;
-            }, import("zod/v4/core").$strip>]>>>;
+            }, import("zod/v4/core").$strip>]>]>>>;
             settled: import("zod").ZodDefault<import("zod").ZodBoolean>;
             signalInvocations: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodUnion<readonly [import("zod").ZodObject<{
                 actionDependencyIds: import("zod").ZodArray<import("zod").ZodString>;

package/dist/runtime.d.ts

@@ -261,6 +261,33 @@ export declare const runtimeContract: {
             streamName: z.ZodString;
             streamNames: z.ZodArray<z.ZodString>;
             ttl: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        }, z.core.$strip>, z.ZodObject<{
+            actionDependencyIds: z.ZodArray<z.ZodString>;
+            eventDependencyIds: z.ZodArray<z.ZodString>;
+            scopePath: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+            signalDependencyIds: z.ZodArray<z.ZodString>;
+            slot: z.ZodNumber;
+            key: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
+            maxBurstDuration: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            minGap: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            minQuietPeriod: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            outcomeSeq: z.ZodNumber;
+            policy: z.ZodLiteral<"funnel">;
+            primaryPosition: z.ZodEnum<{
+                first: "first";
+                last: "last";
+            }>;
+            selection: z.ZodEnum<{
+                first: "first";
+                last: "last";
+                all: "all";
+            }>;
+            triggerAt: z.ZodEnum<{
+                start: "start";
+                end: "end";
+                both: "both";
+            }>;
+            ttl: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
         }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
             actionDependencyIds: z.ZodArray<z.ZodString>;
             eventDependencyIds: z.ZodArray<z.ZodString>;
@@ -301,22 +328,7 @@ export declare const runtimeContract: {
             scopeOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
             selectedIndex: z.ZodNumber;
             status: z.ZodLiteral<"succeeded">;
-        }, z.core.$strip>]>, z.ZodObject<{
-            actionDependencyIds: z.ZodArray<z.ZodString>;
-            eventDependencyIds: z.ZodArray<z.ZodString>;
-            scopePath: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
-            signalDependencyIds: z.ZodArray<z.ZodString>;
-            slot: z.ZodNumber;
-            duration: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
-            key: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
-            outcomeSeq: z.ZodNumber;
-            policy: z.ZodLiteral<"window">;
-            primaryPosition: z.ZodEnum<{
-                first: "first";
-                last: "last";
-            }>;
-            ttl: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-        }, z.core.$strip>]>>>;
+        }, z.core.$strip>]>]>>>;
         settled: z.ZodDefault<z.ZodBoolean>;
         signalInvocations: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             actionDependencyIds: z.ZodArray<z.ZodString>;

package/dist/runtime.js

@@ -120,6 +120,10 @@ const SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA = z.object({
     slot: z.number().int().nonnegative(),
 });
 const COORDINATION_PRIMARY_POSITION_SCHEMA = z.enum(["first", "last"]);
+const COORDINATION_DURATION_SCHEMA = z.union([
+    z.string().min(1),
+    z.number().nonnegative(),
+]);
 const CORRELATION_STREAM_NAMES_SCHEMA = z
     .string()
     .min(1)
@@ -162,13 +166,42 @@ const COLLECTION_OFFER_SCHEMA = SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA.extend({
     primaryPosition: COORDINATION_PRIMARY_POSITION_SCHEMA,
     ttl: z.union([z.string().min(1), z.number().nonnegative()]).optional(),
 });
-const WINDOW_OFFER_SCHEMA = SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA.extend({
-    duration: z.union([z.string().min(1), z.number().nonnegative()]),
+const FUNNEL_OFFER_SCHEMA = SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA.extend({
     key: encodableSchema,
+    maxBurstDuration: COORDINATION_DURATION_SCHEMA.optional(),
+    minGap: COORDINATION_DURATION_SCHEMA.optional(),
+    minQuietPeriod: COORDINATION_DURATION_SCHEMA.optional(),
     outcomeSeq: OUTCOME_SEQUENCE_SCHEMA,
-    policy: z.literal("window"),
+    policy: z.literal("funnel"),
     primaryPosition: COORDINATION_PRIMARY_POSITION_SCHEMA,
-    ttl: z.union([z.string().min(1), z.number().nonnegative()]).optional(),
+    selection: z.enum(["all", "first", "last"]),
+    triggerAt: z.enum(["start", "end", "both"]),
+    ttl: COORDINATION_DURATION_SCHEMA.optional(),
+}).superRefine((offer, context) => {
+    if (offer.triggerAt === "end" &&
+        offer.minGap !== undefined &&
+        offer.minQuietPeriod === undefined &&
+        offer.maxBurstDuration === undefined) {
+        context.addIssue({
+            code: "custom",
+            message: "A trailing funnel with minGap also requires minQuietPeriod or maxBurstDuration.",
+            path: ["minGap"],
+        });
+    }
+    if (offer.selection !== "all" && offer.selection !== offer.primaryPosition) {
+        context.addIssue({
+            code: "custom",
+            message: "A selecting funnel must continue from its selected occurrence.",
+            path: ["primaryPosition"],
+        });
+    }
+    if (offer.triggerAt === "start" && offer.selection !== "first") {
+        context.addIssue({
+            code: "custom",
+            message: "A start-only funnel can only select its first occurrence.",
+            path: ["selection"],
+        });
+    }
 });
 const RACE_OFFER_BASE_SCHEMA = SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA.extend({
     inputOrigins: z.string().array().array().min(1),
@@ -480,8 +513,8 @@ export const runtimeContract = {
             .union([
             COLLECTION_OFFER_SCHEMA,
             CORRELATION_OFFER_SCHEMA,
+            FUNNEL_OFFER_SCHEMA,
             RACE_OFFER_SCHEMA,
-            WINDOW_OFFER_SCHEMA,
         ])
             .array()
             .default([]),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/api-contract",
-  "version": "0.57.3",
+  "version": "0.57.4",
   "description": "Public oRPC contract for the Automate.ax API.",
   "license": "MIT",
   "repository": {
@@ -28,7 +28,7 @@
   },
   "dependencies": {
     "@ai-sdk/gateway": "^4.0.46",
-    "@automate.ax/codec": "0.57.3",
+    "@automate.ax/codec": "0.57.4",
     "@orpc/contract": "1.15.0",
     "zod": "^4.3.6"
   },

package/src/runtime.ts

@@ -137,6 +137,10 @@ const SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA = z.object({
 })
 
 const COORDINATION_PRIMARY_POSITION_SCHEMA = z.enum(["first", "last"])
+const COORDINATION_DURATION_SCHEMA = z.union([
+  z.string().min(1),
+  z.number().nonnegative(),
+])
 const CORRELATION_STREAM_NAMES_SCHEMA = z
   .string()
   .min(1)
@@ -184,13 +188,45 @@ const COLLECTION_OFFER_SCHEMA = SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA.extend({
   ttl: z.union([z.string().min(1), z.number().nonnegative()]).optional(),
 })
 
-const WINDOW_OFFER_SCHEMA = SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA.extend({
-  duration: z.union([z.string().min(1), z.number().nonnegative()]),
+const FUNNEL_OFFER_SCHEMA = SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA.extend({
   key: encodableSchema,
+  maxBurstDuration: COORDINATION_DURATION_SCHEMA.optional(),
+  minGap: COORDINATION_DURATION_SCHEMA.optional(),
+  minQuietPeriod: COORDINATION_DURATION_SCHEMA.optional(),
   outcomeSeq: OUTCOME_SEQUENCE_SCHEMA,
-  policy: z.literal("window"),
+  policy: z.literal("funnel"),
   primaryPosition: COORDINATION_PRIMARY_POSITION_SCHEMA,
-  ttl: z.union([z.string().min(1), z.number().nonnegative()]).optional(),
+  selection: z.enum(["all", "first", "last"]),
+  triggerAt: z.enum(["start", "end", "both"]),
+  ttl: COORDINATION_DURATION_SCHEMA.optional(),
+}).superRefine((offer, context) => {
+  if (
+    offer.triggerAt === "end" &&
+    offer.minGap !== undefined &&
+    offer.minQuietPeriod === undefined &&
+    offer.maxBurstDuration === undefined
+  ) {
+    context.addIssue({
+      code: "custom",
+      message:
+        "A trailing funnel with minGap also requires minQuietPeriod or maxBurstDuration.",
+      path: ["minGap"],
+    })
+  }
+  if (offer.selection !== "all" && offer.selection !== offer.primaryPosition) {
+    context.addIssue({
+      code: "custom",
+      message: "A selecting funnel must continue from its selected occurrence.",
+      path: ["primaryPosition"],
+    })
+  }
+  if (offer.triggerAt === "start" && offer.selection !== "first") {
+    context.addIssue({
+      code: "custom",
+      message: "A start-only funnel can only select its first occurrence.",
+      path: ["selection"],
+    })
+  }
 })
 
 const RACE_OFFER_BASE_SCHEMA = SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA.extend({
@@ -552,8 +588,8 @@ export const runtimeContract = {
           .union([
             COLLECTION_OFFER_SCHEMA,
             CORRELATION_OFFER_SCHEMA,
+            FUNNEL_OFFER_SCHEMA,
             RACE_OFFER_SCHEMA,
-            WINDOW_OFFER_SCHEMA,
           ])
           .array()
           .default([]),