@automate.ax/api-contract 0.50.0 → 0.50.2

package/dist/deployment.d.ts

@@ -1,6 +1,26 @@
 import { z } from "zod";
 /** SDK compatibility version used to select the immutable runtime image. */
-export declare const AUTOMATION_SDK_VERSION = "1";
+export declare const AUTOMATION_SDK_VERSION = "2";
+export type HttpTriggerScope = "trigger" | "automation" | "project";
+export interface HttpTriggerEndpointOptions {
+    appOrigin: string;
+    automationId: string;
+    hookSlot: number;
+    projectId: string;
+    scope: HttpTriggerScope;
+}
+/**
+ * Returns the public URL for one deployed HTTP trigger.
+ *
+ * @param options - Public origin and trigger identity.
+ */
+export declare function getHttpTriggerEndpoint(options: HttpTriggerEndpointOptions): string;
+/**
+ * Returns the durable endpoint identity for one configured HTTP scope.
+ *
+ * @param options - Trigger and owning resource identity.
+ */
+export declare function getHttpTriggerEndpointKey(options: Omit<HttpTriggerEndpointOptions, "appOrigin">): string;
 export declare const deploymentTriggerInfoSchema: z.ZodObject<{
     details: z.ZodArray<z.ZodObject<{
         label: z.ZodString;

package/dist/deployment.js

@@ -1,7 +1,27 @@
 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 AUTOMATION_SDK_VERSION = "2";
+/**
+ * Returns the public URL for one deployed HTTP trigger.
+ *
+ * @param options - Public origin and trigger identity.
+ */
+export function getHttpTriggerEndpoint(options) {
+    return new URL(`/x/${getHttpTriggerEndpointKey(options)}/`, options.appOrigin).toString();
+}
+/**
+ * Returns the durable endpoint identity for one configured HTTP scope.
+ *
+ * @param options - Trigger and owning resource identity.
+ */
+export function getHttpTriggerEndpointKey(options) {
+    if (options.scope === "project")
+        return options.projectId;
+    if (options.scope === "automation")
+        return options.automationId;
+    return `${options.automationId}:${options.hookSlot}`;
+}
 export const deploymentTriggerInfoSchema = z.object({
     details: z
         .object({

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { automationExecutionStatusSchema } from "./automation.js";
-export { AUTOMATION_SDK_VERSION, deploymentTriggerInfoSchema, type DeploymentTriggerInfo, } from "./deployment.js";
+export { AUTOMATION_SDK_VERSION, deploymentTriggerInfoSchema, getHttpTriggerEndpoint, getHttpTriggerEndpointKey, type DeploymentTriggerInfo, type HttpTriggerEndpointOptions, type HttpTriggerScope, } from "./deployment.js";
 export { integrationAccountOutputSchema } from "./account.js";
 export { AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT, AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX, DEFAULT_GATEWAY_MODEL_ID, automationInvocationInputSchema, automationInvocationOutputSchema, automationInvocationScheduleSchema, generationInputSchema, generationResultSchema, runtimeContract, type GenerationInput, type GenerationResult, type RuntimeGenerationInput, } from "./runtime.js";
 export type { GatewayModelId } from "@ai-sdk/gateway";
@@ -1420,6 +1420,7 @@ export declare const contract: {
                 eventDependencyIds: import("zod").ZodArray<import("zod").ZodString>;
                 signalDependencyIds: import("zod").ZodArray<import("zod").ZodString>;
                 slot: import("zod").ZodNumber;
+                continueFrom: import("zod").ZodOptional<import("zod").ZodString>;
                 key: import("zod").ZodOptional<import("zod").ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
                 outcomeSeq: import("zod").ZodNumber;
                 streamName: import("zod").ZodString;
@@ -1576,11 +1577,16 @@ export declare const contract: {
                 type: import("zod").ZodLiteral<"other">;
             }, import("zod/v4/core").$strip>], "type">>>;
         }, import("zod/v4/core").$strip>, Record<never, never>, Record<never, never>>;
-        invokeAutomation: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodIntersection<import("zod").ZodObject<{
-            automationName: import("zod").ZodString;
+        invokeAutomation: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodIntersection<import("zod").ZodIntersection<import("zod").ZodObject<{
             entrypoint: import("zod").ZodDefault<import("zod").ZodString>;
             payload: import("zod").ZodOptional<import("zod").ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
         }, import("zod/v4/core").$strip>, import("zod").ZodUnion<readonly [import("zod").ZodObject<{
+            automationId: import("zod").ZodString;
+            automationName: import("zod").ZodOptional<import("zod").ZodNever>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            automationId: import("zod").ZodOptional<import("zod").ZodNever>;
+            automationName: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>]>>, import("zod").ZodUnion<readonly [import("zod").ZodObject<{
             runAt: import("zod").ZodUnion<readonly [import("zod").ZodDate, import("zod").ZodString, import("zod").ZodNumber]>;
             runIn: import("zod").ZodOptional<import("zod").ZodNever>;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{

package/dist/index.js

@@ -9,7 +9,7 @@ import { orgContract } from "./org.js";
 import { projectContract } from "./project.js";
 import { runtimeContract } from "./runtime.js";
 export { automationExecutionStatusSchema } from "./automation.js";
-export { AUTOMATION_SDK_VERSION, deploymentTriggerInfoSchema, } from "./deployment.js";
+export { AUTOMATION_SDK_VERSION, deploymentTriggerInfoSchema, getHttpTriggerEndpoint, getHttpTriggerEndpointKey, } from "./deployment.js";
 export { integrationAccountOutputSchema } from "./account.js";
 export { AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT, AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX, DEFAULT_GATEWAY_MODEL_ID, automationInvocationInputSchema, automationInvocationOutputSchema, automationInvocationScheduleSchema, generationInputSchema, generationResultSchema, runtimeContract, } from "./runtime.js";
 export { createdOrganizationApiKeyOutputSchema, organizationApiKeyOutputSchema, } from "./api-key.js";

package/dist/runtime.d.ts

@@ -19,11 +19,16 @@ export declare const automationInvocationOutputSchema: z.ZodObject<{
     id: z.ZodString;
     runAt: z.ZodDate;
 }, z.core.$strip>;
-export declare const automationInvocationInputSchema: z.ZodIntersection<z.ZodObject<{
-    automationName: z.ZodString;
+export declare const automationInvocationInputSchema: z.ZodIntersection<z.ZodIntersection<z.ZodObject<{
     entrypoint: z.ZodDefault<z.ZodString>;
     payload: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
 }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
+    automationId: z.ZodString;
+    automationName: z.ZodOptional<z.ZodNever>;
+}, z.core.$strip>, z.ZodObject<{
+    automationId: z.ZodOptional<z.ZodNever>;
+    automationName: z.ZodString;
+}, z.core.$strip>]>>, z.ZodUnion<readonly [z.ZodObject<{
     runAt: z.ZodUnion<readonly [z.ZodDate, z.ZodString, z.ZodNumber]>;
     runIn: z.ZodOptional<z.ZodNever>;
 }, z.core.$strip>, z.ZodObject<{
@@ -223,6 +228,7 @@ export declare const runtimeContract: {
             eventDependencyIds: z.ZodArray<z.ZodString>;
             signalDependencyIds: z.ZodArray<z.ZodString>;
             slot: z.ZodNumber;
+            continueFrom: z.ZodOptional<z.ZodString>;
             key: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
             outcomeSeq: z.ZodNumber;
             streamName: z.ZodString;
@@ -379,11 +385,16 @@ export declare const runtimeContract: {
             type: z.ZodLiteral<"other">;
         }, z.core.$strip>], "type">>>;
     }, z.core.$strip>, Record<never, never>, Record<never, never>>;
-    invokeAutomation: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodIntersection<z.ZodObject<{
-        automationName: z.ZodString;
+    invokeAutomation: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodIntersection<z.ZodIntersection<z.ZodObject<{
         entrypoint: z.ZodDefault<z.ZodString>;
         payload: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
     }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
+        automationId: z.ZodString;
+        automationName: z.ZodOptional<z.ZodNever>;
+    }, z.core.$strip>, z.ZodObject<{
+        automationId: z.ZodOptional<z.ZodNever>;
+        automationName: z.ZodString;
+    }, z.core.$strip>]>>, z.ZodUnion<readonly [z.ZodObject<{
         runAt: z.ZodUnion<readonly [z.ZodDate, z.ZodString, z.ZodNumber]>;
         runIn: z.ZodOptional<z.ZodNever>;
     }, z.core.$strip>, z.ZodObject<{

package/dist/runtime.js

@@ -41,13 +41,22 @@ export const automationInvocationOutputSchema = z.object({
 });
 export const automationInvocationInputSchema = z
     .object({
-    automationName: z.string().min(1),
     entrypoint: z
         .string()
         .min(1)
         .default(AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT),
     payload: encodableSchema,
 })
+    .and(z.union([
+    z.object({
+        automationId: z.string().min(1),
+        automationName: z.never().optional(),
+    }),
+    z.object({
+        automationId: z.never().optional(),
+        automationName: z.string().min(1),
+    }),
+]))
     .and(automationInvocationScheduleSchema);
 const ACTION_INVOCATION_BASE_SCHEMA = z.object({
     actionDependencyIds: z.string().array(),
@@ -103,6 +112,7 @@ const SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA = z.object({
     slot: z.number().int().nonnegative(),
 });
 const CORRELATION_ENTRY_SCHEMA = SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA.extend({
+    continueFrom: z.string().min(1).optional(),
     key: encodableSchema,
     outcomeSeq: OUTCOME_SEQUENCE_SCHEMA,
     streamName: z.string().min(1),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/api-contract",
-  "version": "0.50.0",
+  "version": "0.50.2",
   "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.50.0",
+    "@automate.ax/codec": "0.50.2",
     "@orpc/contract": "1.15.0",
     "zod": "^4.3.6"
   },

package/src/deployment.ts

@@ -2,7 +2,42 @@ 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 AUTOMATION_SDK_VERSION = "2"
+
+export type HttpTriggerScope = "trigger" | "automation" | "project"
+
+export interface HttpTriggerEndpointOptions {
+  appOrigin: string
+  automationId: string
+  hookSlot: number
+  projectId: string
+  scope: HttpTriggerScope
+}
+
+/**
+ * Returns the public URL for one deployed HTTP trigger.
+ *
+ * @param options - Public origin and trigger identity.
+ */
+export function getHttpTriggerEndpoint(options: HttpTriggerEndpointOptions) {
+  return new URL(
+    `/x/${getHttpTriggerEndpointKey(options)}/`,
+    options.appOrigin,
+  ).toString()
+}
+
+/**
+ * Returns the durable endpoint identity for one configured HTTP scope.
+ *
+ * @param options - Trigger and owning resource identity.
+ */
+export function getHttpTriggerEndpointKey(
+  options: Omit<HttpTriggerEndpointOptions, "appOrigin">,
+) {
+  if (options.scope === "project") return options.projectId
+  if (options.scope === "automation") return options.automationId
+  return `${options.automationId}:${options.hookSlot}`
+}
 
 export const deploymentTriggerInfoSchema = z.object({
   details: z

package/src/index.ts

@@ -13,7 +13,11 @@ export { automationExecutionStatusSchema } from "./automation"
 export {
   AUTOMATION_SDK_VERSION,
   deploymentTriggerInfoSchema,
+  getHttpTriggerEndpoint,
+  getHttpTriggerEndpointKey,
   type DeploymentTriggerInfo,
+  type HttpTriggerEndpointOptions,
+  type HttpTriggerScope,
 } from "./deployment"
 export { integrationAccountOutputSchema } from "./account"
 export {

package/src/runtime.ts

@@ -50,13 +50,24 @@ export const automationInvocationOutputSchema = z.object({
 
 export const automationInvocationInputSchema = z
   .object({
-    automationName: z.string().min(1),
     entrypoint: z
       .string()
       .min(1)
       .default(AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT),
     payload: encodableSchema,
   })
+  .and(
+    z.union([
+      z.object({
+        automationId: z.string().min(1),
+        automationName: z.never().optional(),
+      }),
+      z.object({
+        automationId: z.never().optional(),
+        automationName: z.string().min(1),
+      }),
+    ]),
+  )
   .and(automationInvocationScheduleSchema)
 
 const ACTION_INVOCATION_BASE_SCHEMA = z.object({
@@ -118,6 +129,7 @@ const SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA = z.object({
 })
 
 const CORRELATION_ENTRY_SCHEMA = SIGNAL_INVOCATION_DEPENDENCIES_SCHEMA.extend({
+  continueFrom: z.string().min(1).optional(),
   key: encodableSchema,
   outcomeSeq: OUTCOME_SEQUENCE_SCHEMA,
   streamName: z.string().min(1),