@automate.ax/api-contract 0.5.1 → 0.7.0

package/dist/deployment.d.ts

@@ -1,13 +1,31 @@
 import { z } from "zod";
 /** SDK compatibility version used to select the immutable runtime image. */
 export declare const AUTOMATION_SDK_VERSION = "1";
+export declare const deploymentTriggerInfoSchema: z.ZodObject<{
+    details: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>>;
+    name: z.ZodString;
+    type: z.ZodString;
+}, z.core.$strip>;
+export type DeploymentTriggerInfo = z.infer<typeof deploymentTriggerInfoSchema>;
 export declare const deploymentContract: {
-    create: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+    cancel: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        deploymentId: z.ZodString;
         projectId: z.ZodString;
-        automations: z.ZodArray<z.ZodObject<{
-            body: z.ZodCustom<Blob, Blob>;
+    }, z.core.$strip>, z.ZodVoid, Record<never, never>, Record<never, never>>;
+    create: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        artifact: z.ZodCustom<Blob, Blob>;
+        manifest: z.ZodArray<z.ZodObject<{
+            entrypoint: z.ZodString;
             identityKey: z.ZodString;
         }, z.core.$strip>>;
+        mode: z.ZodEnum<{
+            reconcile: "reconcile";
+            upsert: "upsert";
+        }>;
+        projectId: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
     }, z.core.$strip>, Record<never, never>, Record<never, never>>;
@@ -18,6 +36,14 @@ export declare const deploymentContract: {
         automations: z.ZodArray<z.ZodObject<{
             description: z.ZodString;
             identityKey: z.ZodString;
+            triggers: z.ZodArray<z.ZodObject<{
+                details: z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    value: z.ZodString;
+                }, z.core.$strip>>;
+                name: z.ZodString;
+                type: z.ZodString;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
         id: z.ZodString;
         job: z.ZodNullable<z.ZodObject<{
@@ -34,10 +60,10 @@ export declare const deploymentContract: {
             planning: "planning";
             awaiting_authorization: "awaiting_authorization";
             configuring: "configuring";
-            active: "active";
-            inactive: "inactive";
-            superseded: "superseded";
+            publishing: "publishing";
+            succeeded: "succeeded";
             failed: "failed";
+            cancelled: "cancelled";
         }>;
     }, z.core.$strip>, Record<never, never>, Record<never, never>>;
 };

package/dist/deployment.js

@@ -2,17 +2,59 @@ import { oc } from "@orpc/contract";
 import { z } from "zod";
 /** SDK compatibility version used to select the immutable runtime image. */
 export const AUTOMATION_SDK_VERSION = "1";
+export const deploymentTriggerInfoSchema = z.object({
+    details: z
+        .object({
+        label: z.string(),
+        value: z.string(),
+    })
+        .array(),
+    name: z.string(),
+    type: z.string(),
+});
 export const deploymentContract = {
-    create: oc
+    cancel: oc
         .input(z.object({
+        deploymentId: z.string(),
         projectId: z.string(),
-        automations: z
+    }))
+        .output(z.void()),
+    create: oc
+        .input(z.object({
+        artifact: z.instanceof(Blob),
+        manifest: z
             .object({
-            body: z.instanceof(Blob),
+            entrypoint: z.string().min(1),
             identityKey: z.string().min(1),
         })
             .array()
-            .min(1, "Deployment must include at least one automation."),
+            .min(1, "Deployment must include at least one automation.")
+            .superRefine((manifest, context) => {
+            const identityKeys = new Set();
+            for (const [index, entry] of manifest.entries()) {
+                if (identityKeys.has(entry.identityKey)) {
+                    context.addIssue({
+                        code: "custom",
+                        message: "Automation identity keys must be unique.",
+                        path: [index, "identityKey"],
+                    });
+                }
+                identityKeys.add(entry.identityKey);
+                if (entry.entrypoint.includes("\\") ||
+                    entry.entrypoint.startsWith("/") ||
+                    entry.entrypoint
+                        .split("/")
+                        .some((segment) => segment === "" || segment === "." || segment === "..")) {
+                    context.addIssue({
+                        code: "custom",
+                        message: "Entrypoint must be a safe relative POSIX path.",
+                        path: [index, "entrypoint"],
+                    });
+                }
+            }
+        }),
+        mode: z.enum(["reconcile", "upsert"]),
+        projectId: z.string(),
     }))
         .output(z.object({ id: z.string() })),
     get: oc
@@ -25,6 +67,7 @@ export const deploymentContract = {
             .object({
             description: z.string(),
             identityKey: z.string(),
+            triggers: deploymentTriggerInfoSchema.array(),
         })
             .array(),
         id: z.string(),
@@ -44,10 +87,10 @@ export const deploymentContract = {
             "planning",
             "awaiting_authorization",
             "configuring",
-            "active",
-            "inactive",
-            "superseded",
+            "publishing",
+            "succeeded",
             "failed",
+            "cancelled",
         ]),
     })),
 };

