@automate.ax/api-contract 0.82.0 → 0.83.1

package/dist/deployment.d.ts

@@ -84,6 +84,7 @@ export declare const deploymentContract: {
         }>;
         projectId: z.ZodString;
         rebindAccounts: z.ZodDefault<z.ZodBoolean>;
+        runtimeProtocolVersion: z.ZodOptional<z.ZodNumber>;
         git: z.ZodOptional<z.ZodObject<{
             commitSha: z.ZodString;
             dirty: z.ZodBoolean;
@@ -109,6 +110,14 @@ export declare const deploymentContract: {
             readonly message: "A deployment is already in progress.";
             readonly status: 409;
         };
+        UNSUPPORTED_RUNTIME_PROTOCOL: {
+            readonly data: z.ZodObject<{
+                receivedVersion: z.ZodNullable<z.ZodNumber>;
+                supportedVersion: z.ZodLiteral<1>;
+            }, z.core.$strip>;
+            readonly message: "The automation bundle uses an unsupported runtime protocol.";
+            readonly status: 400;
+        };
     }>, Record<never, never>>;
     get: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
         deploymentId: z.ZodString;
@@ -277,5 +286,13 @@ export declare const deploymentContract: {
             readonly message: "A deployment is already in progress.";
             readonly status: 409;
         };
+        UNSUPPORTED_RUNTIME_PROTOCOL: {
+            readonly data: z.ZodObject<{
+                receivedVersion: z.ZodNullable<z.ZodNumber>;
+                supportedVersion: z.ZodLiteral<1>;
+            }, z.core.$strip>;
+            readonly message: "The automation bundle uses an unsupported runtime protocol.";
+            readonly status: 400;
+        };
     }>, Record<never, never>>;
 };

package/dist/deployment.js

@@ -1,5 +1,6 @@
 import { oc } from "@orpc/contract";
 import * as z from "zod";
+import { AUTOMATION_RUNTIME_PROTOCOL_VERSION } from "./runtime-protocol.js";
 import { cursorPageOutputSchema, cursorPaginationInputSchema } from "./schemas.js";
 /** SDK compatibility version used to select the immutable runtime image. */
 export const AUTOMATION_SDK_VERSION = "2";
@@ -20,6 +21,14 @@ const DEPLOYMENT_IN_PROGRESS_ERROR = {
     message: "A deployment is already in progress.",
     status: 409,
 };
