@automate.ax/api-contract 0.80.0 → 0.82.0

package/dist/runtime.js

@@ -15,12 +15,7 @@ export const AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES = 64 * 1_024;
 export const AUTOMATION_LOG_MAX_MESSAGE_LENGTH = 16_384;
 export const AUTOMATION_TRACE_MAX_NAME_LENGTH = 256;
 const OUTCOME_SEQUENCE_SCHEMA = z.number().int().positive();
-const HOOK_SCOPE_PATH_SCHEMA = z
-    .number()
-    .int()
-    .nonnegative()
-    .array()
-    .default([]);
+const HOOK_SCOPE_PATH_SCHEMA = z.number().int().nonnegative().array();
 const OBSERVABILITY_FIELDS_SCHEMA = z
     .record(z.string().min(1).max(128), encodableSchema)
     .refine((fields) => Object.keys(fields).length <= AUTOMATION_OBSERVABILITY_MAX_FIELDS, `Observability fields may contain at most ${AUTOMATION_OBSERVABILITY_MAX_FIELDS} entries.`);
@@ -98,8 +93,55 @@ export const automationInvocationInputSchema = z
     }),
 ]))
     .and(automationInvocationScheduleSchema);
+const SIGNAL_DERIVATION_NODE_SCHEMA = z.discriminatedUnion("type", [
+    z.object({
+        id: z.string().min(1),
+        source: z.enum(["action", "event", "signal"]),
+        type: z.literal("source"),
+    }),
+    z.object({
+        inputs: z.number().int().nonnegative().array().min(1),
+        property: z.string(),
+        type: z.literal("property"),
+    }),
+    z.object({
+        inputs: z.number().int().nonnegative().array().min(1),
+        type: z.literal("transform"),
+    }),
+]);
+/** Compact concrete derivation graph persisted for one durable consumer. */
+export const signalDerivationSchema = z
+    .object({
+    nodes: SIGNAL_DERIVATION_NODE_SCHEMA.array().min(1),
+    roots: z.number().int().nonnegative().array().min(1),
+})
+    .superRefine(({ nodes, roots }, context) => {
+    for (const [index, node] of nodes.entries()) {
+        if (node.type === "source")
+            continue;
+        for (const input of node.inputs) {
+            if (input >= index) {
+                context.addIssue({
+                    code: "custom",
+                    message: "Derivation inputs must reference preceding nodes.",
+                    path: ["nodes", index, "inputs"],
+                });
+            }
+        }
+    }
+    for (const [index, root] of roots.entries()) {
+        if (root >= nodes.length) {
+            context.addIssue({
+                code: "custom",
+                message: "Derivation roots must reference an existing node.",
+                path: ["roots", index],
+            });
+        }
+    }
+});
 const ACTION_INVOCATION_BASE_SCHEMA = z.object({
     actionDependencyIds: z.string().array(),
+    derivation: signalDerivationSchema.nullable(),
     description: z.string().nullable(),
     eventDependencyIds: z.string().array(),
     inputHash: z.string(),
@@ -147,13 +189,16 @@ const ACTION_RUN_INVOCATION_SCHEMA = z.union([
         status: z.literal("succeeded"),
     }),
 ]);