package/dist/events/google-calendar.d.ts

@@ -0,0 +1,4 @@
+import { z } from "zod";
+export declare const googleCalendarEventsContract: {
+    googleCalendarPush: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodVoid, z.ZodVoid, Record<never, never>, Record<never, never>>;
+};

package/dist/events/google-calendar.js

@@ -0,0 +1,16 @@
+import { oc } from "@orpc/contract";
+import { z } from "zod";
+export const googleCalendarEventsContract = {
+    googleCalendarPush: oc
+        .route({
+        method: "POST",
+        path: "/events/google-calendar",
+        operationId: "receiveGoogleCalendarPush",
+        summary: "Receive a Google Calendar push notification",
+        description: "Receives header-only Google Calendar resource-change notifications.",
+        tags: ["Events"],
+        successStatus: 204,
+    })
+        .input(z.void())
+        .output(z.void()),
+};

package/dist/events/google-forms.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+export declare const googleFormsEventsContract: {
+    googleFormsPush: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        message: z.ZodObject<{
+            attributes: z.ZodObject<{
+                eventType: z.ZodEnum<{
+                    SCHEMA: "SCHEMA";
+                    RESPONSES: "RESPONSES";
+                }>;
+                formId: z.ZodString;
+                watchId: z.ZodString;
+            }, z.core.$strip>;
+            messageId: z.ZodString;
+            publishTime: z.ZodISODateTime;
+        }, z.core.$strip>;
+        subscription: z.ZodLiteral<"projects/opkitty/subscriptions/automate-ax-google-forms-push">;
+    }, z.core.$strip>, z.ZodVoid, Record<never, never>, Record<never, never>>;
+};

package/dist/events/google-forms.js

@@ -0,0 +1,32 @@
+import { oc } from "@orpc/contract";
+import { z } from "zod";
+export const googleFormsEventsContract = {
+    googleFormsPush: oc
+        .route({
+        method: "POST",
+        path: "/events/google-forms",
+        operationId: "receiveGoogleFormsPush",
+        summary: "Receive a Google Forms push notification",
+        description: "Receives and authenticates Google Forms notifications delivered by Google Cloud Pub/Sub.",
+        tags: ["Events"],
+        successStatus: 204,
+    })
+        .input(z.object({
+        /** Pub/Sub message containing Google Forms notification attributes. */
+        message: z.object({
+            /** Provider routing fields for the watched form. */
+            attributes: z.object({
+                eventType: z.enum(["SCHEMA", "RESPONSES"]),
+                formId: z.string().min(1),
+                watchId: z.string().min(1),
+            }),
+            /** Provider-assigned identifier used to deduplicate delivery. */
+            messageId: z.string().min(1),
+            /** RFC 3339 time at which Pub/Sub published the notification. */
+            publishTime: z.iso.datetime({ offset: true }),
+        }),
+        /** Pub/Sub subscription that delivered the message. */
+        subscription: z.literal("projects/opkitty/subscriptions/automate-ax-google-forms-push"),
+    }))
+        .output(z.void()),
+};

package/dist/events/index.d.ts

@@ -6,4 +6,20 @@ export declare const eventsContract: {
         }, import("zod/v4/core").$strip>;
         subscription: import("zod").ZodLiteral<"projects/opkitty/subscriptions/automate-ax-gmail-push">;
     }, import("zod/v4/core").$strip>, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
+    googleFormsPush: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+        message: import("zod").ZodObject<{
+            attributes: import("zod").ZodObject<{
+                eventType: import("zod").ZodEnum<{
+                    SCHEMA: "SCHEMA";
+                    RESPONSES: "RESPONSES";
+                }>;
+                formId: import("zod").ZodString;
+                watchId: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>;
+            messageId: import("zod").ZodString;
+            publishTime: import("zod").ZodISODateTime;
+        }, import("zod/v4/core").$strip>;
+        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>>;
 };