+const UNSUPPORTED_RUNTIME_PROTOCOL_ERROR = {
+    data: z.object({
+        receivedVersion: z.number().int().positive().nullable(),
+        supportedVersion: z.literal(AUTOMATION_RUNTIME_PROTOCOL_VERSION),
+    }),
+    message: "The automation bundle uses an unsupported runtime protocol.",
+    status: 400,
+};
 const GIT_SOURCE_SCHEMA = z.object({
     commitSha: z.string().regex(/^[0-9a-f]{40}(?:[0-9a-f]{24})?$/),
     dirty: z.boolean(),
@@ -88,7 +97,10 @@ export const deploymentContract = {
         .input(z.object({ deploymentId: z.string() }))
         .output(z.void()),
     create: oc
-        .errors({ DEPLOYMENT_IN_PROGRESS: DEPLOYMENT_IN_PROGRESS_ERROR })
+        .errors({
+        DEPLOYMENT_IN_PROGRESS: DEPLOYMENT_IN_PROGRESS_ERROR,
+        UNSUPPORTED_RUNTIME_PROTOCOL: UNSUPPORTED_RUNTIME_PROTOCOL_ERROR,
+    })
         .input(z.object({
         artifact: z.instanceof(Blob),
         cancelExisting: z.boolean().default(false),
@@ -113,6 +125,7 @@ export const deploymentContract = {
         mode: z.enum(["reconcile", "upsert"]),
         projectId: z.string(),
         rebindAccounts: z.boolean().default(false),
+        runtimeProtocolVersion: z.number().int().positive().optional(),
         git: GIT_SOURCE_SCHEMA.optional(),
     }))
         .output(z.object({ id: z.string() })),
@@ -156,7 +169,10 @@ export const deploymentContract = {
         .prefault({}))
         .output(cursorPageOutputSchema(deploymentOutputSchema)),
     redeploy: oc
-        .errors({ DEPLOYMENT_IN_PROGRESS: DEPLOYMENT_IN_PROGRESS_ERROR })
+        .errors({
+        DEPLOYMENT_IN_PROGRESS: DEPLOYMENT_IN_PROGRESS_ERROR,
+        UNSUPPORTED_RUNTIME_PROTOCOL: UNSUPPORTED_RUNTIME_PROTOCOL_ERROR,
+    })
         .route({
         method: "POST",
         path: "/projects/{projectId}/deployments/redeploy",

package/dist/events/convex.d.ts

@@ -0,0 +1,10 @@
+import * as z from "zod";
+export declare const convexEventsContract: {
+    convexEvent: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        emittedAt: z.ZodISODateTime;
+        endpointKey: z.ZodString;
+        id: z.ZodString;
+        name: z.ZodString;
+        payload: z.ZodJSONSchema;
+    }, z.core.$strip>, z.ZodVoid, Record<never, never>, Record<never, never>>;
+};

package/dist/events/convex.js

@@ -0,0 +1,22 @@
+import { oc } from "@orpc/contract";
+import * as z from "zod";
+export const convexEventsContract = {
+    convexEvent: oc
+        .route({
+        description: "Authenticates and ingests a semantic event emitted by a Convex action.",
+        method: "POST",
+        operationId: "receiveConvexEvent",
+        path: "/events/convex/{endpointKey}",
+        successStatus: 204,
+        summary: "Receive a signed Convex event",
+        tags: ["Events"],
+    })
+        .input(z.object({
+        emittedAt: z.iso.datetime({ offset: true }),
+        endpointKey: z.string(),
+        id: z.string(),
+        name: z.string(),
+        payload: z.json(),
+    }))
+        .output(z.void()),
+};

package/dist/events/index.d.ts

@@ -97,6 +97,13 @@ export declare const eventsContract: {
         subscription: import("zod").ZodLiteral<"projects/opkitty/subscriptions/automate-ax-google-forms-push">;
     }, import("zod/v4/core").$strip>, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
     googleCalendarPush: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodVoid, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
+    convexEvent: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+        emittedAt: import("zod").ZodISODateTime;
+        endpointKey: import("zod").ZodString;
+        id: import("zod").ZodString;
+        name: import("zod").ZodString;
+        payload: import("zod").ZodJSONSchema;
+    }, import("zod/v4/core").$strip>, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
     brevoEvent: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
         event: import("zod").ZodString;
         id: import("zod").ZodNumber;

package/dist/events/index.js

@@ -1,6 +1,7 @@
 import { airtableEventsContract } from "./airtable.js";
 import { asanaEventsContract } from "./asana.js";
 import { brevoEventsContract } from "./brevo.js";
+import { convexEventsContract } from "./convex.js";
 import { googleCalendarEventsContract } from "./google-calendar.js";
 import { googleFormsEventsContract } from "./google-forms.js";
 import { googleMeetEventsContract } from "./google-meet.js";
@@ -18,6 +19,7 @@ export const eventsContract = {
     ...airtableEventsContract,
     ...asanaEventsContract,
     ...brevoEventsContract,
+    ...convexEventsContract,
     ...googleCalendarEventsContract,
     ...googleFormsEventsContract,
     ...googleMeetEventsContract,

package/dist/execution-data.d.ts

@@ -1,11 +1,12 @@
 import { z } from "zod";
-export declare const EXECUTION_DATASET_VERSION = 5;
+export declare const EXECUTION_DATASET_VERSION = 6;
 export declare const executionDatasetResourceSchema: z.ZodEnum<{
     automations: "automations";
     projects: "projects";
     actions: "actions";
     events: "events";
     outputs: "outputs";
+    "automation-invocations": "automation-invocations";
     contexts: "contexts";
     "context-parents": "context-parents";
     "event-links": "event-links";
@@ -31,6 +32,7 @@ export declare const executionDatasetManifestSchema: z.ZodObject<{
             actions: "actions";
             events: "events";
             outputs: "outputs";
+            "automation-invocations": "automation-invocations";
             contexts: "contexts";
             "context-parents": "context-parents";
             "event-links": "event-links";
@@ -43,7 +45,7 @@ export declare const executionDatasetManifestSchema: z.ZodObject<{
         }>;
         url: z.ZodURL;
     }, z.core.$strip>>;
-    schemaVersion: z.ZodLiteral<5>;
+    schemaVersion: z.ZodLiteral<6>;
     scope: z.ZodObject<{
         organizationId: z.ZodNullable<z.ZodString>;
         projectId: z.ZodNullable<z.ZodString>;
@@ -68,6 +70,7 @@ export declare const executionDataContract: {
                 actions: "actions";
                 events: "events";
                 outputs: "outputs";
+                "automation-invocations": "automation-invocations";
                 contexts: "contexts";
                 "context-parents": "context-parents";
                 "event-links": "event-links";
@@ -80,7 +83,7 @@ export declare const executionDataContract: {
             }>;
             url: z.ZodURL;
         }, z.core.$strip>>;
-        schemaVersion: z.ZodLiteral<5>;
+        schemaVersion: z.ZodLiteral<6>;
         scope: z.ZodObject<{
             organizationId: z.ZodNullable<z.ZodString>;
             projectId: z.ZodNullable<z.ZodString>;

package/dist/execution-data.js

@@ -1,9 +1,10 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
-export const EXECUTION_DATASET_VERSION = 5;
+export const EXECUTION_DATASET_VERSION = 6;
 export const executionDatasetResourceSchema = z.enum([
     "projects",
     "automations",
+    "automation-invocations",
     "contexts",
     "context-parents",
     "event-links",

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { automationExecutionStatusSchema, automationOutputSchema, } from "./automation.js";
 export { EXECUTION_DATASET_VERSION, executionDatasetManifestSchema, executionDatasetResourceSchema, executionDatasetScopeSchema, type ExecutionDatasetManifest, type ExecutionDatasetResource, type ExecutionDatasetScope, executionDataContract, } from "./execution-data.js";
 export { AUTOMATION_SDK_VERSION, deploymentOutputSchema, deploymentStatusSchema, } from "./deployment.js";
+export { AUTOMATION_RUNTIME_PROTOCOL_VERSION } from "./runtime-protocol.js";
 export { AUTOMATION_ERROR_CAUSE_DEPTH, automationErrorSchema, type AutomationErrorValue, } from "./errors.js";
 export { integrationAccountOutputSchema, integrationAccountRevocationImpactOutputSchema, integrationAccountRevocationOutputSchema, integrationServiceOutputSchema, } from "./account.js";
 export { AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT, AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX, AUTOMATION_LOG_MAX_ENTRIES, AUTOMATION_LOG_MAX_MESSAGE_LENGTH, AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES, AUTOMATION_OBSERVABILITY_MAX_FIELDS, AUTOMATION_TRACE_MAX_NAME_LENGTH, AUTOMATION_TRACE_MAX_SPANS, DEFAULT_GATEWAY_MODEL_ID, automationInvocationInputSchema, automationInvocationOutputSchema, automationInvocationScheduleSchema, generationInputSchema, generationResultSchema, hashSignalCoordinatorConfiguration, runtimeContract, type GenerationInput, type GenerationResult, type RuntimeGenerationInput, type RuntimeCoordinationOffer, } from "./runtime.js";
@@ -650,6 +651,14 @@ export declare const publicContract: {
                 readonly message: "A deployment is already in progress.";
                 readonly status: 409;
             };
+            UNSUPPORTED_RUNTIME_PROTOCOL: {
+                readonly data: import("zod").ZodObject<{
+                    receivedVersion: import("zod").ZodNullable<import("zod").ZodNumber>;
+                    supportedVersion: import("zod").ZodLiteral<1>;
+                }, import("zod/v4/core").$strip>;
+                readonly message: "The automation bundle uses an unsupported runtime protocol.";
+                readonly status: 400;
+            };
         }>, Record<never, never>>;
     };
     executionData: {
@@ -667,6 +676,7 @@ export declare const publicContract: {
                     actions: "actions";
                     events: "events";
                     outputs: "outputs";
+                    "automation-invocations": "automation-invocations";
                     contexts: "contexts";
                     "context-parents": "context-parents";
                     "event-links": "event-links";
@@ -679,7 +689,7 @@ export declare const publicContract: {
                 }>;
                 url: import("zod").ZodURL;
             }, import("zod/v4/core").$strip>>;
-            schemaVersion: import("zod").ZodLiteral<5>;
+            schemaVersion: import("zod").ZodLiteral<6>;
             scope: import("zod").ZodObject<{
                 organizationId: import("zod").ZodNullable<import("zod").ZodString>;
                 projectId: import("zod").ZodNullable<import("zod").ZodString>;
@@ -1211,6 +1221,7 @@ export declare const firstPartyContract: {
             }>;
             projectId: import("zod").ZodString;
             rebindAccounts: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            runtimeProtocolVersion: import("zod").ZodOptional<import("zod").ZodNumber>;
             git: import("zod").ZodOptional<import("zod").ZodObject<{
                 commitSha: import("zod").ZodString;
                 dirty: import("zod").ZodBoolean;
@@ -1236,6 +1247,14 @@ export declare const firstPartyContract: {
                 readonly message: "A deployment is already in progress.";
                 readonly status: 409;
             };
+            UNSUPPORTED_RUNTIME_PROTOCOL: {
+                readonly data: import("zod").ZodObject<{
+                    receivedVersion: import("zod").ZodNullable<import("zod").ZodNumber>;
+                    supportedVersion: import("zod").ZodLiteral<1>;
+                }, import("zod/v4/core").$strip>;
+                readonly message: "The automation bundle uses an unsupported runtime protocol.";
+                readonly status: 400;
+            };
         }>, Record<never, never>>;
         get: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
             deploymentId: import("zod").ZodString;
@@ -1404,6 +1423,14 @@ export declare const firstPartyContract: {
                 readonly message: "A deployment is already in progress.";
                 readonly status: 409;
             };
+            UNSUPPORTED_RUNTIME_PROTOCOL: {
+                readonly data: import("zod").ZodObject<{
+                    receivedVersion: import("zod").ZodNullable<import("zod").ZodNumber>;
+                    supportedVersion: import("zod").ZodLiteral<1>;
+                }, import("zod/v4/core").$strip>;
+                readonly message: "The automation bundle uses an unsupported runtime protocol.";
+                readonly status: 400;
+            };
         }>, Record<never, never>>;
     };
     org: {
@@ -2002,6 +2029,7 @@ export declare const firstPartyContract: {
                     actions: "actions";
                     events: "events";
                     outputs: "outputs";
+                    "automation-invocations": "automation-invocations";
                     contexts: "contexts";
                     "context-parents": "context-parents";
                     "event-links": "event-links";
@@ -2014,7 +2042,7 @@ export declare const firstPartyContract: {
                 }>;
                 url: import("zod").ZodURL;
             }, import("zod/v4/core").$strip>>;
-            schemaVersion: import("zod").ZodLiteral<5>;
+            schemaVersion: import("zod").ZodLiteral<6>;
             scope: import("zod").ZodObject<{
                 organizationId: import("zod").ZodNullable<import("zod").ZodString>;
                 projectId: import("zod").ZodNullable<import("zod").ZodString>;
@@ -2195,6 +2223,13 @@ export declare const contract: {
             subscription: import("zod").ZodLiteral<"projects/opkitty/subscriptions/automate-ax-google-forms-push">;
         }, import("zod/v4/core").$strip>, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
         googleCalendarPush: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodVoid, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
+        convexEvent: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+            emittedAt: import("zod").ZodISODateTime;
+            endpointKey: import("zod").ZodString;
+            id: import("zod").ZodString;
+            name: import("zod").ZodString;
+            payload: import("zod").ZodJSONSchema;
+        }, import("zod/v4/core").$strip>, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
         brevoEvent: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
             event: import("zod").ZodString;
             id: import("zod").ZodNumber;
@@ -3639,6 +3674,7 @@ export declare const contract: {
             }>;
             projectId: import("zod").ZodString;
             rebindAccounts: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            runtimeProtocolVersion: import("zod").ZodOptional<import("zod").ZodNumber>;
             git: import("zod").ZodOptional<import("zod").ZodObject<{
                 commitSha: import("zod").ZodString;
                 dirty: import("zod").ZodBoolean;
@@ -3664,6 +3700,14 @@ export declare const contract: {
                 readonly message: "A deployment is already in progress.";
                 readonly status: 409;
             };
+            UNSUPPORTED_RUNTIME_PROTOCOL: {
+                readonly data: import("zod").ZodObject<{
+                    receivedVersion: import("zod").ZodNullable<import("zod").ZodNumber>;
+                    supportedVersion: import("zod").ZodLiteral<1>;
+                }, import("zod/v4/core").$strip>;
+                readonly message: "The automation bundle uses an unsupported runtime protocol.";
+                readonly status: 400;
+            };
         }>, Record<never, never>>;
         get: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
             deploymentId: import("zod").ZodString;
@@ -3832,6 +3876,14 @@ export declare const contract: {
                 readonly message: "A deployment is already in progress.";
                 readonly status: 409;
             };
+            UNSUPPORTED_RUNTIME_PROTOCOL: {
+                readonly data: import("zod").ZodObject<{
+                    receivedVersion: import("zod").ZodNullable<import("zod").ZodNumber>;
+                    supportedVersion: import("zod").ZodLiteral<1>;
+                }, import("zod/v4/core").$strip>;
+                readonly message: "The automation bundle uses an unsupported runtime protocol.";
+                readonly status: 400;
+            };
         }>, Record<never, never>>;
     };
     org: {
@@ -4430,6 +4482,7 @@ export declare const contract: {
                     actions: "actions";
                     events: "events";
                     outputs: "outputs";
+                    "automation-invocations": "automation-invocations";
                     contexts: "contexts";
                     "context-parents": "context-parents";
                     "event-links": "event-links";
@@ -4442,7 +4495,7 @@ export declare const contract: {
                 }>;
                 url: import("zod").ZodURL;
             }, import("zod/v4/core").$strip>>;
-            schemaVersion: import("zod").ZodLiteral<5>;
+            schemaVersion: import("zod").ZodLiteral<6>;
             scope: import("zod").ZodObject<{
                 organizationId: import("zod").ZodNullable<import("zod").ZodString>;
                 projectId: import("zod").ZodNullable<import("zod").ZodString>;

package/dist/index.js

@@ -12,6 +12,7 @@ import { runtimeContract } from "./runtime.js";
 export { automationExecutionStatusSchema, automationOutputSchema, } from "./automation.js";
 export { EXECUTION_DATASET_VERSION, executionDatasetManifestSchema, executionDatasetResourceSchema, executionDatasetScopeSchema, executionDataContract, } from "./execution-data.js";
 export { AUTOMATION_SDK_VERSION, deploymentOutputSchema, deploymentStatusSchema, } from "./deployment.js";
+export { AUTOMATION_RUNTIME_PROTOCOL_VERSION } from "./runtime-protocol.js";
 export { AUTOMATION_ERROR_CAUSE_DEPTH, automationErrorSchema, } from "./errors.js";
 export { integrationAccountOutputSchema, integrationAccountRevocationImpactOutputSchema, integrationAccountRevocationOutputSchema, integrationServiceOutputSchema, } from "./account.js";
 export { AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT, AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX, AUTOMATION_LOG_MAX_ENTRIES, AUTOMATION_LOG_MAX_MESSAGE_LENGTH, AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES, AUTOMATION_OBSERVABILITY_MAX_FIELDS, AUTOMATION_TRACE_MAX_NAME_LENGTH, AUTOMATION_TRACE_MAX_SPANS, DEFAULT_GATEWAY_MODEL_ID, automationInvocationInputSchema, automationInvocationOutputSchema, automationInvocationScheduleSchema, generationInputSchema, generationResultSchema, hashSignalCoordinatorConfiguration, runtimeContract, } from "./runtime.js";

package/dist/runtime-protocol.d.ts

@@ -0,0 +1,2 @@
+/** Runtime protocol required by newly built automation bundles. */
+export declare const AUTOMATION_RUNTIME_PROTOCOL_VERSION = 1;

package/dist/runtime-protocol.js

@@ -0,0 +1,2 @@
+/** Runtime protocol required by newly built automation bundles. */
+export const AUTOMATION_RUNTIME_PROTOCOL_VERSION = 1;

package/dist/runtime.d.ts

@@ -5,6 +5,7 @@ export type { GatewayModelId } from "@ai-sdk/gateway";
 export declare const DEFAULT_GATEWAY_MODEL_ID = "openai/gpt-4.1-nano";
 export declare const AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT = "default";
 export declare const AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX = "__$";
+export declare const AUTOMATION_DELAY_ENTRYPOINT_PREFIX: "__$delay:";
 export declare const CALLBACK_PROTECTION_QUERY_PARAMETER = "_axCallback";
 export declare const AUTOMATION_LOG_MAX_ENTRIES = 1000;
 export declare const AUTOMATION_TRACE_MAX_SPANS = 250;

package/dist/runtime.js

@@ -7,6 +7,7 @@ import { automationErrorSchema } from "./errors.js";
 export const DEFAULT_GATEWAY_MODEL_ID = "openai/gpt-4.1-nano";
 export const AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT = "default";
 export const AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX = "__$";
+export const AUTOMATION_DELAY_ENTRYPOINT_PREFIX = `${AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX}delay:`;
 export const CALLBACK_PROTECTION_QUERY_PARAMETER = "_axCallback";
 export const AUTOMATION_LOG_MAX_ENTRIES = 1_000;
 export const AUTOMATION_TRACE_MAX_SPANS = 250;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/api-contract",
-  "version": "0.82.0",
+  "version": "0.83.1",
   "description": "Public oRPC contract for the Automate.ax API.",
   "license": "MIT",
   "repository": {
@@ -21,6 +21,7 @@
       ".": "./src/index.ts",
       "./errors": "./src/errors.ts",
       "./permissions": "./src/permissions.ts",
+      "./runtime-protocol": "./src/runtime-protocol.ts",
       "./runtime": "./src/runtime.ts"
     },
     "cjs": false,
@@ -30,13 +31,14 @@
   },
   "dependencies": {
     "@ai-sdk/gateway": "^4.0.46",
-    "@automate.ax/codec": "0.82.0",
+    "@automate.ax/codec": "0.83.1",
+    "@automate.ax/integration-contracts": "0.83.1",
     "@orpc/contract": "1.15.0",
     "fast-json-stable-stringify": "^2.1.0",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@internal/config": "0.0.0",
+    "@internal/config": "0.1.0",
     "@types/bun": "latest",
     "@typescript/native": "npm:typescript@^7.0.2",
     "@zachsents/oxlint-config": "^0.4.1",
@@ -81,6 +83,11 @@
       "types": "./dist/permissions.d.ts",
       "default": "./dist/permissions.js"
     },
+    "./runtime-protocol": {
+      "bun": "./src/runtime-protocol.ts",
+      "types": "./dist/runtime-protocol.d.ts",
+      "default": "./dist/runtime-protocol.js"
+    },
     "./runtime": {
       "bun": "./src/runtime.ts",
       "types": "./dist/runtime.d.ts",

package/src/deployment.ts

@@ -1,5 +1,6 @@
 import { oc } from "@orpc/contract"
 import * as z from "zod"
+import { AUTOMATION_RUNTIME_PROTOCOL_VERSION } from "./runtime-protocol"
 import { cursorPageOutputSchema, cursorPaginationInputSchema } from "./schemas"
 
 /** SDK compatibility version used to select the immutable runtime image. */
@@ -24,6 +25,15 @@ const DEPLOYMENT_IN_PROGRESS_ERROR = {
   status: 409,
 } as const
 
+const UNSUPPORTED_RUNTIME_PROTOCOL_ERROR = {
+  data: z.object({
+    receivedVersion: z.number().int().positive().nullable(),
+    supportedVersion: z.literal(AUTOMATION_RUNTIME_PROTOCOL_VERSION),
+  }),
+  message: "The automation bundle uses an unsupported runtime protocol.",
+  status: 400,
+} as const
+
 const GIT_SOURCE_SCHEMA = z.object({
   commitSha: z.string().regex(/^[0-9a-f]{40}(?:[0-9a-f]{24})?$/),
   dirty: z.boolean(),
@@ -96,7 +106,10 @@ export const deploymentContract = {
     .input(z.object({ deploymentId: z.string() }))
     .output(z.void()),
   create: oc
-    .errors({ DEPLOYMENT_IN_PROGRESS: DEPLOYMENT_IN_PROGRESS_ERROR })
+    .errors({
+      DEPLOYMENT_IN_PROGRESS: DEPLOYMENT_IN_PROGRESS_ERROR,
+      UNSUPPORTED_RUNTIME_PROTOCOL: UNSUPPORTED_RUNTIME_PROTOCOL_ERROR,
+    })
     .input(
       z.object({
         artifact: z.instanceof(Blob),
@@ -123,6 +136,7 @@ export const deploymentContract = {
         mode: z.enum(["reconcile", "upsert"]),
         projectId: z.string(),
         rebindAccounts: z.boolean().default(false),
+        runtimeProtocolVersion: z.number().int().positive().optional(),
         git: GIT_SOURCE_SCHEMA.optional(),
       }),
     )
@@ -171,7 +185,10 @@ export const deploymentContract = {
     )
     .output(cursorPageOutputSchema(deploymentOutputSchema)),
   redeploy: oc
-    .errors({ DEPLOYMENT_IN_PROGRESS: DEPLOYMENT_IN_PROGRESS_ERROR })
+    .errors({
+      DEPLOYMENT_IN_PROGRESS: DEPLOYMENT_IN_PROGRESS_ERROR,
+      UNSUPPORTED_RUNTIME_PROTOCOL: UNSUPPORTED_RUNTIME_PROTOCOL_ERROR,
+    })
     .route({
       method: "POST",
       path: "/projects/{projectId}/deployments/redeploy",

package/src/events/convex.ts

@@ -0,0 +1,26 @@
+import { oc } from "@orpc/contract"
+import * as z from "zod"
+
+export const convexEventsContract = {
+  convexEvent: oc
+    .route({
+      description:
+        "Authenticates and ingests a semantic event emitted by a Convex action.",
+      method: "POST",
+      operationId: "receiveConvexEvent",
+      path: "/events/convex/{endpointKey}",
+      successStatus: 204,
+      summary: "Receive a signed Convex event",
+      tags: ["Events"],
+    })
+    .input(
+      z.object({
+        emittedAt: z.iso.datetime({ offset: true }),
+        endpointKey: z.string(),
+        id: z.string(),
+        name: z.string(),
+        payload: z.json(),
+      }),
+    )
+    .output(z.void()),
+}

package/src/events/index.ts

@@ -1,6 +1,7 @@
 import { airtableEventsContract } from "./airtable"
 import { asanaEventsContract } from "./asana"
 import { brevoEventsContract } from "./brevo"
+import { convexEventsContract } from "./convex"
 import { googleCalendarEventsContract } from "./google-calendar"
 import { googleFormsEventsContract } from "./google-forms"
 import { googleMeetEventsContract } from "./google-meet"
@@ -19,6 +20,7 @@ export const eventsContract = {
   ...airtableEventsContract,
   ...asanaEventsContract,
   ...brevoEventsContract,
+  ...convexEventsContract,
   ...googleCalendarEventsContract,
   ...googleFormsEventsContract,
   ...googleMeetEventsContract,

package/src/execution-data.ts

@@ -1,11 +1,12 @@
 import { oc } from "@orpc/contract"
 import { z } from "zod"
 
-export const EXECUTION_DATASET_VERSION = 5
+export const EXECUTION_DATASET_VERSION = 6
 
 export const executionDatasetResourceSchema = z.enum([
   "projects",
   "automations",
+  "automation-invocations",
   "contexts",
   "context-parents",
   "event-links",

package/src/index.ts

@@ -29,6 +29,7 @@ export {
   deploymentOutputSchema,
   deploymentStatusSchema,
 } from "./deployment"
+export { AUTOMATION_RUNTIME_PROTOCOL_VERSION } from "./runtime-protocol"
 export {
   AUTOMATION_ERROR_CAUSE_DEPTH,
   automationErrorSchema,

package/src/runtime-protocol.ts

@@ -0,0 +1,2 @@
+/** Runtime protocol required by newly built automation bundles. */
+export const AUTOMATION_RUNTIME_PROTOCOL_VERSION = 1

package/src/runtime.ts

@@ -12,6 +12,8 @@ export const DEFAULT_GATEWAY_MODEL_ID =
   "openai/gpt-4.1-nano" satisfies GatewayModelId
 export const AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT = "default"
 export const AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX = "__$"
+export const AUTOMATION_DELAY_ENTRYPOINT_PREFIX =
+  `${AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX}delay:` as const
 export const CALLBACK_PROTECTION_QUERY_PARAMETER = "_axCallback"
 export const AUTOMATION_LOG_MAX_ENTRIES = 1_000
 export const AUTOMATION_TRACE_MAX_SPANS = 250