-const SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA = z.object({
+const SIGNAL_DEPENDENCIES_SCHEMA = z.object({
     actionDependencyIds: z.string().array(),
     eventDependencyIds: z.string().array(),
     scopePath: HOOK_SCOPE_PATH_SCHEMA,
     signalDependencyIds: z.string().array(),
     slot: z.number().int().nonnegative(),
 });
+const SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA = SIGNAL_DEPENDENCIES_SCHEMA.extend({
+    derivation: signalDerivationSchema.nullable(),
+});
 const COORDINATION_PRIMARY_POSITION_SCHEMA = z.enum(["first", "last"]);
 const COORDINATION_DURATION_SCHEMA = z.union([
     z.string().min(1),
@@ -253,14 +298,14 @@ const FUNNEL_OFFER_SCHEMA = SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA.extend({
     }
 });
 const RACE_OFFER_BASE_SCHEMA = SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA.extend({
-    cohortActionDependencyIds: z.string().array().default([]),
-    cohortEventDependencyIds: z.string().array().default([]),
-    cohortOrigins: z.string().array().default([]),
-    cohortSignalDependencyIds: z.string().array().default([]),
+    cohortActionDependencyIds: z.string().array(),
+    cohortEventDependencyIds: z.string().array(),
+    cohortOrigins: z.string().array(),
+    cohortSignalDependencyIds: z.string().array(),
     inputOrigins: z.string().array().array().min(2),
     outcomeSeq: OUTCOME_SEQUENCE_SCHEMA,
     policy: z.literal("race"),
-    scopeOrigins: z.string().array().default([]),
+    scopeOrigins: z.string().array(),
     selectedIndex: z.number().int().nonnegative(),
 });
 const RACE_OFFER_SCHEMA = z
@@ -554,25 +599,9 @@ const RUNTIME_GENERATION_INPUT_SCHEMA = z.union([
  * @param primaryPosition - Optional inherited-parent precedence.
  */
 export async function hashSignalCoordinatorConfiguration(definition, primaryPosition) {
-    const definitionEntries = typeof definition === "object" &&
-        definition !== null &&
-        !Array.isArray(definition)
-        ? Object.entries(definition)
-        : undefined;
-    const policy = definitionEntries?.find(([key]) => key === "policy")?.[1];
-    // Existing coordinators were hashed with `strategy` and implicit primary
-    // positions for race and fan-out. Preserve that identity while the runtime
-    // uses the clearer policy vocabulary and no longer overloads primary state.
-    const persistedDefinition = definitionEntries
-        ? Object.fromEntries(definitionEntries.map(([key, value]) => [
-            key === "policy" ? "strategy" : key,
-            value,
-        ]))
-        : definition;
     return await sha256Base64Url(stableStringify({
-        definitionHash: await sha256Base64Url(stableStringify(persistedDefinition)),
-        primaryPosition: primaryPosition ??
-            (policy === "fanout" || policy === "race" ? "first" : null),
+        definitionHash: await sha256Base64Url(stableStringify(definition)),
+        primaryPosition: primaryPosition ?? null,
     }));
 }
 /**
@@ -589,10 +618,10 @@ async function sha256Base64Url(value) {
 export const runtimeContract = {
     commit: oc
         .input(z.object({
-        actionInvocations: ACTION_INVOCATION_SCHEMA.array().default([]),
-        coordinationOffers: COORDINATION_OFFER_SCHEMA.array().default([]),
-        settled: z.boolean().default(true),
-        signalInvocations: SIGNAL_INVOCATION_SCHEMA.array().default([]),
+        actionInvocations: ACTION_INVOCATION_SCHEMA.array(),
+        coordinationOffers: COORDINATION_OFFER_SCHEMA.array(),
+        settled: z.boolean(),
+        signalInvocations: SIGNAL_INVOCATION_SCHEMA.array(),
     }))
         .output(z.void()),
     completeAction: oc
@@ -645,7 +674,7 @@ export const runtimeContract = {
         targetAction: TARGET_ACTION_SCHEMA.optional(),
     })),
     loadValues: oc
-        .input(SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA.omit({
+        .input(SIGNAL_DEPENDENCIES_SCHEMA.omit({
         scopePath: true,
         slot: true,
     }))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/api-contract",
-  "version": "0.80.0",
+  "version": "0.82.0",
   "description": "Public oRPC contract for the Automate.ax API.",
   "license": "MIT",
   "repository": {
@@ -30,7 +30,7 @@
   },
   "dependencies": {
     "@ai-sdk/gateway": "^4.0.46",
-    "@automate.ax/codec": "0.80.0",
+    "@automate.ax/codec": "0.82.0",
     "@orpc/contract": "1.15.0",
     "fast-json-stable-stringify": "^2.1.0",
     "zod": "^4.3.6"

package/src/execution-data.ts

@@ -1,7 +1,7 @@
 import { oc } from "@orpc/contract"
 import { z } from "zod"
 
-export const EXECUTION_DATASET_VERSION = 4
+export const EXECUTION_DATASET_VERSION = 5
 
 export const executionDatasetResourceSchema = z.enum([
   "projects",

package/src/org.ts

@@ -32,10 +32,12 @@ export const organizationSummaryOutputSchema = z.object({
   pendingInvitationCount: z.number(),
   projectCount: z.number(),
   activeSubscription: activeSubscriptionOutputSchema.nullable(),
+  executionRetentionDays: z.number().int().positive(),
   plan: z.enum(["free", "pro", "enterprise"]),
   limits: z.object({
     aiSpendUsd: z.number(),
     emailSends: z.number(),
+    executionRetentionDays: z.number().int().positive(),
     projects: z.number(),
     seats: z.number(),
   }),
@@ -225,10 +227,23 @@ export const orgContract = {
       tags: ["Organizations"],
     })
     .input(
-      z.object({
-        organizationId: z.string(),
-        name: reasonableNameSchema,
-      }),
+      z
+        .object({
+          executionRetentionDays: z
+            .number()
+            .int()
+            .positive()
+            .nullable()
+            .optional(),
+          organizationId: z.string(),
+          name: reasonableNameSchema.optional(),
+        })
+        .refine(
+          (input) =>
+            input.executionRetentionDays !== undefined ||
+            input.name !== undefined,
+          "Provide an organization setting to update.",
+        ),
     )
     .output(z.void()),
 }

package/src/runtime.ts

@@ -21,12 +21,7 @@ export const AUTOMATION_LOG_MAX_MESSAGE_LENGTH = 16_384
 export const AUTOMATION_TRACE_MAX_NAME_LENGTH = 256
 
 const OUTCOME_SEQUENCE_SCHEMA = z.number().int().positive()
-const HOOK_SCOPE_PATH_SCHEMA = z
-  .number()
-  .int()
-  .nonnegative()
-  .array()
-  .default([])
+const HOOK_SCOPE_PATH_SCHEMA = z.number().int().nonnegative().array()
 const OBSERVABILITY_FIELDS_SCHEMA = z
   .record(z.string().min(1).max(128), encodableSchema)
   .refine(
@@ -115,8 +110,59 @@ export const automationInvocationInputSchema = z
   )
   .and(automationInvocationScheduleSchema)
 
+const SIGNAL_DERIVATION_NODE_SCHEMA = z.discriminatedUnion("type", [
+  z.object({
+    id: z.string().min(1),
+    source: z.enum(["action", "event", "signal"]),
+    type: z.literal("source"),
+  }),
+  z.object({
+    inputs: z.number().int().nonnegative().array().min(1),
+    property: z.string(),
+    type: z.literal("property"),
+  }),
+  z.object({
+    inputs: z.number().int().nonnegative().array().min(1),
+    type: z.literal("transform"),
+  }),
+])
+
+/** Compact concrete derivation graph persisted for one durable consumer. */
+export const signalDerivationSchema = z
+  .object({
+    nodes: SIGNAL_DERIVATION_NODE_SCHEMA.array().min(1),
+    roots: z.number().int().nonnegative().array().min(1),
+  })
+  .superRefine(({ nodes, roots }, context) => {
+    for (const [index, node] of nodes.entries()) {
+      if (node.type === "source") continue
+      for (const input of node.inputs) {
+        if (input >= index) {
+          context.addIssue({
+            code: "custom",
+            message: "Derivation inputs must reference preceding nodes.",
+            path: ["nodes", index, "inputs"],
+          })
+        }
+      }
+    }
+    for (const [index, root] of roots.entries()) {
+      if (root >= nodes.length) {
+        context.addIssue({
+          code: "custom",
+          message: "Derivation roots must reference an existing node.",
+          path: ["roots", index],
+        })
+      }
+    }
+  })
+
+/** Persisted source, property, and opaque transform derivation graph. */
+export type SignalDerivation = z.infer<typeof signalDerivationSchema>
+
 const ACTION_INVOCATION_BASE_SCHEMA = z.object({
   actionDependencyIds: z.string().array(),
+  derivation: signalDerivationSchema.nullable(),
   description: z.string().nullable(),
   eventDependencyIds: z.string().array(),
   inputHash: z.string(),
@@ -168,7 +214,7 @@ const ACTION_RUN_INVOCATION_SCHEMA = z.union([
   }),
 ])
 
-const SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA = z.object({
+const SIGNAL_DEPENDENCIES_SCHEMA = z.object({
   actionDependencyIds: z.string().array(),
   eventDependencyIds: z.string().array(),
   scopePath: HOOK_SCOPE_PATH_SCHEMA,
@@ -176,6 +222,12 @@ const SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA = z.object({
   slot: z.number().int().nonnegative(),
 })
 
+const SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA = SIGNAL_DEPENDENCIES_SCHEMA.extend(
+  {
+    derivation: signalDerivationSchema.nullable(),
+  },
+)
+
 const COORDINATION_PRIMARY_POSITION_SCHEMA = z.enum(["first", "last"])
 const COORDINATION_DURATION_SCHEMA = z.union([
   z.string().min(1),
@@ -286,14 +338,14 @@ const FUNNEL_OFFER_SCHEMA = SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA.extend({
 })
 
 const RACE_OFFER_BASE_SCHEMA = SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA.extend({
-  cohortActionDependencyIds: z.string().array().default([]),
-  cohortEventDependencyIds: z.string().array().default([]),
-  cohortOrigins: z.string().array().default([]),
-  cohortSignalDependencyIds: z.string().array().default([]),
+  cohortActionDependencyIds: z.string().array(),
+  cohortEventDependencyIds: z.string().array(),
+  cohortOrigins: z.string().array(),
+  cohortSignalDependencyIds: z.string().array(),
   inputOrigins: z.string().array().array().min(2),
   outcomeSeq: OUTCOME_SEQUENCE_SCHEMA,
   policy: z.literal("race"),
-  scopeOrigins: z.string().array().default([]),
+  scopeOrigins: z.string().array(),
   selectedIndex: z.number().int().nonnegative(),
 })
 
@@ -631,32 +683,10 @@ export async function hashSignalCoordinatorConfiguration(
   definition: unknown,
   primaryPosition?: "first" | "last",
 ) {
-  const definitionEntries =
-    typeof definition === "object" &&
-    definition !== null &&
-    !Array.isArray(definition)
-      ? Object.entries(definition)
-      : undefined
-  const policy = definitionEntries?.find(([key]) => key === "policy")?.[1]
-  // Existing coordinators were hashed with `strategy` and implicit primary
-  // positions for race and fan-out. Preserve that identity while the runtime
-  // uses the clearer policy vocabulary and no longer overloads primary state.
-  const persistedDefinition = definitionEntries
-    ? Object.fromEntries(
-        definitionEntries.map(([key, value]) => [
-          key === "policy" ? "strategy" : key,
-          value,
-        ]),
-      )
-    : definition
   return await sha256Base64Url(
     stableStringify({
-      definitionHash: await sha256Base64Url(
-        stableStringify(persistedDefinition),
-      ),
-      primaryPosition:
-        primaryPosition ??
-        (policy === "fanout" || policy === "race" ? "first" : null),
+      definitionHash: await sha256Base64Url(stableStringify(definition)),
+      primaryPosition: primaryPosition ?? null,
     }),
   )
 }
@@ -683,10 +713,10 @@ export const runtimeContract = {
   commit: oc
     .input(
       z.object({
-        actionInvocations: ACTION_INVOCATION_SCHEMA.array().default([]),
-        coordinationOffers: COORDINATION_OFFER_SCHEMA.array().default([]),
-        settled: z.boolean().default(true),
-        signalInvocations: SIGNAL_INVOCATION_SCHEMA.array().default([]),
+        actionInvocations: ACTION_INVOCATION_SCHEMA.array(),
+        coordinationOffers: COORDINATION_OFFER_SCHEMA.array(),
+        settled: z.boolean(),
+        signalInvocations: SIGNAL_INVOCATION_SCHEMA.array(),
       }),
     )
     .output(z.void()),
@@ -749,7 +779,7 @@ export const runtimeContract = {
   ),
   loadValues: oc
     .input(
-      SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA.omit({
+      SIGNAL_DEPENDENCIES_SCHEMA.omit({
         scopePath: true,
         slot: true,
       }),