package/dist/events/index.js

@@ -1,4 +1,8 @@
+import { googleCalendarEventsContract } from "./google-calendar.js";
+import { googleFormsEventsContract } from "./google-forms.js";
 import { gmailEventsContract } from "./gmail.js";
 export const eventsContract = {
+    ...googleCalendarEventsContract,
+    ...googleFormsEventsContract,
     ...gmailEventsContract,
 };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { AUTOMATION_SDK_VERSION } from "./deployment.js";
+export { AUTOMATION_SDK_VERSION, deploymentTriggerInfoSchema, type DeploymentTriggerInfo, } from "./deployment.js";
 export { createdOrganizationApiKeyOutputSchema, organizationApiKeyOutputSchema, } from "./api-key.js";
 export { integrationServiceManifestSchema, type IntegrationServiceManifest, } from "./authorization.js";
 export { activeSubscriptionOutputSchema, createdInvitationOutputSchema, organizationDetailsOutputSchema, organizationInvitationOutputSchema, organizationMemberOutputSchema, organizationProjectOutputSchema, organizationRoleSchema, organizationSummaryOutputSchema, publicOrganizationOutputSchema, } from "./org.js";
@@ -146,12 +146,21 @@ export declare const contract: {
         }, import("zod/v4/core").$strip>, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
     };
     deployment: {
-        create: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+        cancel: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+            deploymentId: import("zod").ZodString;
             projectId: import("zod").ZodString;
-            automations: import("zod").ZodArray<import("zod").ZodObject<{
-                body: import("zod").ZodCustom<Blob, Blob>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
+        create: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+            artifact: import("zod").ZodCustom<Blob, Blob>;
+            manifest: import("zod").ZodArray<import("zod").ZodObject<{
+                entrypoint: import("zod").ZodString;
                 identityKey: import("zod").ZodString;
             }, import("zod/v4/core").$strip>>;
+            mode: import("zod").ZodEnum<{
+                reconcile: "reconcile";
+                upsert: "upsert";
+            }>;
+            projectId: import("zod").ZodString;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
             id: import("zod").ZodString;
         }, import("zod/v4/core").$strip>, Record<never, never>, Record<never, never>>;
@@ -162,6 +171,14 @@ export declare const contract: {
             automations: import("zod").ZodArray<import("zod").ZodObject<{
                 description: import("zod").ZodString;
                 identityKey: import("zod").ZodString;
+                triggers: import("zod").ZodArray<import("zod").ZodObject<{
+                    details: import("zod").ZodArray<import("zod").ZodObject<{
+                        label: import("zod").ZodString;
+                        value: import("zod").ZodString;
+                    }, import("zod/v4/core").$strip>>;
+                    name: import("zod").ZodString;
+                    type: import("zod").ZodString;
+                }, import("zod/v4/core").$strip>>;
             }, import("zod/v4/core").$strip>>;
             id: import("zod").ZodString;
             job: import("zod").ZodNullable<import("zod").ZodObject<{
@@ -178,10 +195,10 @@ export declare const contract: {
                 planning: "planning";
                 awaiting_authorization: "awaiting_authorization";
                 configuring: "configuring";
-                active: "active";
-                inactive: "inactive";
-                superseded: "superseded";
+                publishing: "publishing";
+                succeeded: "succeeded";
                 failed: "failed";
+                cancelled: "cancelled";
             }>;
         }, import("zod/v4/core").$strip>, Record<never, never>, Record<never, never>>;
     };
@@ -193,6 +210,22 @@ export declare const contract: {
             }, import("zod/v4/core").$strip>;
             subscription: import("zod").ZodLiteral<"projects/opkitty/subscriptions/automate-ax-gmail-push">;
         }, import("zod/v4/core").$strip>, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
+        googleFormsPush: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+            message: import("zod").ZodObject<{
+                attributes: import("zod").ZodObject<{
+                    eventType: import("zod").ZodEnum<{
+                        SCHEMA: "SCHEMA";
+                        RESPONSES: "RESPONSES";
+                    }>;
+                    formId: import("zod").ZodString;
+                    watchId: import("zod").ZodString;
+                }, import("zod/v4/core").$strip>;
+                messageId: import("zod").ZodString;
+                publishTime: import("zod").ZodISODateTime;
+            }, import("zod/v4/core").$strip>;
+            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>>;
     };
     org: {
         canInvite: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
@@ -388,6 +421,7 @@ export declare const contract: {
                 actionDependencyIds: import("zod").ZodArray<import("zod").ZodString>;
                 description: import("zod").ZodNullable<import("zod").ZodString>;
                 eventDependencyIds: import("zod").ZodArray<import("zod").ZodString>;
+                inputHash: import("zod").ZodString;
                 name: import("zod").ZodString;
                 slot: import("zod").ZodNumber;
             }, import("zod/v4/core").$strip>>>;
@@ -415,7 +449,11 @@ export declare const contract: {
         nextBatch: import("@orpc/contract").ContractProcedureBuilderWithOutput<import("@orpc/contract").Schema<unknown, unknown>, import("zod").ZodObject<{
             context: import("zod").ZodObject<{
                 actionOutputs: import("zod").ZodArray<import("zod").ZodObject<{
+                    actionDependencyIds: import("zod").ZodArray<import("zod").ZodString>;
                     actionInvocationId: import("zod").ZodString;
+                    eventDependencyIds: import("zod").ZodArray<import("zod").ZodString>;
+                    inputHash: import("zod").ZodString;
+                    name: import("zod").ZodString;
                     slot: import("zod").ZodNumber;
                 }, import("zod/v4/core").$strip>>;
                 contextId: import("zod").ZodString;

package/dist/index.js

@@ -6,7 +6,7 @@ import { eventsContract } from "./events/index.js";
 import { orgContract } from "./org.js";
 import { projectContract } from "./project.js";
 import { runtimeContract } from "./runtime.js";
-export { AUTOMATION_SDK_VERSION } from "./deployment.js";
+export { AUTOMATION_SDK_VERSION, deploymentTriggerInfoSchema, } from "./deployment.js";
 export { createdOrganizationApiKeyOutputSchema, organizationApiKeyOutputSchema, } from "./api-key.js";
 export { integrationServiceManifestSchema, } from "./authorization.js";
 export { activeSubscriptionOutputSchema, createdInvitationOutputSchema, organizationDetailsOutputSchema, organizationInvitationOutputSchema, organizationMemberOutputSchema, organizationProjectOutputSchema, organizationRoleSchema, organizationSummaryOutputSchema, publicOrganizationOutputSchema, } from "./org.js";

package/dist/runtime.d.ts

@@ -5,6 +5,7 @@ export declare const runtimeContract: {
             actionDependencyIds: z.ZodArray<z.ZodString>;
             description: z.ZodNullable<z.ZodString>;
             eventDependencyIds: z.ZodArray<z.ZodString>;
+            inputHash: z.ZodString;
             name: z.ZodString;
             slot: z.ZodNumber;
         }, z.core.$strip>>>;
@@ -32,7 +33,11 @@ export declare const runtimeContract: {
     nextBatch: import("@orpc/contract").ContractProcedureBuilderWithOutput<import("@orpc/contract").Schema<unknown, unknown>, z.ZodObject<{
         context: z.ZodObject<{
             actionOutputs: z.ZodArray<z.ZodObject<{
+                actionDependencyIds: z.ZodArray<z.ZodString>;
                 actionInvocationId: z.ZodString;
+                eventDependencyIds: z.ZodArray<z.ZodString>;
+                inputHash: z.ZodString;
+                name: z.ZodString;
                 slot: z.ZodNumber;
             }, z.core.$strip>>;
             contextId: z.ZodString;

package/dist/runtime.js

@@ -9,6 +9,7 @@ export const runtimeContract = {
             actionDependencyIds: z.string().array(),
             description: z.string().nullable(),
             eventDependencyIds: z.string().array(),
+            inputHash: z.string(),
             name: z.string(),
             slot: z.number().int().nonnegative(),
         })
@@ -46,7 +47,11 @@ export const runtimeContract = {
         context: z.object({
             actionOutputs: z
                 .object({
+                actionDependencyIds: z.string().array(),
                 actionInvocationId: z.string(),
+                eventDependencyIds: z.string().array(),
+                inputHash: z.string(),
+                name: z.string(),
                 slot: z.number().int(),
             })
                 .array(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/api-contract",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "description": "Public oRPC contract for the Automate.ax API.",
   "license": "MIT",
   "repository": {
@@ -23,7 +23,7 @@
     "cjs": false
   },
   "dependencies": {
-    "@automate.ax/codec": "0.5.1",
+    "@automate.ax/codec": "0.7.0",
     "@orpc/contract": "1.13.14",
     "zod": "^4.3.6"
   },